カード転送

カード転送は、顧客の主要な取引から保存された支払い方法を再利用してワンクリック購入を可能にします。この統合は、パートナーのPSP Forward APIを活用してカードの詳細をRoktのPCI準拠のエンドポイントに安全に送信し、RoktカタログブランドとしてMoRで課金を処理します。

カード転送はウェブおよびiOSでサポートされています。

シーケンス概要

1. 顧客が確認ページ内のRokt配置で「今すぐ購入」をクリックします。
2. RoktがパートナーAPIを呼び出します。 RoktはパートナーのバックエンドにAPIリクエストを送信し、顧客が購入を開始したことと保存された支払い詳細が必要であることを通知します。
3. パートナーが支払い方法を検索します。 selectShoppableAds（またはselectPlacements）呼び出しで渡された支払い参照属性を使用して、パートナーが支払い方法を検索します。
4. パートナーがカードの詳細を転送します。 パートナーはPSPのForward APIを呼び出し、顧客の生のPAN、請求先住所、および（利用可能な場合）CVVをRoktの宛先エンドポイントに転送します。
5. Roktが支払いを処理します。 RoktのPCI準拠のエンドポイントがカードの詳細を受け取り、安全な非永続的なトークンを作成し、ブランドとしてMoRで課金を処理します。
6. 確認が表示されます。 Roktが結果を返します。配置が確認状態を表示します。

必要な属性

カード転送には、Shoppable Ads呼び出しに次の属性が必要です。完全なリストについては、SDK+統合ガイドの配置属性を参照してください。

ウェブ

属性	タイプ	必須	説明
partner_payment_reference	string	はい	顧客の保存された支払い方法を検索するために使用される推測不可能な識別子。
last_4_digits	string	はい	主な取引で使用されたカードの最後の4桁。顧客に確認のために表示されます。
payment_type	string	はい	主な取引で使用された支払い方法（例：visa、mastercard、amex）。表示する支払いオプションを決定するために使用されます。

iOS

iOSでは、アンダースコアなしの小文字の属性キーを使用して同じ値を渡します：

属性	タイプ	必須	説明
partnerpaymentreference	string	はい	顧客の保存された支払い方法を検索するために使用される推測不可能な識別子。
last4digits	string	はい	主な取引で使用されたカードの最後の4桁。
paymenttype	string	はい	主な取引で使用された支払い方法（例：visa、mastercard、amex）。

iOS支払い拡張が必要

registerPaymentExtensionは、iOSでのカード転送専用の統合を含むShoppable Ads配置を起動するために必要です。カード転送が唯一のStripeバックの方法である場合、Apple Payの設定は不要です—iOS SDK+統合ガイドの付録E：Shoppable Ads支払いの設定を参照して、最小限の拡張セットアップを確認してください。

iOS SDKはカード転送をネイティブに処理します（Rokt-Widget 5.2.0+ / RoktSDKPlus 9.2+）。Roktがバックエンドから保存されたカードの詳細を要求できるようにするために、以下のパートナーPayment Sharing APIも依然として必要です。

注意： プラットフォームに配送先住所の詳細が利用できない場合（例：チケットまたはデジタル商品購入）、代わりに請求先住所の詳細を渡してください。Roktは、購入を完了する前に顧客が配送先住所を確認または編集できるUIを提供します。

Payment sharing API

パートナーは、Roktが支払い転送プロセスを開始するために呼び出せるサーバーサイドAPIエンドポイントを構築し、公開する必要があります。

Example request

POST /v1/initiate-payment-sharing
Authorization: Bearer <OAUTH_TOKEN>

{
  "customerIdentifiers": {
    "email": "john.smith@example.com"
  },
  "partnerPaymentReference": "ORDER_67890",
  "destination": "COM.ROKT.CATALOG"
}

Required fields

Field	Type	Description
partnerPaymentReference	String	SDK属性として渡される支払い参照で、ボールトされた支払い方法を検索するために使用されます。
destination	String	リクエストのタイプ。Shoppable Adsには"COM.ROKT.CATALOG"を使用します。
customerIdentifiers	Object	追加のセキュリティ検証のためのオプションの追加識別子（例：customerId）。

重要: このAPIエンドポイントをRoktの静的IPアドレスに制限してください。Roktはホワイトリストに登録するIPのリストを提供します。認証には短期間のトークンを使用するOAuth 2.0を使用してください。

Forward API setup

PSPのForward APIを設定してカードデータをRoktに転送します：

• Destination configuration: RoktのPCI準拠エンドポイントを指す新しいForward APIの宛先（設定）を作成します。本番環境では、レビューと承認のためにJSON設定ファイルをPSPに提出します。Roktは宛先URLと必要なヘッダーを提供します。
• API permissions: PSPアカウントにForward APIアクセスが有効になっていることを確認してください。本番環境での使用は資格要件があります - PSPアカウントマネージャーにお問い合わせください。

Response format

パートナーAPIからのレスポンスには、PSPのForward APIから返される完全なボディを含める必要があります：

{
  "status": 200,
  "headers": { "Content-Type": "application/json" },
  "body": {
    "body-from-psp": "..."
  },
  "request-time": 150
}