IBitPay
    🌐繁體中文
    • 🌐繁體中文
    • 🌐English
    • IBitPay 開放平臺文檔中心
    • 加密解密方式
    • 回調通知
    • 全局错误码
    • 范例代码
    • OpenApi
      • 創建入金訂單
        POST
      • 獲取入金匯率
        POST
      • 獲取商户余额
        POST
      • 創建出金訂單
        POST
      • 獲取出金匯率
        POST
      • 創建入金訂單(自行开发收银台)
        POST
      • 取消订单
        POST
      • 付款订单
        POST
      • 獲取订单详情
        POST
      • 獲取商户资金流水列表
        POST
      • 查询黑名单
        POST

    回調通知

    当入金訂單和出金訂單交易成功後,會通過商戶提前配置好的回調地址,發起請求進行通知

    1.请求方式:POST#

    2.参数格式:JSON#

    3.1 入金回调参数:#

    参数名类型说明
    OrderNostring订单编号
    MerchantNostring商户编号
    MerchantOrderNostring商户订单编号
    PayTimestring支付时间
    Quantitydecimalusdt金额
    FiatCurrencydecimal法币金额
    OrderStateint状态(1:待付款, 2:待释放, 3:成功, 4:取消, 5:过期, 6:待回调 只有6时才会发起回调)

    3.2 出金回调参数:#

    参数名类型说明
    OrderNostring订单编号
    MerchantNostring商户编号
    MerchantOrderNostring商户订单编号
    PayTimestring支付时间
    Stateint状态(1:待分配, 2:待付款, 3:待重新分配, 4:成功,5:拒绝,6:账户异常)

    4.举例:#

    解密前参数
    {
      "encryptedData": "BQDDdGq...(Base64字符串)"
    }
    解密后参数
    {
      "OrderNo":"123",
      "MerchantNo":"456",
      "MerchantOrderNo":"no123",
      "PayTime":"2025-1-1 12:00:00"
    }

    5.需要的返回格式:#

    {
        "code":200
    }
    或
    success

    6.注意事项:#

    商户在收到通知后返回 {"code":200} 或者 success 字符串 ,否则视为商户未成功收到通知,并采用以下重复策略通知策略继续通知:15s-3m-10m-30m-1h-2h-6h-15h
    如果在通知策略时间内商户仍未返回成功码,则视为商户服务异常,放弃本笔订单通知,相关订单状态可在商户平台查询
    异步通知只有在商户订单成功完成后才会触发,因此,异步通知失败不代表支付失败
    Modified at 2026-06-16 02:55:22
    Previous
    加密解密方式
    Next
    全局错误码
    Built with