接口描述

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

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

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

接口说明

请求方式：POST

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

Header参数

参数名	类型	说明
timestamp	string	时间戳（验签用到）参考这里

买币回调

Body参数列表

参数名	类型	说明
appId	string	商户应用的唯一标识
orderNo	string	系统订单号
email	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	服务费
fiatInUSD	string	法币金额以美元计价 *订单在FINISHED状态下返回
rampFeeInUSD	string	手续费以美元计价 *订单在FINISHED状态下返回
cryptoNetworkFee	string	网络费以购买的crypto计价 *订单在FINISHED状态下返回
networkFeeInUSD	string	网络费以美元计价 *订单在FINISHED状态下返回
cryptoAmountInUSDT	string	购买crypto以USDT计价 *订单在FINISHED状态下返回
rampFeeUnit	string	手续费单位（法币，例：USD、INR）
newSignature	string	签名，签名方式可参考这里

📘
注意：

INR本地支付，法币支付完成这一步没有回调。

支付失败通知会增加 returnCode（失败错误码）、returnMsg（失败原因）2 个字段，无 message 参数

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

参数名	类型	说明
createTime	string	订单创建时间，格式YYYY-MM-DD, HH:MM:SS，如2021-11-25 10:00:00
tokenAddress	string	买币时返回token的合约地址；如果是主链币没有合约地址，为空
rebateFiatAmount	string	分佣金额，以支付的法币计价
rebateUsdAmount	string	分佣金额，以美元计价
alpha2	string	ISO 3166-1 二位字母国家code，如us/jp等

回调示例（FINISHED）

{
    "payTime": "2025-10-27 14:31:11",
    "txTime": "2025-10-27 14:37:06",
    "signature": "8740b5ae5fae0559a16bf09e755d***********",
    "networkFee": "0.10092527",//以法币计价
    "rawRampFee": "5.188000",
    "fiatInUSD": "120",//以美元计价的购买金额
    "network": "LTC",
    "cryptoPrice": "100.92520000",//Crypto以购买法币计价
    "payType": "Apple Pay",
    "rampFee": "5.18000000",//购买法币计价的手续费
    "appId": "**************",
    "fiat": "USD",
    "newSignature": "M3yP3sMg97cfuwCk/tQkUrr*****************",
    "txHash": "6f3cb23402837e3dbe3e52aff2f995ff********************",
    "email": "H**********@icloud.com",
    "rampFeeInUSD": "5.18",
    "amount": "120.00000000",//购买法币的金额
    "orderNo": "1432224***********",
    "address": "ltc1q5hs99hj3rq5e04fsr5******************",
    "cryptoNetworkFee": "0.00446791",
    "networkFeeInUSD": "0.45",
    "cryptoAmountInUSDT": "114.36907472",
    "merchantOrderNo": "647b0a96************",
    "crypto": "LTC",
    "rampFeeUnit": "USD",
    "cryptoQuantity": "1.1332055",
    "status": "FINISHED"
}

卖币回调

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
email	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": "USD",/法币币种
  "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" ,失败原因
}