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金额不对