支付宝支付(五):周期扣款-支付后签约场景

本文详细介绍了如何通过调用APP支付接口,在支付宝中实现支付并完成周期扣款签约,涉及关键代码示例、业务流程图以及开发者心路历程。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

目录

一、调用APP支付接口,拉起支付宝,支付并签约页面

二、业务流程图

三、心声


一、调用APP支付接口,拉起支付宝,支付并签约页面

1、业务代码如下:

public AlipayTradeAppPayResponse payAndSignScene(AliPayBo bo) {
        try {
            log.info("------------------------开始初始化AliPay入参,订单号【{}】",bo.getOutTradeNo());
            // 也可以调用batchOptional扩展方法,批量设置可选业务参数(biz_content下的可选字段)
            Map<String, Object> optionalArgs = new HashMap<>();
            //该笔订单允许的最晚付款时间,逾期将关闭交易。取值范围:1m~15d,该参数数值不接受小数点,如 1.5h,可转换为 90m。
            optionalArgs.put("timeout_express", "30m");
            //订单总金额,单位为元,精确到小数点后两位,取值范围[0.01,100000000]
            optionalArgs.put("total_amount", bo.getTotalAmount());
            //周期扣款销售产品码固定为CYCLE_PAY_AUTH。
            optionalArgs.put("product_code", "CYCLE_PAY_AUTH");
            //交易标题
            optionalArgs.put("subject",bo.getSubject());
            //商户网站唯一订单号
            optionalArgs.put("out_trade_no",bo.getOutTradeNo());

            //---------------------------------------------设置签约参数:start-----------------------------
            Map<String, Object> signParams = new HashMap<>();
            //周期扣款个人签约产品码固定为CYCLE_PAY_AUTH_P
            signParams.put("personal_product_code","CYCLE_PAY_AUTH_P");
            //协议签约场景,参见下文sign_scene参数说明  INDUSTRY|EDU教育行业 TODO
            signParams.put("sign_scene", AliPayConstant.SIGN_SCENE);
            // 商户签约号,代扣协议中标示用户的唯一签约号(确保在商户系统中唯一) TODO
            signParams.put("external_agreement_no",bo.getExternalAgreementNo());

            /**请按当前接入的方式进行填充,且输入值必须为文档中的参数取值范围,
             * 1. ALIPAYAPP (钱包h5页面签约)
             * 2. QRCODE(扫码签约)
             * 3. QRCODEORSMS(扫码签约或者短信签约)*/
            Map<String, Object> accessParams = new HashMap<>();
            accessParams.put("channel","ALIPAYAPP");
            signParams.put("access_params",accessParams);

            /**周期管控规则参数period_rule_params,在签约周期扣款产品(如CYCLE_PAY_AUTH_P)时必传,在签约其他产品时无需传入。
             周期扣款产品,会按照这里传入的参数提示用户,并对发起扣款的时间、金额、次数等做相应限制 */
            Map<String, Object> periodRuleParams = new HashMap<>();
            //周期类型period_type是周期扣款产品必填,枚举值为DAY和MONTH
            periodRuleParams.put("period_type","DAY");
            //30天为一个扣款周期
            periodRuleParams.put("period","30");
            /**首次执行时间execute_time是周期扣款产品必填,即商户发起首次扣款的时间。精确到日,格式为yyyy-MM-dd
             结合其他必填的扣款周期参数,会确定商户以后的扣款计划。发起扣款的时间需符合这里的扣款计划
             首次扣款日期:当前时间+30  ; 目前允许商户在约定日期之前5天(不含扣款日当天)开始扣款
             */
            periodRuleParams.put("execute_time", bo.getExecuteTime());

            /**单次扣款最大金额single_amount是周期扣款产品必填,即每次发起扣款时限制的最大金额,单位为元。商户每次发起扣款都不允许大于此金额*/
            periodRuleParams.put("single_amount",bo.getSingleAmount());

            signParams.put("period_rule_params",periodRuleParams);

            //签约成功后商户用于接收异步通知的地址:如果不传入,签约与支付的异步通知都会发到外层notify_url参数传入的地址;TODO
            //signParams.put("sign_notify_url","");

            //签约参数。如果希望在sdk中支付并签约,需要在这里传入签约信息。周期扣款场景 product_code 为 CYCLE_PAY_AUTH 时必填
            optionalArgs.put("agreement_sign_params",signParams);
            //---------------------------------------------设置签约参数:end-----------------------------
            log.info("------------------------完成初始化AliPay入参,订单号【{}】,参数为【{}】",bo.getOutTradeNo(), JSONUtil.toJsonStr(optionalArgs));
            Long startTime = System.currentTimeMillis();
            log.info("------------------------开始-调用AliPay easySDK 执行同步支付异步签约,订单号【{}】",bo.getOutTradeNo());
            //1完成同步支付与异步签约,通过异步通知或者查询接口确认签约结果
            AlipayTradeAppPayResponse payResponse = Factory.Payment.App()
                    .batchOptional(optionalArgs)
                    .pay(bo.getSubject(),bo.getOutTradeNo(),bo.getTotalAmount());
            Long endTime = System.currentTimeMillis();
            log.info("------------------------完成-调用AliPay easySDK 执行同步支付异步签约,订单号【{}】,用时{}毫秒",bo.getOutTradeNo(),(endTime-startTime));
            if (ResponseChecker.success(payResponse)) {
                return payResponse;
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
        return null;
    }

2、使用的是APP支付统一接口,只是入参多了签约的相关协议

二、业务流程图

1、

 2、关于生成预支付订单的,和后续支付结果查询,处理后续业务代码就根据个人业务场景处理,

3、我没有使用支付宝的异步通知的参数:notice_url ,都是使用定时任务根据业务表,代用支付宝官方接口来控制后续的逻辑,这点看个人选择了

三、心声

1、由于之前没做过支付宝周期扣款的业务,公司也没有人会,全靠个人看官网,频繁的咨询官方技术支持,不停的踩坑,总算把第一版的功能实现了,后续功能有优化的话,在补充文章

2、到此,支付宝支付相关的文章到此结束了,希望可以帮助刚入坑的同学们!

<think>嗯,用户问的是“条码支付可以变成userid支付吗”。首先,我需要明确这两个概念的区别。条码支付通常是B扫C模式,用户出示付款码,商家扫描后完成支付,而userid支付可能是指通过用户的支付宝用户ID来进行支付,比如直接向指定用户发起扣款,不需要扫码。 接下来,我要检查支付宝开放平台的文档,确认是否有支持通过userid直接支付的接口。现有的当面付接口主要是基于付款码或者声波的,可能需要查看是否有其他产品如单笔转账或者代扣接口。同时,需要注意用户可能的需求场景,比如定期扣费、会员自动续费等,这时候userid支付会更适合。 然后,考虑用户权限问题。使用userid支付通常需要用户预先授权,比如签订代扣协议,否则无法直接扣款。而条码支付属于用户主动出示付款码,属于即时交易。安全方面,直接通过userid支付风险更高,支付宝可能会有更严格的审核和限制。 另外,用户可能是在想是否有办法将现有的扫码支付流程改为通过userid来触发,避免每次都需要扫码。这时候可能需要引导用户了解代扣或者预授权支付方式,这些是否满足他们的业务需求。 还要注意接口的合规性,支付宝对于不同支付方式有不同的规定,必须符合金融监管要求。比如代扣需要用户签约,并且只能用于特定场景,不能滥用。因此,直接替换条码支付为userid支付可能不可行,但可以通过其他产品组合实现类似效果。 最后,总结回答时需要明确两者区别,解释支付宝现有接口是否支持,以及替代方案,同时提醒安全合规的问题。</think>支付宝的**条码支付**(B扫C)与**user_id支付**属于两种不同的支付模式,无法直接互相转换,但可通过其他接口组合实现类似效果。以下是关键分析: --- ### **一、核心概念对比** | 维度 | 条码支付 | user_id支付 | |--------------|-----------------------------|-----------------------------| | **触发方式** | 用户出示付款码 → 商家扫码 | 商户系统指定用户ID发起扣款 | | **适用场景** | 线下即时交易(超市、便利店) | 定期扣费(会员续费、自动缴费) | | **权限要求** | 无需用户预授权 | 需用户提前签约代扣协议 | | **接口类型** | `alipay.trade.pay` | `alipay.fund.auth.order.apply`(预授权)<br>`alipay.trade.app.pay`(App支付) | --- ### **二、为什么不能直接替换?** 1. **技术逻辑差异** - 条码支付依赖**动态付款码**(临时凭证),码值有效期为2分钟且单次有效。 - user_id支付需基于**用户身份标识**(如`user_id`或`open_id`),要求用户预先授权代扣或绑定支付场景。 2. **合规限制** - 根据央行规定,直接通过user_id扣款需符合**代扣业务规范**(仅限水电煤、会员续费等特定场景)。 - 条码支付属于“**当面付**”范畴,资金流向和风控策略不同。 --- ### **三、替代方案:实现“类user_id支付”效果** #### 方案1:**预授权+代扣协议** 1. 用户首次操作时签订代扣协议(调用`alipay.user.agreement.sign`)。 2. 后续通过`alipay.trade.pay`+`agreement_no`直接扣款,无需再次扫码。 ```java // 示例请求参数(部分): { "out_trade_no": "202308010001", "total_amount": "99.00", "subject": "月度会员费", "agreement_params": { "agreement_no": "2023XXXXXXX" // 已签约协议号 } } ``` #### 方案2:**App支付+用户绑定** 1. 用户在商户App内绑定支付宝账号(获取`user_id`)。 2. 支付时调用`alipay.trade.app.pay`,通过`user_id`识别身份(需用户确认)。 #### 方案3:**服务窗/小程序支付** 1. 引导用户关注商户支付宝服务窗或小程序,获取用户OpenID。 2. 通过OpenID发起支付请求(需用户主动确认)。 --- ### **四、注意事项** 1. **合规性** - 代扣协议需明确告知用户扣款用途、周期,且**不得用于非约定场景**。 - 用户有权随时解约(需处理`agreement_unsubscribe`通知)。 2. **安全风控** - 高频user_id支付易触发支付宝风控拦截(错误码`ACQ.TRADE_NOT_ALLOWED`)。 - 建议结合短信验证、人脸核身等二次确认机制。 3. **用户体验** - 首次签约流程会增加操作步骤,需设计引导提示。 --- ### **、典型场景建议** - ✅ **适合user_id支付**:每月会员费、话费自动充、物业费代扣。 - ❌ **不适合user_id支付**:线下随机金额消费(需改用扫码/刷脸支付)。 如需技术细节,可参考支付宝官方文档: - [代扣协议接入指南](https://opendocs.alipay.com/open/20190319114403226875/intro) - [App支付接口说明](https://opendocs.alipay.com/open/204/105051)
评论 4
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值