跳到主要内容

收单回调通知

Webhook

收单订单状态变为已支付或者部分支付或者支付失败时，商户会收到收单回调通知，商户需要根据回调通知更新本地订单状态。

信息

商户可以在创建收单订单时设置回调地址，当收单结果确认时，系统会向该URL发送收单成功的通知。

回调最多发送6次，分别在收单确认后的0秒、15秒、30秒、3分钟、5分钟、10分钟时发送。

当商户正常返回success时，系统会认为回调成功，不再发送后续回调。

注：商户需要验证回调通知的签名，确保通知的安全性，回调的加签方式与普通请求一致。

Request​

Body

required

    chainId int32required

    链 ID

    此为平台内部 ID，不是链上或者钱包里的链 ID，可以从查询链列表接口获取

    orgId int32required

    商户 ID，可以从管理后台查看

    outTradeNo stringrequired

    商户订单号

    outPaymentNo stringrequired

    支付单号

    description stringrequired

    商品描述

    isLegalTender int32required

    Possible values: [0, 1]

    报价币种是否为法币

    • 0 - 否
    • 1 - 是
    quoteCurrencySymbol stringrequired

    订单报价币种符号，必须为大写字母

    注：报价币种为法币时，该字段为国际标准法币符号，如 USD、CNY，否则为数字货币符号，如 USDT、TRX、ETH

    quoteAmount stringrequired

    订单报价金额

    注：是实际金额，必须为正数，可为小数

    paymentStatus int32required

    Possible values: [0, 1, 2, 3, 4, 5]

    收单状态

    • 0 - 已支付
    • 1 - 待支付
    • 2 - 区块确认中
    • 3 - 部分支付
    • 4 - 支付失败
    • 5 - 已退款
    paymentType int32

    Possible values: [0, 1]

    支付方式

    • 0 - 合约支付
    • 1 - 扫码支付（钱包转账）
    expectedAmount string

    订单应付金额

    注：该字段的值为整型数字，通过 (实际金额 * 10^货币小数位数) 计算而来

    settlementAmount string

    订单结算金额

    注：该字段的值为整型数字，通过 (实际金额 * 10^货币小数位数) 计算而来

    settlementCurrencySymbol string

    结算币种符合，以用户实际支付的货币为准

    transferHash string

    订单交易哈希

    userWalletAddress stringrequired

    用于收款的子合约账户地址

    fromAddress string

    付款地址

    createTime date-timerequired

    订单创建时间

    blockTime int64

    到账时间

    注：Unix 时间戳，单位：秒

Responses​

OK

Schema

    string

    Possible values: [success]

Loading...
最后于 更新