兔珑付API
    兔珑付API
    • 对接指南
    • 公共参数说明
    • 签名算法说明
    • 异步回调说明
    • 相关资源
    • 接口列表
      • 统一下单
        POST
      • 订单状态查询
        POST
      • 订单退款
        POST
      • 分账子账号开户
        POST
      • 余额支付
        POST

    异步回调说明

    验签#

    为保证安全性,兔珑服务端异步回调客户端的请求会进行加签处理。客户端收到回调请求后需对请求进行验签,验签通过后方可认为是合法的回调请求,进行后续的业务处理。

    验签规则#

    服务端签名方式为与下单一致,请根据下单时使用的签名方式进行验签,下方为各种签名方式的验签规则:

    MD5#

    对接收到的参数进行排序并签名(排除掉 sign 参数),然后对比得到的签名与 sign 是否一致,一致则通过。PHP 示例如下

    RSA2#

    对接收到的参数进行排序并签名(排除掉 sign 参数)使用平台公钥进行验签。PHP 示例如下

    注意事项#

    1.
    所有的回调请求均通过 HTTP POST 的方式发起。
    2.
    为保证回调请求的准确触达,客户端收到回调请求后需在 20s 内返回 SUCCESS 的响应。如服务端未能收到正确的响应,则会在稍后进行重试,客户端的回调接口需支持幂等。
    3.
    如回调失败,服务端将在 1 小时内随机时间重复回调 10 次。

    交易成功异步回调#

    请求参数#

    字段类型是否必传说明
    open_useridStringY系统商户号
    out_trade_noStringY商户订单号
    system_order_idStringY系统订单号
    pay_external_idStringY银行订单号
    total_feeStringY金额
    signStringY签名(签名方式同下单时一致)
    商户处理成功后,需要返回 SUCCESS 响应,请注意响应不要包含其他字符
    ⚠️ 温馨提示:
    根据以往经验,如商户一直反复收到异步通知,通常是因为响应内容未正确返回 SUCCESS。
    请务必检查响应是否含有 BOM 头 或其他多余字符,导致兔珑服务端判定处理失败。
    上一页
    签名算法说明
    下一页
    相关资源
    Built with