异步通知
回调说明
接口描述
当用户在买币/卖币时,我们会根据用户买卖币的结果给商家推送订单信息。
重发机制默认通知只发送一次。如果有需要可以联系我们配置通知重发,重发时间间隔:5分钟,15分钟,30分钟,1小时,2小时,4小时,8小时
。当我们收到http 200并且success响应信息后,停止重发。重发目前仅支持onramp。
建议通知和订单查询接口结合使用订单查询接口
接口说明
请求方式:POST
请求地址:商户下单时上传的 callbackUrl
Header参数
参数名 | 类型 | 说明 |
---|---|---|
timestamp | string | 时间戳(验签用到)参考这里 |
买币回调
Body参数列表
参数名 | 类型 | 说明 |
---|---|---|
appId | string | 商户应用的唯一标识 |
orderNo | string | 系统订单号 |
string | 用户的邮箱 | |
crypto | string | 用户购买的数字货币币种 |
cryptoPrice | string | 用户购买的数字货币价格 |
cryptoQuantity | string | 用户购买的数字货币数量 |
payType | string | 用户购买的支付方式 |
fiat | string | 用户法币币种 |
amount | string | 用户支付的法币金额 |
payTime | string | 用户实际支付时间 |
network | string | 用户购买的数字货币网络 |
address | string | 用户提币的地址 |
txTime | string | 用户到账时间 |
txHash | string | 提现哈希 |
status | string | 订单状态:PAY_FAIL、PAY_SUCCESS、FINISHED 订单状态列表 |
message | string | 返回信息 |
merchantOrderNo | string | 商户订单号 |
networkFee | string | 网络费 |
rampFee | string | 服务费 |
newSignature | string | 签名,签名方式可参考这里 |
注意:
- INR本地支付,法币支付完成这一步没有回调。
- 支付失败通知会增加 returnCode(失败错误码)、returnMsg(失败原因)2 个字段,无 message 参数
以下参数默认不会发送,开启商户返佣功能才会发送。
参数名 | 类型 | 说明 |
---|---|---|
createTime | string | 订单创建时间,格式YYYY-MM-DD, HH:MM:SS,如2021-11-25 10:00:00 |
rampFeeUnit | string | Ramp fee的单位,如USD, ETH |
tokenAddress | string | 买币时返回token的合约地址;如果是主链币没有合约地址,为空 |
alpha2 | string | ISO 3166-1 二位字母国家code,如us/jp等 |
回调示例
{
"amount": "112.00000000",
"orderNo": "10000000000000006",
"address": "0xdc8123456780b8c55be419675c2eec5",
"payTime": null,
"txTime": "",
"networkFee": "",
"message": "",
"merchantOrderNo": "",
"crypto": "USDC",
"network": "MATIC",
"cryptoPrice": "",
"payType": "CREDIT_CARD",
"rampFee": "",
"cryptoQuantity": "123",
"appId": "jcudotl1hwyvxhdp",
"fiat": "EUR",
"txHash": "",
"email": "[email protected]",
"signature":"ffaa29ee7f75cb52598fe460295caafa3ebcb549",
"status": "PAY_SUCCESS"
}
卖币回调
Body参数列表
参数名 | 类型 | 说明 |
---|---|---|
orderNo | string | ACH订单号 |
address | string | 订单收币地址 |
payTime | string | ACH给用户转账的时间 |
completeTime | string | 订单收到数字货币确认的时间 |
merchantOrderNo | string | 商户订单号 |
crypto | string | 卖币的数字货币 |
network | string | 卖币的数字货币对应的网络 |
cryptoPrice | string | 数字货币对应fiat的价格 |
cryptoAmount | string | 订单上的数字货币数量 |
fiatAmount | string | 用户到账的法币金额,包含手续费 |
appId | string | appID |
fiat | string | 法币币种 |
txHash | string | 用户转账的hash |
string | 用户邮箱 | |
newSignature | string | 签名,签名方式可参考这里 |
status | string | 订单状态 订单状态列表 |
orderAddress | string | 订单页面url |
cryptoacturalAmount | string | 订单实际收到的数量 |
rampfee | string | 订单的手续费,币种与法币币种相同 |
receiptTime | string | 法币到账的时间 |
paymentType | string | card为提现到卡,account为提现到账户 |
name | string | 卡或者账户姓名 |
card | string | 卡信息展示前6后4,121321**1231 |
account | string | 账户信息,展示后四位,****1231 |
failReason | string | 失败原因 |
注意:不同状态可能有的值和字段为空
回调示例
{
"orderNo": "1029386554223382528", /ACH订单号
"address": "TGNMkik3nPaioVJdkE7qEixWr9cUvsyT5g",/订单收币地址
"payTime": "2022-10-11 21:39:55",/ACH给用户转账的时间
"completeTime": "2022-10-11 21:39:53", /订单收到数字货币确认的时间
"merchantOrderNo": "null",/商户订单号
"crypto": "USDT",/卖币的数字货币
"network": "TRX",/卖币的数字货币对应的网络
"cryptoPrice": "1.0000000000",/数字货币对应fiat的价格
"cryptoAmount": "60.0000000000",/订单上的数字货币数量
"fiatAmount": "86.7100000000",/用户到账的法币金额,包含手续费
"appId": "ahzxh0klegv1fzol",/appID
"fiat": "SGD",/法币币种
"txHash": "2bde306489a58f89d6ac1c8b2296b2cdf9866bdcd8b45acaea361477bb04e398",用户转账的hash
"email": "[email protected]",/用户邮箱
"signature":"ffaa29ee7f75cb52598fe460295caafa3ebcb549",/签名
"status": "1" ,/订单状态
"orderAddress": "xxxx" ,/订单页面url
"cryptoacturalAmount": "60.0000000000",/订单实际收到的数量
"rampfee": "",/订单的手续费,币种与法币币种相同
"receiptTime": "2022-10-11 21:39:53", /法币到账的时间
"paymentType": "xxxx" , card为提现到卡,account为提现到账户
"name": "xxxx" ,卡或者账户姓名
"card": "xxxx" ,卡信息展示前6后4,121321******1231
"account": "xxxx" ,账户信息,展示后四位,****1231
"failReason": "xxxx" ,失败原因
}
Updated about 1 month ago