Newer Version Available
トークン化サービス API
典型的なトークン化プロセスでは、支払プラットフォームが顧客の支払方法データを受け入れ、Salesforce の外部にある支払ゲートウェイのリモートトークンサービスサーバーに渡します。サーバーはプラットフォームのストレージ用にトークン化された値を提供します。たとえば、顧客がクレジットカード番号を 4111 1111 1111 1234 と入力したとします。トークンサーバーはこの値を保存し、2537446225198291 というトークンに関連付けて、プラットフォームのストレージ用にそのトークンを送信します。
マーチャントとの通信中、マーチャントは 2537446225198291 トークンをトークンサーバーに送信します。トークンサーバーは、顧客のトークンと一致していることを確認し、顧客のカードに対してマーチャントがトランザクションを実行することを承認します。
商取引の支払トークン化 API は、クレジットカード情報を受け入れ、顧客の Salesforce 組織を通じて設定された外部支払ゲートウェイを使用してカード情報をトークン化します。その後、トークン化表現を返します。その後、API はトークンを CardPaymentMethod に保存します。
承認取消サービスをコールするには、次のエンドポイントに POST 要求を実行します。
エンドポイント
トークン化サービスは、支払および関連エンティティから次の要求パラメーターを受け付けます。
| パラメーター | 必須 | 詳細 |
|---|---|---|
|
|
必須 | トークン化するクレジットカードの詳細。 |
| accountId | 省略可能 | カード所有者の Salesforce 取引先 ID。 |
|
|
省略可能 | トークン化されるクレジットカード支払方法を設定している顧客の住所情報。 |
| paymentGatewayId | 必須 | トークン化サーバーに関連する外部支払ゲートウェイ。 |
| 省略可能 | 不正パラメーター。 | |
| ipAddress | 省略可能 | 不正パラメーター。 |
| macAddress | 省略可能 | 不正パラメーター。 |
| phone | 省略可能 | 不正パラメーター。 |
| additionalData | 省略可能 | クレジットカードの支払方法をトークン化するためにゲートウェイが必要とする追加データ。 |
要求と応答のサンプル
このサンプル要求では、トークン化用に顧客のクレジットカード情報が提供されます。
成功応答のサンプル
トークン化応答が成功すると、支払方法が更新され、ゲートウェイ応答と支払ゲートウェイログに関する情報が提供されます。