Skip to content

建立出金訂單 ​

向收款人支付法幣。平台按出金匯率把金額折成 USDT,加上出金手續費,從你的 USDT 餘額里扣除並凍結;出款成功後正式扣款,被拒絕時全部退回。處理完成後平台回調通知你。

POST/api/open/order/createSellOrder

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

需要:IP 白名單、開放介面已開通、餘額足夠。出金回調地址在商戶後台設定,或本單傳 callbackUrl。

防止重複出款

每筆出款都必須傳你自己生成、已經存進資料庫的 merchantOrderNo。 平台會拒絕重複的商戶訂單號(40007)。網路超時後請用同一個商戶訂單號先查詢、再重試,不要換新號重發。

請求參數 ​

參數類型必填說明
merchantNostring是商戶號
merchantOrderNostring是你的商戶訂單號,不能和你已有的入金單、出金單重複
currencyTypestring是法幣程式碼,如 CNY、THB
amountnumber是出款法幣金額,大於 0、最多兩位小數
bankAccountNamestring是收款人姓名(也用於黑名單檢查)
bankAccountNumberstring是銀行卡號;電子錢包填錢包帳號或手機號
bankNamestring人民幣銀行卡必填銀行名稱,如「中國工商銀行」
bankBranchNamestring人民幣銀行卡必填支行名稱
isExpeditedbool否是否加急,加急用加急匯率,預設 false
callbackUrlstring否本單的回調地址,不傳用商戶後台的出金回調地址
paymentMethodint否收款方式編號,不傳預設銀行卡。各法幣可用的編號和要填的資訊用查詢收款方式查
bankCodestring看收款方式銀行程式碼 / 路由號
swiftCodestring看收款方式SWIFT/BIC(國際電匯)
ibanstring看收款方式IBAN
bankAddressstring看收款方式銀行地址(國際電匯)
beneficiaryAddressstring看收款方式收款人地址(國際電匯)
beneficiaryDocumentstring看收款方式收款人證件號(如巴西的 CPF / CNPJ)

人民幣銀行卡出款只要前面幾項;其他法幣或指定了 paymentMethod 時,平台按該收款方式的欄位要求校驗,不符合回傳 40018。

json
{
  "merchantNo": "你的商戶號",
  "merchantOrderNo": "PO20261013001",
  "currencyType": "CNY",
  "amount": 1000,
  "bankAccountName": "張三",
  "bankAccountNumber": "6222000000000000",
  "bankName": "中國工商銀行",
  "bankBranchName": "北京海淀支行"
}

回傳 ​

成功時沒有 data,之後用 merchantOrderNo 查詢訂單:

json
{ "code": 0, "message": "success" }

出金訂單狀態 ​

orderState含義
1待分配
2待付款(交易員處理中)
3待重新分配
4處理成功(會回調)
5拒絕(USDT 已退回,會回調)
6帳戶異常

常見錯誤 ​

code說明
400餘額不足(Insufficient balance)
40007商戶訂單號重複
40010 / 40017法幣不支援 / 沒開通
40015收款人在黑名單
40016收款方式不支援
40018收款資訊不符合要求
40019金額不對