重要なポイント
- 認証APIは、顧客の支払い方法で指定された金額を確保しますが、キャプチャが行われるまで資金は転送されません。
- キャプチャ: 顧客のアカウントから認証された資金を転送して取引を完了します。
- 無効: 認証をキャンセルし、保留された資金を顧客に返金します。
- このAPIの使用例には、最終的な金額が変動する可能性のある状況(ホテルの予約、車のレンタル、事前注文など)が含まれます。
フローダイアグラム
APIパラメータ
Authorizations
認証のためのAPIキー。形式:'Basic YOUR_API_KEY_HERE'
x-api-key専用のAPIキー。
Body
application/json
支払い取引を承認するためのリクエストペイロード。
取引の金額。
Example:
"1000"
商品の処理通貨の略称(例:JPY)。
Maximum length:
3
Example:
"JPY"
カードの詳細を含むJSONオブジェクト。
加盟店ID(DASMID)。
Maximum length:
128
Example:
"< Merchant ID >"
カード所有者の請求先住所を含むJSONオブジェクト。
加盟店の取引参照ID。
Maximum length:
45
Example:
"qwe"
カード所有者のIPアドレス。
Maximum length:
45
Example:
"127.0.0.1"
返却URLを含むJSONオブジェクト。(このフィールドは3DS取引で必須です。)
カード所有者の配送先住所を含むJSONオブジェクト(オプション)。
カード所有者が使用するブラウザの詳細を含むJSONオブジェクト(オプション)。
取引の国別タイムゾーン。
Maximum length:
128
Example:
"Asia/Kuala_Lumpur"
Response
201 - application/json
支払いが正常に承認されました
取引が成功した場合はtrue、失敗した場合はfalse。
Example:
true
取引のステータスコード。
Example:
201
本番取引の場合はtrue、テスト取引の場合はfalse。
Example:
false
取引タイプ(例:PRE_AUTH)。
Example:
"PRE_AUTH"
ゲートウェイからの応答を含むJSONオブジェクト。
加盟店の詳細を含むJSONオブジェクト。
支払いの詳細を含むJSONオブジェクト。
取引の詳細を含むJSONオブジェクト。
リスクの詳細を含むJSONオブジェクト。