トークンAPIの生成
カードトークン生成APIは、購入または認証プロセス中に敏感なカード情報をトークン化し、実際のカード詳細を公開せずに安全な取引を可能にします。
重要なポイント
-
カードをトークン化することで、カード詳細を再入力することなく繰り返し取引を行うことができ、セキュリティとユーザー体験の向上が図れます。
-
生成されたトークンは、購入と認証の両方の取引で使用でき、さまざまな支払いタイプに対応する柔軟性を提供します。
-
重要なパラメータには通常、カード番号、有効期限、CVV、顧客情報が含まれます。
フローダイアグラム
ノート
store_payment_method
: 将来の使用のためにカードトークンを保存するには、ペイロードで true
に設定する必要があります。
store_payment_method
を true
に設定することで、カード詳細を再入力することなく、カードトークンが今後の取引のために保存されます。
stored_payment_method_id
は、カード詳細を再入力することなく、今後の取引でカードトークンAPIを使用するために利用できます。
APIパラメータ
Authorizations
認証のためのAPIキー。フォーマット: 'Basic YOUR_API_KEY_HERE'
x-api-key専用のAPIキー。
Body
取引の金額。
"1000"
処理通貨の略語(例: JPY)。
3
"JPY"
カードの詳細を含むJSONオブジェクト。
決済方法を含むJSONオブジェクト。
加盟店ID(DASMID)。
128
"< Merchant ID >"
カード所有者の請求先住所を含むJSONオブジェクト。
加盟店取引参照ID。
45
"qwe"
カード所有者のIPアドレス。
45
"127.0.0.1"
リターンURLを含むJSONオブジェクト。(このフィールドは3DS取引に必須)。
カード所有者の配送先住所を含むJSONオブジェクト(オプション)。
取引の国のタイムゾーン。
128
"Asia/Kuala_Lumpur"
Response
取引が成功した場合はtrue、失敗した場合はfalse。
true
取引のステータスコード。
201
本番環境の取引の場合はtrue、テスト取引の場合はfalse。
false
取引の種類(例:CAPTURE)。
"CAPTURE"
ゲートウェイからのレスポンスを含むJSONオブジェクト。
加盟店の詳細情報を含むJSONオブジェクト。
支払いの詳細情報を含むJSONオブジェクト。
取引の詳細を含むJSONオブジェクト。
リスクの詳細を含むJSONオブジェクト。