充值回调

API endpoint: {品牌商户配置的充值回调域名}

Verb: POST

Signature ：需要签名，参考统一签名说明

请求参数：

参数 出现 类型 约束 描述
brand_code 1 String 字符串，最大 20 位 品牌编号，系统对接前由“收钱吧”提供
order_no 1 String 字符串，最大 36 位 收钱吧侧充值订单号
user_id 1 String 字符串，最大 36 位 用户在礼品卡微信小程序内的UnionId，非必填
cards 1 Array 数组 充值成功生成的卡的列表
biz_time 0-1 String 字符串，最大 20 位 充值成功的时间
total_amount 1 String 字符串，最大 11 位 充值的总计面额，以分为单位
total_net_amount 1 String 字符串，最大 11 位 充值的总计净额，以分为单位
pay_amount 1 String 字符串，最大 11 位 用户充值付款的总金额，以分为单位
collect_amount 1 String 字符串，最大 11 位 用户充值商户的总实收金额，以分为单位

cards：

参数 出现 类型 约束 描述
card_number 1 String 字符串，最大 36 位 充值卡号
card_name 1 String 字符串，最大 36 位 充值卡名
card_surface_id 1 String 字符串 充值卡面 id
card_surface_name 0-1 String 字符串，最大 36 位 充值卡面名称
card_surface_url 0-1 String 字符串 充值卡面图片地址
after_balance 1 String 字符串，最大 20 位 充值卡后剩余的余额，以分为单位
after_net_balance 1 String 字符串，最大 20 位 充值卡后剩余的净额，以分为单位
before_balance 1 String 字符串，最大 20 位 充值卡前剩余的余额，以分为单位
before_net_balance 1 String 字符串，最大 20 位 充值卡前剩余的净额，以分为单位

返回参数：

描述：商户收到回调后的响应，收钱吧判断回调成功的标志。

参数 出现 类型 约束 描述
response 1 String JSON 格式 收到通知的返回结果体
response.head 1 String JSON 格式 收到通知的返回结果体头部数据，本次响应的公共参数
response.body 1 String JSON 格式 收到通知的返回结果体的业务返回对象，不同结果有各自定义
signature 1 String 签名字符串 收到通知的返回体的加密签名，签名规则见“公共定义”-“签名”部分

response.head

参数 出现 类型 约束 描述
version 1 String 字符串，最大 10 位 参考各自的 API 接口版本号，当前版本 1.0.0
sign_type 1 String 字符串 签名算法, SHA256即RSA 加密的 SHA256 算法
appid 1 String 数字，最大 32 位 由收钱吧提供，用于识别商户和应用系统
response_time 1 String 字符串，最大 64 位 带时区的请求时间，遵循ISO-8601 标准。

response.body

参数 出现 类型 约束 描述
result_code 1 String 数字，最大 3 位 请求处理结果,
200: 请求成功; 400: 客户端错误; 500: 服务端错误;
error_code 0-1 String 字符串 请求处理错误码，请求处理失败才返回
error_message 0-1 String 字符串 请求处理错误信息描述，请求处理失败才返回

响应回调成功的数据格式示例：

{
    "response":{
        "head":{
            "version":"1.0.0",
            "sign_type":"SHA256",
            "appid":"28lp61847655",
            "response_time":"2019-08-01T12:00:00+08:00"
        },
        "body":{
            "result_code":"200"
        }
    },
    "signature":"签名值"
}

results matching ""

    No results matching ""