本文为商家提供花呗分期接入指引。商家在满足 [@花呗分期产品介绍(repo#00phph#2142ce6a#01ug51)](/repo#00phph#2142ce6a#01ug51)-**准入条件** 的前提下，才能够使用花呗分期进行收款，准入后有以下两种可选方式：

- 支付宝标准收银台展示花呗分期渠道（仅用户承担手续费），无需额外开通花呗分期，仅需设置传入请求参数 enable_pay_channels，详情可查看 [@接口说明(repo#00phph#fe259713#01ug57)](/repo#00phph#fe259713#01ug57)。
- 花呗分期单通道（可选用户或商家承担手续费），需要开通并开发相应接口来实现，详情查看 [@接口说明(repo#00phph#fe259713#01ug57)](/repo#00phph#fe259713#01ug57)。

商家无需开通即可实现用户付费情况下使用花呗分期；如开通花呗分期，并按照下文的介绍进行开发并接入，可选择商家付费及用户付费两种模式。<br />**说明**：直连商户最低起分金额 1 元，间连商户最低起分金额 100 元。<br />商家在接入花呗分期时如有问题，请拨打商家服务电话：4007585858。<br />**注意：**本接入指引适用于在开放平台创建应用的商家或服务商（直连商家），通过银联、网联渠道接入支付宝收单能力的商家或者服务商（间连商家）请查看 [间连商家接入指引](https://gw.alipayobjects.com/os/bmw-prod/936d185f-6fda-4369-b0a0-34c5e7dfe7e3.pdf)。
<a name="HPnqp"></a>
# 接入流程
<a name="ZnwoO"></a>
## 签署支付宝收单
商家收银台需接入支付宝，支持支付宝收款；商家需签署支付宝收单协议中的当面付、APP 支付、电脑网站支付、手机网站支付。商家登录 [商家平台](https://b.alipay.com/signing/productSet.htm?navKey=all) 后在 **产品中心** 页签署收单协议，如下图所示：![](https://gw.alipayobjects.com/os/skylark-tools/public/files/155c16acc054726cd74063300759ec06.0000706425469#height=784&id=M186H&originHeight=784&originWidth=1350&originalType=binary&ratio=1&rotation=0&showTitle=false&status=done&style=stroke&title=&width=1350)<br />以上产品的接入指南请查看：

- [当面付接入指南](https://opendocs.alipay.com/open/194/106039)
- [APP支付接入指南](https://opendocs.alipay.com/open/204/105297)
- [电脑网站支付接入指南](https://opendocs.alipay.com/open/270/105899)
- [手机网站支付接入指南](https://opendocs.alipay.com/open/203/107084)
- [小程序JSAPI支付接入指南](https://opendocs.alipay.com/mini/05x9ku?pathHash=a7b61cca)
<a name="UsHAk"></a>
## 支付宝账号花呗准入
商家的支付宝账号需完成花呗准入，即商家支持用户以花呗、花呗分期向该商家账号付款。商家在满足花呗准入条件后，就可以顺利 [接入花呗](https://b.alipay.com/signing/productDetail.htm?productId=J1010300191000001000)。商家点击页面下方的** 立即接入 **后（如下图所示），系统将检查支付宝账号是否准入；如果暂时不准入，商家可以先将支付宝交易额做到一定规模后再来检查。
![](https://gw.alipayobjects.com/os/skylark-tools/public/files/63ea34a83c533d5593d2a310763e7536.png%26originHeight%3D892%26originWidth%3D1491%26size%3D63551%26status%3Ddone%26width%3D746#height=892&id=PcNBm&originHeight=892&originWidth=1491&originalType=binary&ratio=1&rotation=0&showTitle=false&status=done&style=stroke&title=&width=1491)<a name="pJmKi"></a>
## 签署花呗分期手续费协议
在接入花呗后，商家还需签署该协议，才能接通花呗分期单通道和具备贴息能力。<br />**说明：**签署该协议，不意味着立刻产生分期费用。只有在商家签署了该协议、设置了分期免息商品、完成了分期免息交易后，才会产生分期手续费。
<a name="eNKCg"></a>
## 商家接入花呗分期单通道
花呗分期单通道模式，是指商家在自己的收银台将花呗分期资金渠道与支付宝并列，支持用户选择花呗分期的某期数购买，并将分期方案带至支付宝收银台。目前手机网站支付、手机 APP 支付、电脑网站支付产品支持花呗分期单通道。商家在接入单通道过程中需要开通花呗分期，接口与常规支付宝收单接口保持一致，只需在传参时按照格式传入花呗分期相关参数（如 hb_fq_param 和 extend_params 等）即可。 在接入过程中遇到的花呗分期参数问题可以查看 [@接口说明(repo#00phph#fe259713#01ug57)](/repo#00phph#fe259713#01ug57)；前端效果可查看 [@应用案例-APP端分期(repo#00phph#b391a864#01ug5b)](/repo#00phph#b391a864#01ug5b)、[@应用案例-PC网站分期(repo#00phph#b1801835#01ug5e)](/repo#00phph#b1801835#01ug5e)。
![](https://gw.alipayobjects.com/os/skylark-tools/public/files/8d14d91377b83b3f6632b8bf043b737c.png%26originHeight%3D567%26originWidth%3D882%26size%3D290606%26status%3Ddone%26width%3D746#height=567&id=GUvEp&originHeight=567&originWidth=882&originalType=binary&ratio=1&rotation=0&showTitle=false&status=done&style=stroke&title=&width=882)<a name="qXPcH"></a>
# 支付接入说明

- 订单结算页和商品详情页（可选）增加花呗分期渠道展示（支付宝提供 logo 矢量图，前往 [@花呗分期付款界面规范(repo#00phph#b0c2f24d#01ug52)](/repo#00phph#b0c2f24d#01ug52)-设计资源下载，下载花呗品牌资源），将标准收银台的支付宝支付和花呗分期渠道的支付宝支付并列展示。详情可查看 [@应用案例(repo#00phph#d3f00abe#01ug54)](/repo#00phph#d3f00abe#01ug54)。
   - 如果用户在商家订单结算页选择非分期支付宝支付，则跳转至标准收银台（不包含花呗分期渠道）。
   - 如果用户选择了花呗分期渠道，则跳转至花呗分期收银台（若由于额度不足或不准入等原因无法使用花呗分期，可在支付宝域内直接选择其它支付方式）。
- 选择花呗分期支付时，带上花呗分期的期数和承担手续费比例，请求相应渠道的收单接口（详情可查看 [@接口说明(repo#00phph#fe259713#01ug57)](/repo#00phph#fe259713#01ug57)）。
   - 参数 hb_fq_num 指定可选期数，包括3/6/12期的，还款期数越长手续费越高（注意：该期数是在开通时约定好的，不可指定未约定的期数，否则调接口时报错）。
   - 参数 hb_fq_seller_percent 指定手续费承担方式，手续费可以由用户全承担（该值为 0），也可以商家全承担（该值为 100），但不可以共同承担，即不可取 0 和 100 外的其它值。
- 每期支付费用＝手续费和费用的总和/分期数，详情可查看 [@花呗分期产品介绍(repo#00phph#2142ce6a#01ug51)](/repo#00phph#2142ce6a#01ug51)-买家分期费用计算规则。
- 如果需要修改分期参数，请务必使用新的外部订单号。若在同一个交易中，第一次请求参数分 N 期，且用户已经进入支付宝收银台生成交易后，用相同的订单号再次请求参数分 M 期。则跳转到花呗分期收银台后还是显示 N 期，金额也是 N 期的金额，继续支付会报错。
- 测试时注意使用的买家账号需要在支付宝客户端内开通 花呗 支付，否则测试会报错。
- 如果是虚拟商品交易，为防止用户使用花呗分期套现，需要禁止使用花呗分期。如果商家在虚拟商品交易中使用花呗分期支付，一经发现关闭花呗分期权限。禁用花呗分期方法：
   - 传入参数 goods_type=0，表示虚拟交易，花呗和花呗分期将不会出现在支付宝收银台供用户选择。
   - 在交易中通过传参禁用花呗分期渠道，具体方法：在收单接口中传入参数 disable_pay_channels=pcreditpayInstallment，花呗和花呗分期将不会出现在支付宝收银台供用户选择。
   - 如果是实物交易，请传 goods_type=1。花呗分期虚实分离适用的 3 个产品：PC 即时到账（电脑网站支付）新老接口、手机 App 支付新老接口、手机网站支付新老接口。
- 如果是用户在支付宝收银台选择花呗分期，花呗分期手续费 100% 由用户承担，如下图所示：![](https://gw.alipayobjects.com/os/skylark-tools/public/files/dba4f65b4499c06e4eeee0684310016d.png%26originHeight%3D2041%26originWidth%3D3628%26size%3D479608%26status%3Ddone%26width%3D746#height=2041&id=i5Ahj&originHeight=2041&originWidth=3628&originalType=binary&ratio=1&rotation=0&showTitle=false&status=done&style=stroke&title=&width=3628)
<a name="yz8dq"></a>
# 退款说明

- 商家退款后，款项原路退回到花呗账号。退款周期在开通时约定，默认 3 个月。
- 花呗分期的退款方法和普通支付宝支付相同，详情可查看收单产品（[电脑网站支付](https://opendocs.alipay.com/open/270/105898)、[App支付](https://opendocs.alipay.com/open/204/105051)、[手机网站支付](https://opendocs.alipay.com/open/203/105288)、[当面付](https://opendocs.alipay.com/open/194/105072)）接口文档中的退款接口。
- 发生退款时，资金由商家收款账号退至花呗分期账号，花呗根据用户还款情况，将退款金额做提前还款处理。
- 分期手续费退费规则：
   - 商家承担手续费，自交易发生后 15 天内发生退款花呗全额退手续费，15天后不退手续费。
   - 用户已经支付的手续费一概不退，未支付的手续费，如果已经出了账单则不能减免，未出账单的，根据退款金额按比例减免。
- 用户发起退款，相应的退款资金进入花呗分期放款账号，然后冲抵用户该笔交易的账单。冲抵顺序：先冲抵用户已经出账的账单，出账账单冲抵完成后再从该笔交易的最后一期账单向前冲抵，如仍有多余金额则进入用户支付宝余额。
<a name="N1r9f"></a>
# 对账说明
可登录移动端支付宝企业版后台下载对账单，花呗分期与普通支付宝收单交易在同一张对账单中。
<a name="FVY5Y"></a>
# 安全说明
支付宝不允许花呗套现，如发现套现行为，参与套现的用户的花呗及花呗分期支付渠道将做关闭处理。同时，支付宝针对套现行为，为平台类商家花呗防套现给出以下建议：
<a name="A2U5x"></a>
## 接入 RiskGo 服务
花呗安全团队将通过 RiskGo 渠道向平台商家输出疑似套现订单信息；平台商需对交易进行拦截，风险店铺进行处罚关闭，并反馈处理结果。详情可查看 [RiskGo 产品接入指引](https://alipay.open.taobao.com/docs/doc.htm?spm=a219a.7629140.0.0.y8uikN&treeId=482&articleId=108425&docType=1)。
<a name="W5oYZ"></a>
## 提前对平台商品类型做好虚实分离
实物商品和虚拟商品使用不同的支付宝账号进行收款，或者通过商品名称进行虚拟和实物标注，助于反套现策略防控，降低正常交易打扰情况。
<a name="Zd5Gb"></a>
### 虚实分离的实现方式
在接口请求参数中传入 goods_type 参数，参数值为 0 代表虚拟类商品，支付宝会禁用花呗渠道；参数值为1代表实物类商品，支付宝会打开花呗渠道。虚实分离的产品支持情况，以及参数的具体使用方法，可查看各产品的请求参数列表。