建立入金訂單(收銀台)
建立一筆入金訂單,回傳平台收銀台地址。把客戶帶到這個地址,客戶按頁面上的收款帳戶付款。到帳後平台回調通知你。
POST
/api/open/order/createBuyOrder完整地址 = 介面地址 + 這個路徑。介面地址在商戶後台「開發者 → API 與回調」檢視。
需要:IP 白名單、開放介面已開通、設定了入金回調地址(或本單傳 callbackUrl)。
請求參數
加密前的 JSON:
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
merchantNo | string | 是 | 商戶號,和請求外層的一樣 |
merchantOrderNo | string | 強烈建議 | 你的商戶訂單號,同一個商戶不能重複(40007)。不傳時平台隨機生成,你將無法用它查詢 |
amount | number | 是 | 法幣金額,大於 0、最多兩位小數 |
currencyType | string | 是 | 法幣程式碼,如 CNY、THB、VND。必須是你已開通的法幣 |
customerName | string | 是 | 付款人真實姓名。客戶必須用這個名字的帳戶付款;也用於黑名單檢查 |
customerIdCardNumber | string | 否 | 付款人證件號(用於黑名單檢查) |
customerPhoneNumber | string | 否 | 付款人電話 |
customerCountry | string | 否 | 付款人國籍 |
paymentType | int | 否 | 指定收款方式,指定後客戶只能用這種方式付款。人民幣:1 銀行卡、2 微信、3 支付寶;其他法幣用查詢收款方式回傳的編號 |
redirectUrl | string | 否 | 付款完成後收銀台跳回的地址 |
hideUsdt | bool | 否 | 收銀台是否隱藏 USDT 數量 |
callbackUrl | string | 否 | 本單的回調地址,不傳用商戶後台的入金回調地址 |
json
{
"merchantNo": "你的商戶號",
"merchantOrderNo": "A20261013001",
"amount": 100,
"currencyType": "CNY",
"customerName": "張三",
"redirectUrl": "https://shop.example.com/pay/done"
}回傳
| 欄位 | 類型 | 說明 |
|---|---|---|
url | string | 收銀台地址,把客戶帶過去 |
json
{
"code": 0,
"message": "success",
"data": { "url": "https://收銀台域名/#/step1?orderId=…&checkoutToken=…&hideUsdt=&redirectUrl=…" }
}收銀台地址裡帶有這筆訂單的訪問憑證,只發給這位客戶本人,不要公開。
常見錯誤
40004、40005、40007、40010、40011、40012、40013、40015、40016、40017、40019,見錯誤碼。
訂單狀態
| orderState | 含義 |
|---|---|
| 1 | 待付款 |
| 2 | 待釋放(客戶已付款,等交易員確認收款) |
| 6 | 已釋放(平台確認收到錢,USDT 已記入你的餘額,會回調你) |
| 3 | 成功(你已回覆回調 success) |
| 4 | 已取消 |
| 5 | 已過期(客戶沒在規定時間內付款) |
| 7 | 已衝正 |
用查詢訂單隨時可以查到當前狀態。