建立入金訂單(自建收銀台)
適合自己做付款頁面的商戶。下單後平台直接回傳分配到的收款帳戶,由你展示給客戶。之後:
到帳後平台照常回調。
POST
/api/open/order/createBuyOrder2完整地址 = 介面地址 + 這個路徑。介面地址在商戶後台「開發者 → API 與回調」檢視。
請求參數
和建立入金訂單(收銀台)完全一樣(redirectUrl、hideUsdt 用不到)。
回傳
| 欄位 | 類型 | 說明 |
|---|---|---|
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" }
]
}
}WARNING
收款帳戶資訊只展示給這筆訂單的客戶本人。請提醒客戶用下單時的 customerName 本人帳戶付款、金額要和訂單完全一致。
常見錯誤
除了收銀台下單的錯誤外,收款通道請求失敗時回傳 400。