会员退卡回调

接口介绍：

描述：此接口由商户提供，在收钱吧侧配置。当会员退卡完成后，收钱吧服务器调用此接口将会员当次退卡信息通知到商户服务器。

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

Verb: POST

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

请求参数：

参数 出现 类型 约束 描述
brand_code 1 String 字符串，最大 20 位 品牌编号，系统对接前由“收钱吧”提供
order_no 1 String 字符串，最大 36 位 商户指定的退卡订单号，在礼品卡商户后台内确认退卡的时候填写
user_id 1 String 字符串，最大 64 位 用户在礼品卡微信小程序内的UnionId
card_number 1 String 字符串，最大 36 位 发起退卡的卡号
user_mobile 0-1 String 字符串，最大36位 该会员在小程序内授权过手机号时，则会返回该字段
country_code 0-1 String 字符串，最大36位 手机号区号，比如"86"，该会员在小程序内授权过手机号时，则会返回该字段
cash_out_amount 1 String 字符串，最大 11 位 商户指定的实际退卡的金额，以分为单位
cash_out_net_amount 1 String 字符串，最大 11 位 实际退卡的净额，以分为单位
actual_refund_amount 1 String 字符串，最大 11 位 实际退款的金额，以分为单位
third_part_activity 0-1 Object 对象 第三方活动对象
biz_time 1 String 字符串，最大 20 位 退卡完成的时间
remark 1 String 字符串，最大 128 位 商户操作退卡完成时候指定的退卡备注信息
card_sales_biz_tag 0-1 String 字符串 销售业务标签

third_part_activity：

参数 出现 类型 约束 描述
activity_sn 0-1 String 字符串 优先返回第三方系统活动标识，没有第三方系统活动标识返回礼品卡系统中的活动标识
client_member_id 0-1 String 字符串 商户端的用户 id
third_part_type 0-1 int 数字 第三方系统的类型
1 - 表示CRM系统

返回参数：

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

参数 必填 类型 约束 描述
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 ""