Skip to content

建立入金訂單(收銀台) ​

建立一筆入金訂單,回傳平台收銀台地址。把客戶帶到這個地址,客戶按頁面上的收款帳戶付款。到帳後平台回調通知你。

POST/api/open/order/createBuyOrder

完整地址 = 介面地址 + 這個路徑。介面地址在商戶後台「開發者 → API 與回調」檢視。

需要:IP 白名單、開放介面已開通、設定了入金回調地址(或本單傳 callbackUrl)。

請求參數 ​

加密前的 JSON:

參數類型必填說明
merchantNostring是商戶號,和請求外層的一樣
merchantOrderNostring強烈建議你的商戶訂單號,同一個商戶不能重複(40007)。不傳時平台隨機生成,你將無法用它查詢
amountnumber是法幣金額,大於 0、最多兩位小數
currencyTypestring是法幣程式碼,如 CNY、THB、VND。必須是你已開通的法幣
customerNamestring是付款人真實姓名。客戶必須用這個名字的帳戶付款;也用於黑名單檢查
customerIdCardNumberstring否付款人證件號(用於黑名單檢查)
customerPhoneNumberstring否付款人電話
customerCountrystring否付款人國籍
paymentTypeint否指定收款方式,指定後客戶只能用這種方式付款。人民幣:1 銀行卡、2 微信、3 支付寶;其他法幣用查詢收款方式回傳的編號
redirectUrlstring否付款完成後收銀台跳回的地址
hideUsdtbool否收銀台是否隱藏 USDT 數量
callbackUrlstring否本單的回調地址,不傳用商戶後台的入金回調地址
json
{
  "merchantNo": "你的商戶號",
  "merchantOrderNo": "A20261013001",
  "amount": 100,
  "currencyType": "CNY",
  "customerName": "張三",
  "redirectUrl": "https://shop.example.com/pay/done"
}

回傳 ​

欄位類型說明
urlstring收銀台地址,把客戶帶過去
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已衝正

用查詢訂單隨時可以查到當前狀態。