商户卖币接口文档 v1.0
业务接口
POST /api/sell-coin/transaction
描述：商户卖币接口
传入参数列表
参数名称
必填项
参数类型
参数描述
sellCoinMode
Enum
USDD数量模式（UsddAmount）或收取金额模式（PaymentPrice）。默认为 UsddAmount 模式。 关于两种模式的区别，请看卖币模式说明。
usddAmount
Decimal
【USDD数量模式必传】币的数量。
totalPrice
Decimal
【收取金额模式必传】总收取金额。
externalOrderNumber
String
外部订单号
callbackUrl
String
卖币成功后回调地址。
supportLanguage
Enum
展示语言：en, zh_CN, zh_TW, vi, id。
currencyCode
Enum
收取币种：CNY, HKD, TWD, VND, AUD。
payeeRealName
String
实际收款人姓名
bankAccount
String
银行账号
bankName
String
银行名称
bankBranch
String
支行名称
卖币模式说明
-
UsddAmount - 数量模式
默认模式当选择此模式时，需要传入 usddAmount 字段，此时会通过所购币种的数量，筛选最优广告并生成订单。
-
PaymentPrice - 支付金额模式
当选择此模式时，需要传入 totalPrice 字段，此时会通过支付币种与总金额数量，筛选最优广告并生成订单。
传出参数列表
参数名称
参数类型
参数描述
redirectUrl
String
所需跳转的支付 URI。
advertisementCode
String
此次交易所匹配的广告编码。
currentTimestamp
Long
当前 UTC 时间戳。
当此次卖币操作完成后，系统将自动回调 callbackUrl 的接口，方式为 POST，并传入此 JSON 数据：
{
"success": true,
"statusCode": "SUCCESS",
"message": "",
"signature": "鉴权签名", // 需要通过鉴权算法进行校验
"timestamp": 1679533328342, // UTC 毫秒级时间戳
"data": {
"externalOrderNumber": "ORDER_CODE", // 外部订单号
"transactionCode": "TASA6E40D5FE7UZHE", // 订单编码
"transactionAmount": 200.00, // 交易USDD数量
"currencyCode": "CNY", // 收取币种
"paymentPrice": 1000.00, // 收取金额
"transactionCreateTime": "2023-03-01 00:00:00", // UTC 交易创建时间
"paymentFinishedTime": "2023-03-01 02:00:00" // UTC 支付完成时间
}
}
当此次卖币操作失败后，系统将自动回调 callbackUrl 的接口，方式为 POST，并传入此 JSON 数据：
{
"success": false,
"statusCode": "TRADE_CANCELED",
"message": "取消交易",
"signature": "鉴权签名", // 需要通过鉴权算法进行校验
"timestamp": 1679533328342, // UTC 毫秒级时间戳
"data": {
"externalOrderNumber": "ORDER_CODE", // 外部订单号
"transactionCode": "TASA6E40D5FE7UZHE", // 订单编码
"transactionAmount": 200.00, // 交易USDD数量
"currencyCode": "CNY", // 支付币种
"paymentPrice": 1000.00, // 支付金额
"transactionCreateTime": "2023-03-01 00:00:00", // UTC 交易创建时间
}
}
接口需要响应：
"success" 或 {"success":true}
若响应其他内容，则默认响应失败，会自动进入重试逻辑；若所有重试均失败，则此次回调会标记为“回调失败”。
重试时间间隔如下表：
00:01:00
00:02:00
00:03:00
00:08:00
00:38:00
01:08:00
02:08:00
03:08:00
04:08:00
05:08:00
06:08:00
07:08:00
08:08:00
09:08:00
10:08:00
11:08:00