建立入金訂單(自建收銀台)
適合自己做付款頁面的商戶。下單後平台直接回傳分配到的收款帳戶,由你展示給客戶。之後:
到帳後平台照常回調。
POST
/api/open/order/createBuyOrder2完整地址 = 介面地址 + 這個路徑。介面地址在商戶後台「開發者 → API 與回調」檢視。
請求參數
和建立入金訂單(收銀台)完全一樣(redirectUrl、hideUsdt 用不到)。
paymentType 傳 101 / 102 / 103 時建的是加密貨幣充值訂單,回傳欄位和建立加密貨幣充值訂單一樣(payAddress、payAmount 等),不分配收款帳戶,也不用調標記已付款:鏈上到帳後平台自動處理。
回傳
| 欄位 | 類型 | 說明 |
|---|---|---|
order.orderNo | string | 平台訂單號 |
order.merchantOrderNo | string | 你的商戶訂單號 |
order.totalAmount | number | 法幣金額 |
order.usdt | number | 摺合 USDT 數量(扣手續費前) |
order.currency | string | 法幣程式碼 |
order.orderTime | string | 下單時間 |
cards[] | array | 分配給這筆訂單的收款帳戶,客戶付款到其中一個。可能有多個,而且可能屬於不同的收款人,見展示收款帳戶 |
cards[].cardId | int | 收款帳戶編號,標記已付款時要傳 |
cards[].paymentType | int | 收款方式編號 |
cards[].realName | string | 這個帳戶的收款人姓名(每個帳戶各自的,不一定相同) |
cards[].bankName | string | 銀行名稱 |
cards[].bankBranch | string | 支行 |
cards[].cardNo | string | 銀行卡號 |
cards[].payAccount | string | 收款帳號:支付寶、微信帳號,以及 MoMo、TrueMoney、PIX 等電子錢包帳號(這類方式卡號為空) |
cards[].payQrCode | string | 收款碼圖片地址或付款連結(部分收款方式才有,可能為空;為空時請展示 realName + payAccount 讓客戶按帳號轉帳) |
json
{
"code": 0,
"message": "success",
"data": {
"order": {
"orderTime": "2026-10-13 12:00:00",
"orderNo": "PI1845290017342758912",
"totalAmount": 100,
"usdt": 13.7,
"merchantOrderNo": "A20261013001",
"currency": "CNY"
},
"cards": [
{ "cardId": 1024, "paymentType": 1, "payQrCode": "", "payAccount": "", "realName": "李四", "bankName": "中國工商銀行", "bankBranch": "北京海淀支行", "cardNo": "6222000000000000" },
{ "cardId": 2048, "paymentType": 3, "payQrCode": "", "payAccount": "wangwu@example.com", "realName": "王五", "bankName": "", "bankBranch": "", "cardNo": "" }
]
}
}WARNING
收款帳戶資訊只展示給這筆訂單的客戶本人。請提醒客戶用下單時的 customerName 本人帳戶付款、金額要和訂單完全一致。
展示收款帳戶
沒有傳 paymentType 時,平台會盡量把這個金額能用的收款方式都給出來(例如銀行卡、支付寶、微信),這些帳戶可能屬於不同的收款人。請這樣展示:
cards裡有幾個就展示幾個,每個帳戶按它自己的realName顯示收款人,不要把第一個帳戶的收款人當成整筆訂單的收款人;- 同一種收款方式(同一個
paymentType)也可能有不止一個帳戶,請全部展示或讓客戶選一個; - 每筆訂單的收款帳戶都可能不同,不要快取或重複使用之前訂單的帳戶;
- 客戶付款後呼叫標記已付款,
cardId傳客戶實際轉帳到的那個帳戶。
傳了 paymentType 的訂單只回傳這一種方式的帳戶。
不同收款人的匯率可能略有不同,實際到帳的 USDT 可能和下單回傳的 usdt 有小幅差異,以回調和查詢訂單為準。
常見錯誤
除了收銀台下單的錯誤外,收款通道請求失敗時回傳 400。