创建出金订单
向收款人支付法币。平台按出金汇率把金额折成 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 | 金额不对 |