支付宝支付（五）：周期扣款-支付后签约场景

最新推荐文章于 2025-06-13 09:46:50 发布

今天的砖头很烫手

最新推荐文章于 2025-06-13 09:46:50 发布

阅读量4.6k

点赞数 6

CC 4.0 BY-SA版权

分类专栏：支付宝支付

本文链接：https://blog.youkuaiyun.com/One_Rabbit2016/article/details/119180273

支付宝支付专栏收录该内容

6 篇文章

订阅专栏

本文详细介绍了如何通过调用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支付统一接口，只是入参多了签约的相关协议