尊敬的XX商户
由于你们的业务特性,之前在你们使用支付宝商户代扣的产品时,申请了对于已签约代扣协议的用户在支付宝端解约协议时,需要跳转至你们指定的页面进行解约处理,目前发现该处理方式存在很多问题,用户投诉较高,因此支付宝建设了一个体验相对更好的异步解约能力,在保证商户资金回款能力的前提下,尽量提供最优的用户体验;现在需要你们配合从原来的跳转解约模式,升级到最新的异步解约能力;
一、异步解约整体能力及流程介绍:
1、用户在支付宝支付设置—免密支付协议管理页面发起解约;
2、支付宝获取用户解约请求,将协议置为解约中(该状态下不影响正常发起扣款);
3、再通过你们在支付宝配置的解约通知地址,将解约请求通知你们;
4、商户在收到用户对应代扣协议的解约申请时,内部判断用户是否存在在途订单或欠费订单;
5、判断明确后立即调用支付宝解约接口,在解约接口传入具体的:废弃解约或确认解约;
6、特别注意:
(1)当商户收到支付宝的解约请求后,没有调用支付宝解约接口处理,在支付宝端协议管理详情页面,协议会处于解约中状态,用户无法继续发起解约;需要等待商户调用支付宝解约接口,返回明确结果后才会变更解约中状态;
(2)当商户收到支付宝解约请求后,调用支付宝解约接口,传入废弃解约时,需要同时传入具体废弃原因类型,支付宝端会更新支付宝侧协议管理详情页面协议状态为解约失败,同时会根据传入废弃类型,展示对应失败原因(有在途订单 or 有欠费未还),用户可以继续发起解约申请;
(3)商户端可以根据具体的业务逻辑,在收到解约申请后,进行扣费或等待一定时间扣费,在明确是否允许解约后再调用支付宝解约接口进行解约处理;
二、接口对接说明
接口对接说明
(1). 通知参数里面,会有一个status=APPLY_UNSIGN
(2). 解约参数里面会有一个OperateType, 见后面的截图:
(3). 查询结果无变化
(4). 通知示例:http://paynotify.shouqiev.com/notify/v1/alifreeUnsign?sign_modify_time=2019-02-22 14:09:05¬ify_type=dut_user_unsign¬ify_time=2019-12-09 13:40:35&unsign_time=2018-11-12 18:05:04&agreement_no=20185912482238558772&alipay_user_id=2088112995898729&sign=$$$&product_code=GENERAL_WITHHOLDING_P&sign_type=MD5¬ify_id=2019120900222134035076790545608689&scene=INDUSTRY|ALIPAYGO&status=APPLY_UNSIGN
三、使用异步解约能力需要准备什么
1、如果你们是接入代扣1.0的接口(mapi),需要把你们接受解约请求的地址给到对应支付宝BD,让他帮你把改地址配置在商户代扣合约内的解约通知地址内。具体格式参考:GBK|MD5|HTTP://xx.xxx.com/notify
2、如果你们接入的时候代扣2.0的接口(openapi),你们直接吧接受解约结果通知的地址配置在调用代扣接口的应用网关地址内即可
3、在地址配置,以及接口对接完成后,将你们的PID给到支付宝BD,由BD同学内部申请放开你们使用异步解约能力
如果你们在到期截止时间还没完成异步解约能力的升级,我们将会通过内部自动升级为直接允许解约,如果你们没有接通接受解约结果的通知地址,后续用户在支付宝端解约后,你们无法获取具体协议解约结果通知;
商户代扣解决方案:https://docs.alipay.com/pre-open/20170601105911096277/oyw6hu