# 商家扣款产品接入目录 ## 产品简介 商家扣款是商家引导用户进行签约授权，签约成功后商家根据签约协议号，再主动调接口完成扣款的支付产品，支持周期性的扣款模式。
**核心特性**： - 费率：单笔收费 0.6% - 1% - 结算：实时到账（新签约商家有90日或连续交易30日的结算周期限制） - 退款：默认交易发生后12个月内可退款，退款资金原路退还，退款时手续费一并退还 - 支付工具：支付宝余额、银行卡(储蓄卡和信用卡)、花呗等 **典型场景**： - 会员包月 - 租赁费用 - 定期还款 - 充值缴费 **产品特征**： - 固定周期、固定金额范围、被动扣款 - 一个用户在同商家同场景码下最多可签约1次 - 单个商家对单个协议的扣款限额为单笔限额100元 **使用说明**： - 扣款不可在夜间执行，需于北京时间7:00～22:00期间发起扣款 - 支付并签约模式下，优惠后的金额不得低于正价的1/3 - 两次扣款时间间隔建议不小于30天 - 支持移动设备、PC、小程序交易场景 - product_code固定传参：GENERAL_WITHHOLDING --- ## 文档目录与路由表 ### 一、产品介绍 | 主题 | 文档链接 | 核心内容 | | --- | --- | --- | | 产品特色 | [产品介绍](https://ideservice.alipay.com/cms/site/0j06gs) | 产品概述、典型场景、准入条件、费率 | | 接入准备 | [接入准备](https://ideservice.alipay.com/cms/site/0j02ep) | 创建应用、配置应用、开通产品 | | 常见问题 | [常见问题](https://ideservice.alipay.com/cms/site/0j01kh) | 签约扣款问题解答 | ### 二、接入指南 | 主题 | 文档链接 | 核心内容 | | --- | --- | --- | | 支付并签约场景 | [快速接入](https://ideservice.alipay.com/cms/site/0j06gv) | 从商家APP/小程序/PC端发起流程 | | SDK&DEMO | [SDK获取](https://ideservice.alipay.com/cms/site/0j08a9) | SDK下载 | | 异步通知说明 | [异步通知](https://ideservice.alipay.com/cms/site/0j02er) | 异步通知参数、验签流程 | ### 三、相关资料 | 主题 | 文档链接 | 核心内容 | | --- | --- | --- | | 支付界面规范 | [界面规范](https://ideservice.alipay.com/cms/site/0j06gw) | 支付界面设计规范 | | 常见场景码值 | [场景码](https://ideservice.alipay.com/cms/site/0j06gx) | 业务场景码说明 | | Universal Links配置 | [配置说明](https://ideservice.alipay.com/cms/site/0f5100) | iOS配置 | ### 四、API接口列表 #### 签约接口 | 接口名称 | 接口英文名 | 文档链接 | 用途 | | --- | --- | --- | --- | | 小程序独立签约接口 | alipay.user.agreement.page.sign | [接口文档](https://ideservice.alipay.com/cms/site/0j092a) | 小程序签约 | | 支付宝个人协议页面签约接口 | alipay.user.agreement.page.sign | [接口文档](https://ideservice.alipay.com/cms/site/0j01kk) | 页面签约 | | 支付宝个人代扣协议查询接口 | alipay.user.agreement.query | [接口文档](https://ideservice.alipay.com/cms/site/0j01kl) | 查询签约状态 | | 支付宝个人代扣协议解约接口 | alipay.user.agreement.unsign | [接口文档](https://ideservice.alipay.com/cms/site/0j06h0) | 解除签约 | | 周期性扣款协议执行计划修改接口 | alipay.user.agreement.executionplan.modify | [接口文档](https://ideservice.alipay.com/cms/site/0j06h1) | 修改扣款计划 | #### 支付接口 | 接口名称 | 接口英文名 | 文档链接 | 用途 | | --- | --- | --- | --- | | app支付接口2.0 | alipay.trade.app.pay | [接口文档](https://ideservice.alipay.com/cms/site/0j092b) | 支付并签约 | | 统一收单交易支付接口 | alipay.trade.pay | [接口文档](https://ideservice.alipay.com/cms/site/0j06h2) | 发起扣款 | | 统一收单交易查询接口 | alipay.trade.query | [接口文档](https://ideservice.alipay.com/cms/site/0j0a27) | 查询交易状态 | | 统一收单交易退款接口 | alipay.trade.refund | [接口文档](https://ideservice.alipay.com/cms/site/0j02es) | 发起退款 | | 统一收单交易关闭接口 | alipay.trade.close | [接口文档](https://ideservice.alipay.com/cms/site/0j02et) | 关闭订单 | | 统一收单交易撤销接口 | alipay.trade.cancel | [接口文档](https://ideservice.alipay.com/cms/site/0j01kn) | 撤销交易 | --- ## 核心接入流程 > 📖 详见：[支付并签约场景](https://ideservice.alipay.com/cms/site/0j06gv) **关键流程说明**： 1. 用户在支付流程中，同时完成支付和签约（支付并签约场景） 2. 签约生效后，商家按照协议中的时间进行扣款 3. 支持从商家APP、支付宝小程序、PC端网页发起 --- ## 开发者核心关注要点 | 关注点 | 说明 | 文档链接 | | --- | --- | --- | | 扣款时间限制 | 仅允许北京时间7:00～22:00期间发起扣款 | [产品介绍](https://ideservice.alipay.com/cms/site/0j06gs) | | 优惠金额限制 | 优惠后的金额不得低于正价的1/3，否则续费扣款失败 | [产品介绍](https://ideservice.alipay.com/cms/site/0j06gs) | | 扣款时间间隔 | 两次扣款时间间隔建议不小于30天 | [产品介绍](https://ideservice.alipay.com/cms/site/0j06gs) | | product_code | 接口中固定传参：GENERAL_WITHHOLDING | [快速接入](https://ideservice.alipay.com/cms/site/0j06gv) | | personal_product_code | 周期扣款模式固定传参：CYCLE_PAY_AUTH_P | [快速接入](https://ideservice.alipay.com/cms/site/0j06gv) | | 场景码设置 | 需与支付宝BD确认新增模版及场景码 | [产品介绍](https://ideservice.alipay.com/cms/site/0j06gs) | | 周期类型限制 | period_type为DAY时，period不允许小于7天 | [快速接入](https://ideservice.alipay.com/cms/site/0j06gv) | | 异步通知分离 | 支付成功和签约成功分别发送到notify_url和sign_notify_url | [快速接入](https://ideservice.alipay.com/cms/site/0j06gv) | | 扣款模式 | 需设置async_type=NORMAL_ASYNC，timeout_express最小单位为天 | [快速接入](https://ideservice.alipay.com/cms/site/0j06gv) | | 扣款执行流程 | 先发送扣款预通知，24小时后自动发起扣款，默认持续7天 | [快速接入](https://ideservice.alipay.com/cms/site/0j06gv) | | 扣款时间计算 | 可扣款时间=支付成功时间+扣款周期前48小时 | [快速接入](https://ideservice.alipay.com/cms/site/0j06gv) | | 沙箱支持 | 商家扣款支付功能暂不支持沙箱调试 | [快速接入](https://ideservice.alipay.com/cms/site/0j06gv) | | 用户解约 | 用户可在支付宝客户端主动解约，解约通知默认GBK编码 | [快速接入](https://ideservice.alipay.com/cms/site/0j06gv) | --- ## SDK配置 | 配置模式 | 适用场景 | 文档链接 | | --- | --- | --- | | 公钥模式 | 普通接口调用 | [接入准备](https://ideservice.alipay.com/cms/site/0j02ep) | | 公钥证书模式 | 涉及资金支出接口（必选） | [接入准备](https://ideservice.alipay.com/cms/site/0j02ep) | > 📖 Demo下载：[SDK&DEMO](https://ideservice.alipay.com/cms/site/0j08a9) --- ## 沙箱环境 | 配置项 | 值 | | --- | --- | | 沙箱支持 | 商家扣款暂不支持沙箱调试 | | 生产网关 | [https://openapi.alipay.com/gateway.do](https://openapi.alipay.com/gateway.do) | --- ## 相关链接 | 名称 | 链接 | | --- | --- | | 支付宝开放平台 | [https://open.alipay.com/](https://open.alipay.com/) | | 商家平台 | [https://b.alipay.com/](https://b.alipay.com/) | | 产品开通情况查询 | [https://mrchportalweb.alipay.com/dynlink/productSign/signManage.htm](https://mrchportalweb.alipay.com/dynlink/productSign/signManage.htm) | | 商家扣款产品开通 | [https://b.alipay.com/page/product-mall/product-detail/I1080300001000065325](https://b.alipay.com/page/product-mall/product-detail/I1080300001000065325) |