トークン使用API
カードトークンは、敏感なカード詳細を再入力することなく、購入または認証取引を安全に完了するために使用されます。このトークン化アプローチは、セキュリティとユーザー体験を向上させます。
重要なポイント
- 一度カードトークンが生成されると、それを使用して購入または認証取引を実行できます。
- カードトークンは実際のカード詳細の必要性を置き換え、取引中に敏感なデータが決して公開されないことを保証します。
- この方法は通常、次の目的で使用されます: ワンクリック決済、 定期的な取引(例:サブスクリプション)、 保存された顧客の支払い詳細。
フローダイアグラム
APIパラメータ
カードトークン
stored_payment_method_id(トークン作成時に生成される)をペイロードに使用して取引を完了します。
stored_payment_method_id はカードトークン化プロセスから生成されたトークンであり、今後の取引を安全に完了させるために使用されます。承認
認証のためのAPIキー。フォーマット: 'Basic YOUR_API_KEY_HERE'
x-api-key専用のAPIキー。
ボディ
決済トランザクションを処理するためのリクエストペイロード。
取引の金額。
"1000"
処理通貨の略称(例:JPY)。
3"JPY"
決済方法を含むJSONオブジェクト。
加盟店ID(DASMID)。
128"< Merchant ID >"
加盟店の取引参照ID。
45"qwe"
カード所有者のIPアドレス。
45"127.0.0.1"
リターンURLを含むJSONオブジェクト。(このフィールドは3DSトランザクションに必須です。)
カード所有者の請求先住所を含むJSONオブジェクト。
カード所有者の配送先住所を含むJSONオブジェクト(オプション)。
取引の国タイムゾーン。
128"Asia/Kuala_Lumpur"
レスポンス
支払いが正常に処理されました。
取引が成功した場合は「true」、失敗した場合は「false」。
true
取引のステータスコード。
201
本番取引の場合は「true」、テスト取引の場合は「false」。
false
取引タイプ(例:CAPTURE)。
"CAPTURE"
ゲートウェイからのレスポンスを含むJSONオブジェクト。
加盟店の詳細を含むJSONオブジェクト。
支払い詳細を含むJSONオブジェクト。
取引の詳細を含むJSONオブジェクト。
リスクの詳細を含むJSONオブジェクト。