3Dセキュア統合
トランザクションセキュリティを強化するための3Dセキュア認証統合の包括的ガイド。
統合手順
ステップ1: 3Dリクエストを送信
3Dセキュア認証を開始するには、サーバーからサーバーへのリクエストを3Dセキュアエンドポイントに送信します。
ステップ2: リダイレクトURLを使用
レスポンスから redirect_url
を使用して、ブラウザで3Dセキュアページを開きます。
ステップ3: 3Dセキュア認証完了後
カード保有者が認証を完了した後、発行者はリクエストを承認または拒否します。結果に基づいて、顧客は提供された success_url
または decline_url
にリダイレクトされます。
success_url
decline_url
ステップ4: Webhook通知
リダイレクトレスポンスに加えて、ゲートウェイは取引のステータスを確認するために指定した webhook_url
にWebhook通知を送信します。これにより、顧客が3DSプロセス後にウェブサイトに戻らなくても、取引結果が確実に伝達されます。
Webhookサンプルレスポンス
ステップ5: 3Dセキュア取引ステータスの取得
リクエスト属性
レスポンス属性
リクエスト属性
Authorizations
認証のためのAPIキー。形式:'Basic YOUR_API_KEY_HERE'
x-api-key専用のAPIキー。
Body
取引の金額。
"1000"
商品の処理通貨の略称(例:JPY)。
3
"JPY"
カードの詳細を含むJSONオブジェクト。
加盟店の取引参照ID。
45
"qwe"
カード所有者のIPアドレス。
45
"127.0.0.1"
加盟店ID(DASMID)。
128
"< Merchant ID >"
カード所有者の請求先住所を含むJSONオブジェクト。
返却URLを含むJSONオブジェクト。(このフィールドは3DS取引で必須です。)
カード所有者の配送先住所を含むJSONオブジェクト(オプション)。
カード所有者が使用するブラウザの詳細を含むJSONオブジェクト(オプション)。
取引の国別タイムゾーン。
128
"Asia/Kuala_Lumpur"
Response
3Dセキュア認証ページのURL。
"https://checkout-dev.paymentoptions.com/integration/3ds?_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJmMmIwMWRhZi1lMWI2LTRlMTYtOGJlOC1hN2YwNTQ1NmQyNWEiLCJpYXQiOjE3Mzc5NTI0MTIsImlzcyI6IjYwMzc4ZjcxNGEwZTg5MTZlMDQ1YjQzOCIsIk9yZ1VuaXRJZCI6IjYwMzc4ZjcxZDk2ODQzM2UyMmIxZTY5NCIsImV4cCI6MTczNzk1NDIxMn0.ytizEgQCt_hQEPn3mdJMAaKjP0L68WiGYkOzD_nHeWI&_c=400000&_a=YXNpYWJpbGw="
応答ステータスコード。
200
取引が成功したかどうかを示します。
true
3Dセキュア認証のリダイレクトURL。
"https://checkout-dev.paymentoptions.com/integration/3ds?_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJqdGkiOiJmMmIwMWRhZi1lMWI2LTRlMTYtOGJlOC1hN2YwNTQ1NmQyNWEiLCJpYXQiOjE3Mzc5NTI0MTIsImlzcyI6IjYwMzc4ZjcxNGEwZTg5MTZlMDQ1YjQzOCIsIk9yZ1VuaXRJZCI6IjYwMzc4ZjcxZDk2ODQzM2UyMmIxZTY5NCIsImV4cCI6MTczNzk1NDIxMn0.ytizEgQCt_hQEPn3mdJMAaKjP0L68WiGYkOzD_nHeWI&_c=400000&_a=YXNpYWJpbGw="