支付宝小程序唤起独立签约

目录

获取签约字符串

唤起支付宝周期扣款签约页面

---

支付宝小程序唤起独立签约，需要通过alipay.user.agreement.page.sign接口获取签约字符串signStr，然后调用my.paySignCenter API在支付宝小程序内唤起周期扣款签约页面。

获取签约字符串

调用接口alipay.user.agreement.page.sign获取签约字符串，所需参数如下：

公共请求参数

参数	必填	描述	示例值
app_id	是	支付宝分配给开发者的应用ID	2014072300007148
method	是	接口名称	alipay.user.agreement.page.sign
format	否	仅支持JSON	JSON
return_url	否	HTTP/HTTPS开头字符串	https://m.alipay.com/Gk8NF23
charset	是	请求使用的编码格式，如utf-8,gbk,gb2312等	utf-8
sign_type	是	商户生成签名字符串所使用的签名算法类型，目前支持RSA2和RSA，推荐使用RSA2	RSA2
sign	是	商户请求参数的签名串，详见签名	详见示例
timestamp	是	发送请求的时间，格式"yyyy-MM-dd HH:mm:ss"	2014-07-24 03:07:50
version	是	调用的接口版本，固定为：1.0	1.0
notify_url	否	支付宝服务器主动通知商户服务器里指定的页面http/https路径。	http://api.test.alipay.net/atinterface/receive_notify.htm
app_auth_token	否	详见应用授权概述
biz_content	是	请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

请求参数

参数	必填	描述	示例值
product_code	可选	销售产品码，商户签约的支付宝合同所对应的产品码。 周期扣款场景固定为 CYCLE_PAY_AUTH。	CYCLE_PAY_AUTH
personal_product_code	必选	个人签约产品码，商户和支付宝签约时确定，商户可咨询技术支持。 周期扣款个人签约产品码固定为 CYCLE_PAY_AUTH_P	CYCLE_PAY_AUTH_P
sign_scene	可选	协议签约场景，商户可根据 代扣产品常见场景值 选择符合自身的行业场景。 说明：当传入商户签约号 external_agreement_no 时，本参数必填，不能为默认值 DEFAULT|DEFAULT。	INDUSTRY|CARRENTAL
external_agreement_no	可选	商户签约号，代扣协议中标示用户的唯一签约号（确保在商户系统中唯一）。 格式规则：支持大写小写字母和数字，最长32位。 商户系统按需自定义传入，如果同一用户在同一产品码、同一签约场景下，签订了多份代扣协议，那么需要指定并传入该值。	test
access_params	必选	请按当前接入的方式进行填充，且输入值必须为文档中的参数取值范围。 扫码或者短信页面签约需要拼装http的请求地址访问中间页面，钱包h5页面签约可直接拼接scheme的请求地址
└channel	必选	目前支持以下值： 1. ALIPAYAPP （钱包h5页面签约） 2. QRCODE(扫码签约) 3. QRCODEORSMS(扫码签约或者短信签约)	ALIPAYAPP
period_rule_params	必选	周期管控规则参数period_rule_params，在签约周期扣款产品（如CYCLE_PAY_AUTH_P）时必传，在签约其他产品时无需传入。 周期扣款产品，会按照这里传入的参数提示用户，并对发起扣款的时间、金额、次数等做相应限制。
└period_type	必选	周期类型period_type是周期扣款产品必填，枚举值为DAY和MONTH。 DAY即扣款周期按天计，MONTH代表扣款周期按自然月。 与另一参数period组合使用确定扣款周期，例如period_type为DAY，period=30，则扣款周期为30天；period_type为MONTH，period=3，则扣款周期为3个自然月。 自然月是指，不论这个月有多少天，周期都计算到月份中的同一日期。例如1月3日到2月3日为一个自然月，1月3日到4月3日为三个自然月。注意周期类型使用MONTH的时候，计划扣款时间execute_time不允许传28日之后的日期（可以传28日），以此避免有些月份可能不存在对应日期的情况。	DAY
└period	必选	周期数period是周期扣款产品必填。与另一参数period_type组合使用确定扣款周期，例如period_type为DAY，period=90，则扣款周期为90天。	7
└execute_time	必选	首次执行时间execute_time是周期扣款产品必填，即商户发起首次扣款的时间。精确到日，格式为yyyy-MM-dd 结合其他必填的扣款周期参数，会确定商户以后的扣款计划。发起扣款的时间需符合这里的扣款计划。	2019-01-23
└single_amount	必选	单次扣款最大金额single_amount是周期扣款产品必填，即每次发起扣款时限制的最大金额，单位为元。商户每次发起扣款都不允许大于此金额。	10.99
└total_amount	可选	总金额限制，单位为元。如果传入此参数，商户多次扣款的累计金额不允许超过此金额。	600
└total_payments	可选	总扣款次数。如果传入此参数，则商户成功扣款的次数不能超过此次数限制（扣款失败不计入）。	12

const signObj = {
    app_id: '2014072300007148',
    biz_content: '{"access_params":{"channel":"ALIPAYAPP"},"external_agreement_no":"2019_06_0910","personal_product_code":"CYCLE_PAY_AUTH_P","period_rule_params":{"period_type":"DAY","period":"30","execute_time":"2021-10-29","single_amount":"10","total_amount":"600","total_payments":"12"},"sign_scene":"INDUSTRY|DIGITAL_MEDIA"}',
    charset: 'UTF-8',
    method: 'alipay.user.agreement.page.sign',
    sign_type: 'RSA2',
    timestamp: '2021-10-29 17:18:02',
    version: '1.0',    
sign:'Y+Sx4WPF4tIzTnQ+FqYds+xLBfi9wflmD+GPs2LN0qSo6431moZqM3TCouc/tEjzh3/GUFc75yHNEXVBTQ0iL+nSM4PlNgP3yPCql12c38PmChAcfj0C/1+engUkqXtCtWs0lXVKXn2ze3aHLE+64dG87h8I1ngl/2LqSAD8mhH4RmWDIrxFcxNEzlT+GJp+7Ae+OpbT284iOuZ5l5DUya47K7LVI3+/t1sXsHPGAD1d1wDQ+NfcfE+jAAw2XQ1G/EcnNkZCHlplIU1tAFTKDMPKIlOHUV1F1LkqCcH3AK5w+C0RNLcDW8SbN4q79gRGDWXX7C6FjURAjn8Tw8/Zgw=='
};

let signStr = '';

for (let key in signObj) {
    signStr += key + '=' + encodeURIComponent(signObj[key]) + '&';
}
signStr = signStr.substring(0, signStr.length - 1);
signStr = encodeURIComponent(signStr);

唤起支付宝周期扣款签约页面

调用my.paySignCenter API，使用上一步得到的signStr作为API的参数来唤起支付宝周期扣款签约页面。

my.paySignCenter({
      signStr: signStr,
      success: (res) => {
        my.alert({
          title: 'success', // alert 框的标题
          content: JSON.stringify(res)
        });
      },
      fail: (res) => {
        my.alert({
          title: 'fail', // alert 框的标题
          content: JSON.stringify(res)
        });
      }
    });