建立出金訂單
向收款人支付法幣。平台按出金匯率把金額折成 USDT,加上出金手續費,從你的 USDT 餘額里扣除並凍結;出款成功後正式扣款,被拒絕時全部退回。處理完成後平台回調通知你。
POST
/api/open/order/createSellOrder完整地址 = 介面地址 + 這個路徑。介面地址在商戶後台「開發者 → API 與回調」檢視。
需要:IP 白名單、開放介面已開通、餘額足夠。出金回調地址在商戶後台設定,或本單傳 callbackUrl。
防止重複出款
每筆出款都必須傳你自己生成、已經存進資料庫的 merchantOrderNo。 平台會拒絕重複的商戶訂單號(40007)。網路超時後請用同一個商戶訂單號先查詢、再重試,不要換新號重發。
請求參數
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
merchantNo | string | 是 | 商戶號 |
merchantOrderNo | string | 是 | 你的商戶訂單號,不能和你已有的入金單、出金單重複 |
currencyType | string | 是 | 法幣程式碼,如 CNY、THB |
amount | number | 是 | 出款法幣金額,大於 0、最多兩位小數 |
bankAccountName | string | 是 | 收款人姓名(也用於黑名單檢查) |
bankAccountNumber | string | 是 | 銀行卡號;電子錢包填錢包帳號或手機號 |
bankName | string | 人民幣銀行卡必填 | 銀行名稱,如「中國工商銀行」 |
bankBranchName | string | 人民幣銀行卡必填 | 支行名稱 |
isExpedited | bool | 否 | 是否加急,加急用加急匯率,預設 false |
callbackUrl | string | 否 | 本單的回調地址,不傳用商戶後台的出金回調地址 |
paymentMethod | int | 否 | 收款方式編號,不傳預設銀行卡。各法幣可用的編號和要填的資訊用查詢收款方式查 |
bankCode | string | 看收款方式 | 銀行程式碼 / 路由號 |
swiftCode | string | 看收款方式 | SWIFT/BIC(國際電匯) |
iban | string | 看收款方式 | IBAN |
bankAddress | string | 看收款方式 | 銀行地址(國際電匯) |
beneficiaryAddress | string | 看收款方式 | 收款人地址(國際電匯) |
beneficiaryDocument | string | 看收款方式 | 收款人證件號(如巴西的 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 | 金額不對 |