使用场景:服务开通/授权状态变更通知
接口编号:zhima.credit.payafteruse.creditagreement.changed
请求参数(bizdata):
参数 | 参数名称 | 取值 | 可空 | 类型 | 备注 |
---|---|---|---|---|---|
credit_agreement_id | 开通/授权协议号 | 否 | string(128) | ||
agreement_status |
开通/授权 状态 |
【描述】开通/授权状态 VALID:有效 INVALID:无效 |
否 | string(16) | |
out_agreement_no |
商户外部 协议号 |
否 | string(32) | ||
biz_time |
开通/授权 状态变更 的时间 |
【示例值】2021-01-19 00:00:00 | 否 | string(64) | |
open_channel | 开通渠道 |
【描述】开通渠道 区分是商家侧推荐开通/支付后推荐开通 【示例值】ALIPAY_RECOMMEND |
否 | string(32) | |
alipay_user_id | 用户ID | 否 | string(64) |
alipay_user_id和open_id任选其一传入 必传 |
|
open_id | 开放ID | 否 | string(128) | ||
ext_info | 扩展字段 |
【描述】该字段只在特殊业务场景下 根据业务方约定返回 一般业务场景下不需要消费该字段 【示例值】{"key":"value"} |
是 | string(1024) |
协议号获取: ext_info.deductAgreement.agreement_no |
通知应答:
参数 | 参数名称 | 是否重试 | 是否区分大小写 |
---|---|---|---|
success | 消息处理成功 | 否 | 否 |
fail | 消息处理失败 | 是 | 是 |
说明:消息服务会根据响应报文判断商户系统是否已经成功处理消息。如果HTTP同步响应报文返回 success 字符串,消息服务则认为消息已经处理成功,停止投递,如果返回 fail ,表示消息获取失败,支付宝会根据投递重试策略重新发送消息到应用网关地址;
投递重试策略:一般情况下,25 小时以内完成 8 次通知,除了第一次是实时投递外,后续的每次重试都会间隔一段时间,间隔频率一般是:2m、10m、10m、1h、2h、6h、15h(第二次消息投递是在第一次投递失败后的 2 分钟;第三次投递是在第二次投递失败后的 10 分钟,以此类推)。
样例报文: