异步通知

回调说明

接口描述

当用户在买币/卖币时,我们会根据用户买卖币的结果给商家推送订单信息。

重发机制默认通知只发送一次。如果有需要可以联系我们配置通知重发,重发时间间隔:5分钟,15分钟,30分钟,1小时,2小时,4小时,8小时。当我们收到http 200并且success响应信息后,停止重发。重发目前仅支持onramp。

📘

建议通知和订单查询接口结合使用订单查询接口

接口说明

请求方式:POST

请求地址:商户下单时上传的 callbackUrl

Header参数

参数名类型说明
timestampstring时间戳(验签用到)参考这里

买币回调

Body参数列表

参数名类型说明
appIdstring商户应用的唯一标识
orderNostring系统订单号
emailstring用户的邮箱
cryptostring用户购买的数字货币币种
cryptoPricestring用户购买的数字货币价格
cryptoQuantitystring用户购买的数字货币数量
payTypestring用户购买的支付方式
fiatstring用户法币币种
amountstring用户支付的法币金额
payTimestring用户实际支付时间
networkstring用户购买的数字货币网络
addressstring用户提币的地址
txTimestring用户到账时间
txHashstring提现哈希
statusstring订单状态:PAY_FAIL、PAY_SUCCESS、FINISHED 订单状态列表
messagestring返回信息
merchantOrderNostring商户订单号
networkFeestring网络费
rampFeestring服务费
newSignaturestring签名,签名方式可参考这里

📘

注意:

  1. INR本地支付,法币支付完成这一步没有回调。
  2. 支付失败通知会增加 returnCode(失败错误码)、returnMsg(失败原因)2 个字段,无 message 参数

以下参数默认不会发送,开启商户返佣功能才会发送。

参数名类型说明
createTimestring订单创建时间,格式YYYY-MM-DD, HH:MM:SS,如2021-11-25 10:00:00
rampFeeUnitstringRamp fee的单位,如USD, ETH
tokenAddressstring买币时返回token的合约地址;如果是主链币没有合约地址,为空
alpha2stringISO 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参数列表

参数名类型说明
orderNostringACH订单号
addressstring订单收币地址
payTimestringACH给用户转账的时间
completeTimestring订单收到数字货币确认的时间
merchantOrderNostring商户订单号
cryptostring卖币的数字货币
networkstring卖币的数字货币对应的网络
cryptoPricestring数字货币对应fiat的价格
cryptoAmountstring订单上的数字货币数量
fiatAmountstring用户到账的法币金额,包含手续费
appIdstringappID
fiatstring法币币种
txHashstring用户转账的hash
emailstring用户邮箱
newSignaturestring签名,签名方式可参考这里
statusstring订单状态 订单状态列表
orderAddressstring订单页面url
cryptoacturalAmountstring订单实际收到的数量
rampfeestring订单的手续费,币种与法币币种相同
receiptTimestring法币到账的时间
paymentTypestringcard为提现到卡,account为提现到账户
namestring卡或者账户姓名
cardstring卡信息展示前6后4,121321**1231
accountstring账户信息,展示后四位,****1231
failReasonstring失败原因

📘

注意:不同状态可能有的值和字段为空

回调示例

{
  "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" ,失败原因
}