トークン使用API
カードトークンは、敏感なカード詳細を再入力することなく、購入または認証取引を安全に完了するために使用されます。このトークン化アプローチは、セキュリティとユーザー体験を向上させます。
重要なポイント
-
一度カードトークンが生成されると、それを使用して購入または認証取引を実行できます。
-
カードトークンは実際のカード詳細の必要性を置き換え、取引中に敏感なデータが決して公開されないことを保証します。
-
この方法は通常、次の目的で使用されます: ワンクリック決済、 定期的な取引(例:サブスクリプション)、 保存された顧客の支払い詳細。
フローダイアグラム
APIパラメータ
カードトークン
stored_payment_method_id
(トークン作成時に生成される)をペイロードに使用して取引を完了します。
stored_payment_method_id
はカードトークン化プロセスから生成されたトークンであり、今後の取引を安全に完了させるために使用されます。
Authorizations
認証のためのAPIキー。フォーマット: 'Basic YOUR_API_KEY_HERE'
x-api-key専用のAPIキー。
Body
取引の金額。
"1000"
処理通貨の略称(例:JPY)。
3
"JPY"
決済方法を含む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オブジェクト。