有効性確認

POST 
/credit/verifyCard

カード情報の有効性確認をするためのAPIです。
加えて有効性の確認が取れたカード情報を会員に紐づけて登録できます。
利用可能な決済手段はクレジットカード、Google Payであり、Apple Payは利用できません。
Google Payは通常のクレジットカードとして会員に紐づけて登録します。

Request

Responses

201

• 3Dセキュアを利用せず、有効性確認が成功した場合
• 仕向先カード会社が3Dセキュア認証に未対応のために、認証スキップした場合

202

3Dセキュアを利用して認証処理に進む場合のレスポンス
リクエストパラメーターで自動オーソリが有効になっている場合、3Dセキュア認証後にオーソリをします。

400

パラメーターの誤りなどの理由により有効性確認リクエストを進められない場合のレスポンス
エラーの原因は、detailフィールドで確認できます。

402

オーソリ(信用照会)に進んだ後に、カード会社等の外部事業者から拒否された場合のレスポンス
詳細な理由はdetailフィールドで確認できます。

409

二重リクエストによるエラーが発生した場合のレスポンス

500

当サービスのシステムで予期せぬエラーが発生した場合のレスポンス

502

カード会社等の外部事業者からシステムエラーが返る場合のレスポンス

Callbacks

GET callbackTds2Verification

GET 
REQUEST BODYのmerchant.callbackUrlに設定した加盟店様のコールバックURL

3Dセキュア、および有効性確認の処理が終わると、有効性確認リクエストパラメーターのmerchant.callbackUrlにコールバックします。
加盟店様にて元の取引を特定し、取引照会API(/order/inquiry)を呼び出して結果を確認してください。
自動オーソリなし(tds2Information.tds2Options.autoAuthorizationがfalse)の場合は、3Dセキュア後の有効性確認API(finalizeVerification)を呼び出します。

Request

Callbacks Responses

2xx

加盟店様にて処理をした結果をお客様のブラウザに表示します。

4xx

加盟店様にてエラー結果をお客様のブラウザに表示します。