Skip to main content
POST
取引をキャプチャする

重要なポイント

  • キャプチャAPIは、顧客のアカウントから加盟店のアカウントに認可された資金を移動させることにより、決済プロセスを完了させます。
  • このAPIは通常、認証後に最終金額が確認された後(商品発送後やサービス提供後など)に使用されます。
  • 以前に認可された金額のみがキャプチャできます。キャプチャ金額が少ない場合、残りの資金は返金されます。

フローダイアグラム

フローダイアグラム画像

APIパラメータ

承認

Authorization
string
header
必須

認証のためのAPIキー。形式:'Basic YOUR_API_KEY_HERE'

x-api-key
string
header
必須

x-api-key専用のAPIキー。

ボディ

application/json

取引をキャプチャするためのリクエストペイロード。

transactionId
string
必須

承認された取引の元の取引ID。

Maximum string length: 36
:

"e0b0731e-7170-4b64-8a21-7d835eebd641"

amount
integer
必須

キャプチャする金額。これは承認された金額を超えてはなりません。金額の制限は銀行によって異なります。

:

1000

merchant_id
string
必須

加盟店ID(DASMID)。

Maximum string length: 10
:

"< Merchant ID >"

notes
string

キャプチャ取引の参照(オプション)。

Maximum string length: 128
:

"Capturing authorised amount"

レスポンス

201 - application/json

取引が正常にキャプチャされました。

success
boolean

取引が成功した場合はtrue、失敗した場合はfalse。

:

true

status_code
integer

取引のステータスコード。

:

201

is_live
boolean

本番取引の場合はtrue、テスト取引の場合はfalse。

:

false

transaction_type
string

取引タイプ(例:CAPTURE)。

:

"CAPTURE"

gateway_response
object

ゲートウェイからの応答を含むJSONオブジェクト。

merchant_details
object

加盟店の詳細を含むJSONオブジェクト。

payment_details
object

取引の支払い詳細を含むJSONオブジェクト。

transaction_details
object

取引の詳細を含むJSONオブジェクト。