代扣规则

芝麻 GO目前支持 固定间隔时间扣款。

接入周期性代扣功能前，请先联系支付宝业务人员在芝麻 GO 模板中正确配置代扣规则。主要配置项说明如下：

固定间隔时间扣款。

扣款时间：固定周期扣款，每期 X 天。

豁免期：首期生效。如上图所求，从签约成功开始算 1 天以内，芝麻 GO 关闭退出，最终 0 元结算。

结算超期时间：每一期可扣款的时长。超期后，芝麻 GO 会自动退出并发送扣款失败消息通知商户。

扣款期数：周期扣的总共可扣款期数。

每期扣款金额：实际用户每期扣款金额，单位：元。

每期原价：每期扣款的原价，单位：元。

高级模式中，可自定义每期扣款金额。

发起周期代扣

周期代扣由商家根据自身业务特点，自行选择时机调用 zhima.credit.pe.zmgo.settle.apply（芝麻GO结算申请接口）发起周期代扣。

商家发起周期扣结算申请受理成功后，商家只需等待结算成功消息，无需重复发起再次结算申请，否则商家要重复发起，直到该接口返回受理成功结果。

每期结算时间超过结算超时时间时，芝麻 GO 侧会关闭当前的周期扣扣款计划，并自动触发芝麻 GO 协议退出。

参数说明

具体请求参数、响应参数、错误码可查看 zhima.credit.pe.zmgo.settle.apply（芝麻GO结算申请接口）文档。发起请求后，重试请求，请不要替换 pay_amount（金额）及 out_request_no（外部请求号），其中 withhold_plan_no 为必填项。

首期扣款参数来源于签约成功消息 zhima.credit.pe.zmgo.sign.notify，详情可查看下文 代扣结果通知。

pay_amount=actual_price

withhold_plan_no=withhold_plan_no

商户发起的结算申请时间planned_trigger_time~time_out_time。无法提前发起，也不能超过这个时间。

如果用户在 exemption_end_time 这个时间之前发起退出，那后续发起芝麻GO结算时，传入金额必须为0。exemption_end_time为豁免期。

后续期数参数来源于 zhima.credit.pe.zmgo.settle.notify，详见下文代扣结果通知。

pay_amount=next_actual_price

withhold_plan_no=next_withhold_plan_no

商户发起的结算申请时间 next_planned_trigger_time~next_time_out_time。无法提前发起，也不能超过这个时间。

代扣结果通知

每一期代扣完成后，支付宝端会调用 zhima.credit.pe.zmgo.settle.notify（芝麻GO业务结算变更商户通知接口）把代扣金额、支付宝交易号等信息汇总，发送一个代扣成功消息发送给商家。

注意：

withhold_biz_type = ZMGO_CYCLE_WITHHOLD_DEDUCT 识别当前消息是否为周期扣扣款结果通知。

若代扣成功，支付宝将立刻发送成功通知给到商户。

若代扣失败，支付宝将自动进行重试，超过超时时间后，本次扣款交易将关闭，同时触发芝麻GO协议关闭，并发送失败通知给商户。

消息示例

ISV_GATEWAY_URL?charset=GBK&biz_content=
{
"withhold_plan_no":"ZMGO_WHD2021010910020603000000006002","trade_no":"20201212203423423420210110014004","agreement_id":"ZMGO_AGR2021012910020604010000000001","agreement_status":"Y","out_request_no":"63c0efbf3c62cf03ede783257ed66de8","rest_freeze_amount":"100.00","pay_amount":"100.00","alipay_user_id":"2088101117955611","partner_id":"2088101117955612","biz_time":"2021-01-29 11:35:59","pay_aisle_data":"API","trans_status":"Y","biz_type":"EASY_MEMBER","product_version":"zhimGoV2"
}
&msg_method=zhima.credit.pe.zmgo.settle.notify&utc_timestamp=1516797622752&version=1.1&sign_type=RSA2&notify_id=d275fec564e62af6bedbcee73f3f05fi5x&app_id=2013121700999429&sign=I+Y/lvqYUEEc10EPdpntRhFIQ==

消息属性

可查看 zhima.credit.pe.zmgo.settle.notify（芝麻GO业务结算变更商户通知接口）文档。

响应参数

响应值	描述	是否重试
fail	消息获取失败	重试
success	消息获取成功	不重试

**注意：**代扣成功通知和结算成功通知共用一个消息通知方法，同时通过 cycle_withhold 字段区分是结算成功通知还是代扣成功通知。

cycle_withhold=Y 表示周期扣代扣成功通知

cycle_withhold=N 表示结算成功通知。

周期代扣

代扣规则#

发起周期代扣#

参数说明#

代扣结果通知#

﻿消息示例#

消息属性#