Webhook

Webhook是一種支付資訊的回饋方式。
當付款狀態變更時，會向建立付款時指定的 url_callback 發送 POST 請求。

回覆

響應參數

姓名	參數類型	定義
type	string	類型。僅可用付款
uuid	string	付款的 uuid
order_id	string\|null	您系統中的訂單 ID（用於識別付款）
amount	string	賠償金額
merchant_amount	string\|null	從商家餘額中扣除的金額，包括所有佣金。
commission	string\|null	Cryptomus 佣金金額
is_final	boolean	付款是否完成如果付款不是最終的並且失敗了，仍然可以透過支援重新發送。當付款最終確定時，要么付款，要么付款失敗。
status	string	付款狀態看
fail_reason	string\|null	1. AML - 付款被拒絕的原因：收款人未通過 AML 驗證。2. system_error - 拒絕原因：伺服器錯誤。3. address_error - 拒絕原因：收件者地址無效。
txid	string\|null	區塊鏈上的交易哈希。如果出現以下情況，txid 欄位將不存在1）款項透過 p2p 支付至 Cryptomus 地址2）支付失敗。
currency	string	發票幣種
network	string\|null	進行支付的區塊鏈網絡
payer_currency	string\|null	實際支付的加密貨幣代碼。支付地址將接收支付貨幣。
payer_amount	string\|null	付款金額（以 payer_currency 為單位）。
sign	string	用於驗證 webhook 來自 Cryptomus 的簽名

: 參數類型
string
定義
類型。僅可用付款
: 參數類型
string
定義
付款的 uuid
: 參數類型
string|null
定義
您系統中的訂單 ID（用於識別付款）
: 參數類型
string
定義
賠償金額
: 參數類型
string|null
定義
從商家餘額中扣除的金額，包括所有佣金。
: 參數類型
string|null
定義
Cryptomus 佣金金額
: 參數類型
boolean
定義
付款是否完成如果付款不是最終的並且失敗了，仍然可以透過支援重新發送。當付款最終確定時，要么付款，要么付款失敗。
: 參數類型
string
定義
付款狀態看
: 參數類型
string|null
定義
1. AML - 付款被拒絕的原因：收款人未通過 AML 驗證。2. system_error - 拒絕原因：伺服器錯誤。3. address_error - 拒絕原因：收件者地址無效。
: 參數類型
string|null
定義
區塊鏈上的交易哈希。如果出現以下情況，txid 欄位將不存在1）款項透過 p2p 支付至 Cryptomus 地址2）支付失敗。
: 參數類型
string
定義
發票幣種
: 參數類型
string|null
定義
進行支付的區塊鏈網絡
: 參數類型
string|null
定義
實際支付的加密貨幣代碼。支付地址將接收支付貨幣。
: 參數類型
string|null
定義
付款金額（以 payer_currency 為單位）。
: 參數類型
string
定義
用於驗證 webhook 來自 Cryptomus 的簽名

回應範例


1{
2    "type": "payout",
3    "uuid": "2b852d86-3cf1-43fb-b1bb-36f0b7d12151",
4    "order_id": "129359",
5    "amount": "207.00000000",
6    "merchant_amount": "207.30000000", 
7    "commission": "0.30000000",
8    "is_final": true,
9    "status": "fail",
10    "fail_reason": "AML",                 
11    "txid": null,                           
12    "currency": "USDT",
13    "network": "bsc",
14    "payer_currency": "USDT",
15    "payer_amount": "207.00000000",
16    "sign": "eff3afba8600af59c98b74155934da2d"
17}

複製

Webhook 驗證

看