常见问题

Q：同一个商家下，同一个用户可以有多套签约关系吗？

A：可以的。通过商家外部签约号和场景参数来区分哪套协议。如果签约时传入了签约号及场景参数，后续查询协议和解约时也必须传入。如遇到显示 开通成功 情况，请检查是否签约字符串固定值未变。

Q：period_rule_params.execute_time 周期管控规则中的execute_time 如何填写？

A：如果是先签约后代扣场景 execute_time 是首次执行时间。例如：用户在 1 月 12 日签约购买会员，周期是一个月，那么想在 13 号扣款 period_rule_params.execute_time（首次执行时间）应填写为 1 月 13 日。

如果是支付并签约 execute_time 传的是下次扣款时间。例如：用户在 1 月 12 日支付并签约购买会员，周期是一个月，那么 period_rule_params.execute_time（扣款执行时间）应填写为 2 月 12 日。因为用户唤起支付并签约页面时已支付 1 月 12 日至 execute_time（扣款执行时间）期间的费用。

Q：identity_params.identity_hash 实名信息中的hash值如何生成？

拼接姓名与身份证号（中间不加任何字符），使用 SHA256 方式，UTF-8 编码，生成十六进制的字符串（不用区分大小写）。

以 Java 为例，生成 hash 可使用 java.security.MessageDigest，从字节数组转为十六进制的字符串可使用 org.apache.commons.codec.binary.Hex.encodeHexString() （需引入 commons-codec），也可自己实现。

举例来说，姓名和身份证号拼接后为：

王小明322133199901013214

则生成的 identity_hash 为：

bf3a69bf2563f68291f85d75ec69466ae8e8834a59b42801304089ae1bcad2e8

引入 commons-codec-1.4 及之上版本示例如下：

String str = "王小明322133199901013214";
String type = "SHA-256";
MessageDigest md = MessageDigest.getInstance(type);
md.update(str.getBytes("utf-8"));
byte[] bs = md.digest();        
// commons-codec 1.4及之后版本可用如下方式获取
String encdeStr = org.apache.commons.codec.binary.Hex.encodeHexString(bs);
System.out.println("identity_hash: " + encdeStr);

**说明：**目前只有地铁等少数场景在使用此参数，如无需要不用关注。

Q：alipay.user.agreement.executionplan.modify（周期性扣款协议执行计划修改接口）中的 deduct_time（下一次扣款时间）取值范围是多少？

A：扣款失败保持不变，扣款成功往后推1个周期。

例：

period_type:MONTH
period:1
deduct_time:2019-07-05

在此例中每个自然月的5号发起扣款，2019 年 7 月 5 日首次执行。

在 7 月 5 日之前下次扣款时间：2019-07-05，可执行扣款时间：2019-06-30 至 05，deduct_time 取值范围大于 2019-07-05。

在 7 月 5 日扣款时间点扣款失败，同上不变。

在 7 月 5 日扣款时间点扣款成功，下次扣款时间：2019-08-05，可执行扣款时间：2019-07-31 至 2019-08-05，deduct_time 取值范围大于 2019-08-05。

Q：周期自动扣款代扣失败如何发起重试？

A：扣款时间点发起代扣失败，此时下次扣款时间不变，分 2 种情况：

当前时间处于扣款时间段内（提前 5 天+扣款日当天）则直接发起重试，如：约定扣款日为 20 号，支持商家在 15 至 20 号内可直接重试。

当前时间即将超过扣款时间段，可以通过 alipay.user.agreement.executionplan.modify（周期性扣款协议执行计划修改接口）推迟下一次扣款时间继续重试。

**注意：**扣款失败的重试建议执行 2 次（不要无限制重试），如始终扣不到款则停止提供服务。

Q：商家扣款签约有次数限制吗？

A：同一个商家下同一个用户同一个场景下最多签约10次。

Q：商家扣款是商家主动发起扣款，还是支付宝发起？

A：商家主动发起扣款。签约成功之后后续每次扣款，扣款日（execute_time）前5日商家可使用alipay.trade.pay（统一收单交易支付接口），完成商家扣款协议后续免密代扣操作。

Q：如何实现每月最后一天扣款？

A：把约定日期设置为每月1号，由于可提前5天发起扣款，涵盖了每月最后一天。

Q：如果在规定时间内未完扣款，下一个周期是否可以接着扣？

A：默认情况下不可以，扣款失败需要考虑重试或解约停服务，如特殊业务场景需要跳过本期扣款继续征收下一期，可以使用 alipay.user.agreement.executionplan.modify（周期性扣款协议执行计划修改接口）推迟约定日到下一期发起扣款。

Q：支付并签约接口完成支付和签约之后有几条异步？

A：有 2 条异步，分别标记支付和签约状态。

Q：支付并签约接口生成的签约页面中【开通XX会员自动续费】的开关逻辑是什么？

A：正常状态下，打开表示支付并签约，关闭表示只支付不签约。

Q：商家扣款额度限制？

A：对每个用户的单笔扣款不超过 100 元，当日扣款不超过 1000 元，当月扣款不超过 30000 元；扣款周期最短为 7 天，最长没有限制。

**注意：**一个协议内每次商家扣款只能扣一次，不可多次扣款。如果商家扣款额度大于100元，建议核实支付宝预授权是否可使用且满足业务需求，周期时间为商家自己设置扣款，在自己商家扣款时间内，调用授权转支付接口进行扣款。

Q：商家扣款如何设置personal_product_code（签约个人产品码）？

A：商家扣款 personal_product_code（签约个人产品码）：CYCLE_PAY_AUTH_P（商家扣款个人签约产品码）

**注意：**product_code（销售产品码）：CYCLE_PAY_AUTH，相较于 personal_product_code 少了末尾 p。

Q：商家扣款如何解约？

A：

商家通过 alipay.user.agreement.unsign（支付宝个人代扣协议解约接口）进行解约操作。

用户在支付宝客户端内进行解约操作。支付宝客户端的解约入口：在支付宝客户端内我的 > 设置 > 支付设置 > 免密支付/自动扣款 下找到对应的商家服务**。**

Q：商家扣款签约有效期是多久？

A：商家扣款签约支持设置 sign_validity_period（用户签约请求的协议有效周期）。

商家若签约设置 sign_validity_period 参数，签约时间以设置时间为准。

商家若签约未设置 sign_validity_period 参数，默认签约时间为长期有效。

Q：调用 alipay.trade.pay（统一收单交易支付接口）报 ACQ.CYCLE_PAY_DATE_NOT_MATCH

A：请重新检查扣款日期，在符合约定的日期发起扣款。对于商家扣款产品，签约时会约定扣款的周期。如果发起扣款的日期不符合约定的周期，则不允许扣款。

**注意：**目前允许商家在约定日期之前5天（含扣款日当天）开始扣款，即比起严格限制到某一天稍微留有余地。

Q：调用 alipay.trade.pay（统一收单交易支付接口）报 ACQ.CYCLE_PAY_SINGLE_FEE_EXCEED

A：请在允许的金额范围内扣款。对于商家扣款产品，签约时会约定单笔扣款的最大金额。如果发起扣款的金额大于约定上限，则不允许扣款。

Q：调用 alipay.trade.pay（统一收单交易支付接口）报 ACQ.CYCLE_PAY_TOTAL_FEE_EXCEED

A：请在允许的金额范围内扣款。对于商家扣款产品，签约时可以约定多次扣款的累计金额限制。如果发起扣款的累计金额大于约定上限，则不允许扣款。

Q：调用 alipay.trade.pay（统一收单交易支付接口）报 ACQ.CYCLE_PAY_TOTAL_TIMES_EXCEED

A：请在允许的次数范围内扣款。对于商家扣款产品，签约时可以约定总扣款次数限制。如果发起扣款的累计次数大于约定上限，则不允许扣款。

Q：alipay.user.agreement.transfer(协议由普通通用代扣协议产品转移到周期扣协议产品)接口中普通通用代扣协议产品指的是什么？

A：普通通用代扣协议产品是名称为通用代扣的代扣产品，详情可联系支付宝业务人员或联系商家客服 4007585858（8:00-24:00）申请相应行业的支付宝业务人员协助。

Q：同一个商家下，同一个用户可以有多套签约关系吗？#

Q：period_rule_params.execute_time 周期管控规则中的execute_time 如何填写？#

Q：identity_params.identity_hash 实名信息中的hash值如何生成？#

Q：alipay.user.agreement.executionplan.modify（周期性扣款协议执行计划修改接口）中的 deduct_time（下一次扣款时间）取值范围是多少？#

Q：周期自动扣款代扣失败如何发起重试？#

Q：商家扣款签约有次数限制吗？#

Q：商家扣款是商家主动发起扣款，还是支付宝发起？#

Q：如何实现每月最后一天扣款？#

Q：如果在规定时间内未完扣款，下一个周期是否可以接着扣？#

Q：支付并签约接口完成支付和签约之后有几条异步？#

Q：支付并签约接口生成的签约页面中【开通XX会员自动续费】的开关逻辑是什么？#

Q：商家扣款额度限制？#

Q：商家扣款如何设置personal_product_code（签约个人产品码）？#

Q：商家扣款如何解约？#

Q：商家扣款签约有效期是多久？#

Q：如何修改商家扣款签约页面文案？#

Q：商家扣款支持什么应用场景 ？#

Q：商家扣款如何设置异步通知？#

Q：商家扣款支付后签约页面文案扣款周期小于7天说明？#

Q：如何处理商家扣款失败？#

Q：alipay.user.agreement.page.sign（支付宝个人协议页面签约接口）中的 sign_scene（签约协议场景）填写方式#

Q：调用 alipay.trade.pay（统一收单交易支付接口）报 ACQ.CYCLE_PAY_DATE_NOT_MATCH#

Q：调用 alipay.trade.pay（统一收单交易支付接口）报 ACQ.CYCLE_PAY_SINGLE_FEE_EXCEED#

Q：调用 alipay.trade.pay（统一收单交易支付接口）报 ACQ.CYCLE_PAY_TOTAL_FEE_EXCEED#

Q：调用 alipay.trade.pay（统一收单交易支付接口）报 ACQ.CYCLE_PAY_TOTAL_TIMES_EXCEED#

Q：alipay.user.agreement.transfer(协议由普通通用代扣协议产品转移到周期扣协议产品)接口中普通通用代扣协议产品指的是什么？#