常见问题 -凯发app官方网站更新时间：2023-12-12 17:19:19文档更新记录 >收藏订阅更新我的文档设置返回文档1 q：同一个商家下，同一个用户可以有多套签约关系吗？a：可以的。通过商家外部签约号和场景参数来区分哪套协议。如果签约时传入了签约号及场景参数，后续查询协议和解约时也必须传入。如遇到显示 开通成功 情况，请检查是否签约字符串固定值未变。2 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（扣款执行时间）期间的费用。3 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引入 及之上版本示例如下：说明：目前只有地铁等少数场景在使用此参数，如无需要不用关注。4 q：alipay.user.agreement.executionplan.modify（周期性扣款协议执行计划修改接口）中的 deduct_time（下一次扣款时间）取值范围是多少？a：扣款失败保持不变，扣款成功往后推1个周期。例：在此例中每个自然月的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。5 q：周期自动扣款代扣失败如何发起重试？a：扣款时间点发起代扣失败，此时下次扣款时间不变，分 2 种情况：●当前时间处于扣款时间段内（提前 5 天 扣款日当天）则直接发起重试，如：约定扣款日为 20 号，支持商家在 15 至 20 号内可直接重试。●当前时间即将超过扣款时间段，可以通过 alipay.user.agreement.executionplan.modify（周期性扣款协议执行计划修改接口）推迟下一次扣款时间继续重试。注意：扣款失败的重试建议执行 2 次（不要无限制重试），如始终扣不到款则停止提供服务。6 q：周期扣款签约有次数限制吗？a：同一个商家下同一个用户同一个场景下最多签约10次。7 q：周期扣款是商家主动发起扣款，还是支付宝发起？a：商家主动发起扣款。签约成功之后后续每次扣款，扣款日（execute_time）前5日商家可使用 alipay.trade.pay（统一收单交易支付接口），完成周期扣款协议后续免密代扣操作。8 q：如何实现每月最后一天扣款？a：把约定日期设置为每月1号，由于可提前5天发起扣款，涵盖了每月最后一天。9 q：如果在规定时间内未完扣款，下一个周期是否可以接着扣？a：默认情况下不可以，扣款失败需要考虑重试或解约停服务，如特殊业务场景需要跳过本期扣款继续征收下一期，可以使用 alipay.user.agreement.executionplan.modify（周期性扣款协议执行计划修改接口）推迟约定日到下一期发起扣款。10 q：支付并签约接口完成支付和签约之后有几条异步？a：有 2 条异步，分别标记支付和签约状态。11 q：支付并签约接口生成的签约页面中【开通xx会员自动续费】的开关逻辑是什么？a：正常状态下，打开表示支付并签约，关闭表示只支付不签约。 12 q：周期扣款额度限制？a：对每个用户的单笔扣款不超过 100 元，当日扣款不超过 1000 元，当月扣款不超过 30000 元；扣款周期最短为 7 天，最长没有限制。注意：一个协议内每次周期扣款只能扣一次，不可多次扣款。如果周期扣款额度大于100元，建议核实 支付宝预授权 是否可使用且满足业务需求，周期时间为商家自己设置扣款，在自己周期扣款时间内，调用授权转支付接口进行扣款。 13 q：周期扣款如何设置personal_product_code（签约个人产品码）？a：周期扣款 personal_product_code（签约个人产品码）：cycle_pay_auth_p（周期扣款个人签约产品码）注意：product_code（销售产品码）：cycle_pay_auth，相较于 personal_product_code 少了末尾 p。 14 q：周期扣款如何解约？a：●商家通过 alipay.user.agreement.unsign（支付宝个人代扣协议解约接口）进行解约操作。●用户在支付宝客户端内进行解约操作。支付宝客户端的解约入口：在支付宝客户端内 我的 > 设置 > 支付设置 > 免密支付/自动扣款 下找到对应的商家服务。 15 q：周期扣款签约有效期是多久？a：周期扣款签约支持设置 sign_validity_period（用户签约请求的协议有效周期）。●商家若签约设置 sign_validity_period 参数，签约时间以设置时间为准。●商家若签约未设置 sign_validity_period 参数，默认签约时间为长期有效。16 q：如何修改周期扣款签约页面文案？a：详情请查看 如何修改周期扣款签约页面文案。17 q：周期扣款支持什么应用场景 ？a：详情请查看 周期扣款支持什么应用场景。18 q：周期扣款如何设置异步通知？a：详情请查看 周期扣款如何设置异步通知。19 q：周期扣款支付后签约页面文案扣款周期小于7天说明？a：详情请查看 周期扣款支付后签约页面文案扣款周期小于7天说明。20 q：如何处理周期扣款失败？a：详情请查看 如何处理周期扣款失败。21 q：alipay.user.agreement.page.sign（支付宝个人协议页面签约接口）中的 sign_scene（签约协议场景）填写方式a：可查看 代扣产品常见场景值。22 q：调用 alipay.trade.pay（统一收单交易支付接口）报 acq.cycle_pay_date_not_matcha：请重新检查扣款日期，在符合约定的日期发起扣款。对于周期扣款产品，签约时会约定扣款的周期。如果发起扣款的日期不符合约定的周期，则不允许扣款。注意：目前允许商家在约定日期之前5天（含扣款日当天）开始扣款，即比起严格限制到某一天稍微留有余地。23 q：调用 alipay.trade.pay（统一收单交易支付接口）报 acq.cycle_pay_single_fee_exceeda：请在允许的金额范围内扣款。对于周期扣款产品，签约时会约定单笔扣款的最大金额。如果发起扣款的金额大于约定上限，则不允许扣款。24 q：调用 alipay.trade.pay（统一收单交易支付接口）报 acq.cycle_pay_total_fee_exceeda：请在允许的金额范围内扣款。对于周期扣款产品，签约时可以约定多次扣款的累计金额限制。如果发起扣款的累计金额大于约定上限，则不允许扣款。25 q：调用 alipay.trade.pay（统一收单交易支付接口）报 acq.cycle_pay_total_times_exceeda：请在允许的次数范围内扣款。对于周期扣款产品，签约时可以约定总扣款次数限制。如果发起扣款的累计次数大于约定上限，则不允许扣款。26 q：alipay.user.agreement.transfer (协议由普通通用代扣协议产品转移到周期扣协议产品)接口中普通通用代扣协议产品指的是什么？a：普通通用代扣协议产品是名称为通用代扣的代扣产品，详情可联系 支付宝业务人员 或联系商家客服 4007585858（8:00-24:00）申请相应行业的支付宝业务人员协助。
