商家接入指引
商户在满足花呗准入的前提下，才能够使用花呗分期进行收款，准入后有以下两种可选方式：
-
支付宝标准收银台展示花呗分期渠道（仅用户承担手续费），无需额外签约花呗分期。
-
花呗分期单通道（可选用户或商户承担手续费），需要签约并开发相应接口来实现。
商家无需签约即可实现用户付费情况下使用花呗分期，无需开发；如签约花呗分期，并按照下文的介绍进行开发并接入，可实现商家付费及用户付费两种可选模式。
| 支付场景 | 接口 | 花呗分期相关参数 | |
|---|---|---|---|
| 手机网站支付 | 手机网站支付接口alipay.trade.wap.pay | 花呗分期参数传入到extend_params中，格式如下："extend_params":{"hb_fq_num":"3","hb_fq_seller_percent":"100"}* hb_fq_num代表花呗分期数，仅支持传入3、6、12，其他期数暂不支持，传入会报错； |
* hb_fq_seller_percent代表卖家承担收费比例，商家承担手续费传入100，用户承担手续费传入0，仅支持传入100、0两种，其他比例暂不支持，传入会报错。
手机网站支付、手机APP支付、电脑网站支付若需要使用花呗分期单通道有两种方式：
方式一：不需要额外签约花呗分期的模式。接口与常规支付宝收单接口保持一致，只需在传参时控制可用支付渠道，传入 enable_pay_channels=pcreditpayInstallment；
方式二：需要额外签约花呗分期的模式。接口与常规支付宝收单接口保持一致，只需在传参时按以上格式传入花呗分期相关参数即可。
前端效果请见应用案例-APP端分期、应用案例-PC网站分期。 |
| | 手机App支付 | App支付接口alipay.trade.app.pay | |
| | 线下当面付 | 统一收单交易支付接口alipay.trade.pay | |
| | | 统一收单线下交易预创建接口alipay.trade.precreate | |
| | 电脑网站支付 | 统一收单下单并支付页面接口alipay.trade.page.pay | |
若您使用的是老版本的接口，请参考如下老版本接口花呗分期参数。
| 支付场景 | 接口 | 花呗分期相关参数 |
|---|---|---|
| PC端支付 | 即时到账交易接口create_direct_pay_by_user | 传入参数hb_fq_param=hb_fq_seller_percent^100 |
* hb_fq_seller_percent：商家承担手续费传入100，用户承担手续费传入0。
|
| 手机网站支付 | 老版本手机网站支付接口alipay.wap.create.direct.pay.by.user | 传入参数hb_fq_param={"hb_fq_num":"3","hb_fq_seller_percent":"100"}* hb_fq_num：代表花呗分期数；
* hb_fq_seller_percent：商家承担手续费传入100，用户承担手续费传入0。
|
| 手机App支付 | 老版本移动支付接口mobile.securitypay.pay | |
支付接入说明
1.订单结算页和商品详情页（可选）增加花呗分期渠道展示（支付宝提供logo矢量图，点击下载花呗品牌资源），将标准收银台的支付宝支付和花呗分期渠道的支付宝支付并列展示。
-
如果用户在商户订单结算页选择非分期支付宝支付，则跳转至标准收银台（不包含花呗分期渠道）；
-
如果用户选择了花呗分期渠道，则跳转至花呗分期收银台（若由于额度不足或不准入等原因无法使用花呗分期，可在支付宝域内直接选择其他支付方式）。
详细使用场景请参考“应用案例”。
2.选择花呗分期支付时，带上花呗分期的期数和承担手续费比例，请求相应渠道的收单接口（格式参见“产品接口及文档”）。
-
参数 hb_fq_num 指定可选期数，包括3/6/12期的，还款期数越长手续费越高（注：该期数是在签约时约定好的，不可指定未约定的期数，否则调接口时报错）。
-
参数 hb_fq_seller_percent 指定手续费承担方式，手续费可以由用户全承担（该值为0），也可以商户全承担（该值为100），但不可以共同承担，即不可取0和100外的其他值。
3.每期支付费用＝手续费和费用的总和/分期数，具体计算方法请参考买家分期费用计算规则。
4.需要注意如果需要修改分期参数，请务必使用新的外部订单号。若在同一个交易中，第一次请求参数分N期，且用户已经进入支付宝收银台生成交易后，用相同的订单号再次请求参数分M期。则跳转到花呗分期收银台后还是显示N期，金额也是N期的金额，继续支付会报错。
5.测试时注意使用的买家账号需要在支付宝钱包内开通“花呗”支付，否则测试会报错。
6.如果是虚拟商品交易，为防止用户使用花呗分期套现，需要禁止使用花呗分期。如果商家在虚拟商品交易中使用花呗分期支付，一经发现关闭花呗分期权限。禁用花呗分期方法：
-
传入参数 goods_type=0，表示虚拟交易，花呗和花呗分期将不会出现在支付宝收银台供用户选择；
-
可在交易中通过传参禁用花呗分期渠道，具体方法：在收单接口中传入参数 disable_pay_channels=pcreditpayInstallment，花呗和花呗分期将不会出现在支付宝收银台供用户选择。
如果是实物交易，请传 goods_type=1。花呗分期虚实分离适用的3个产品：PC即时到账（电脑网站支付）新老接口、手机App支付新老接口、手机网站支付新老接口。
7.如果是用户在支付宝收银台选的花呗分期，花呗分期手续费100%由用户承担。如下图。
退款说明
-
商家退款后，款项原路退回到花呗账户。退款周期在签约时约定，默认3个月。
-
花呗分期的退款方法和普通支付宝支付相同，详见收单产品（即时到账、App支付、手机网站支付、当面付）接口文档中的退款接口。
-
发生退款时，资金由商户收款账户退至花呗分期账户，花呗根据用户还款情况，将退款金额做提前还款处理。
-
分期手续费退费规则：
-
商户承担手续费，自交易发生后15天内发生退款花呗全额退手续费，15天后不退手续费。
-
用户已经支付的手续费一概不退，未支付的手续费，如果已经出了账单则不能减免，未出账单的，根据退款金额按比例减免。
- 用户发起退款，相应的退款资金进入花呗分期放款账户，然后冲抵用户该笔交易的账单。冲抵顺序：先冲抵用户已经出账的账单，出账账单冲抵完成后再从该笔交易的最后一期账单向前冲抵，如仍有多余金额则进入用户支付宝余额。
对账说明
可登录支付宝企业版后台下载对账单，花呗分期与普通支付宝收单交易在同一张对账单中。
安全说明
支付宝不允许花呗套现，如发现套现行为，参与套现的用户的花呗及花呗分期支付渠道将做关闭处理。同时，支付宝针对套现行为，为平台类商家花呗防套现给出以下建议：
-
接入 RiskGo 服务，花呗安全团队将通过 RiskGo 渠道向平台商家输出疑似套现订单信息；平台商需对交易进行拦截，风险店铺进行处罚关闭，并反馈处理结果。点击查看 RiskGo 产品接入指引。
-
提前对平台商品类型做好虚实分离，实物商品和虚拟商品使用不同的支付宝账户进行收款，或者通过商品名称进行虚拟和实物标注，助于反套现策略防控，降低正常交易打扰情况。
虚实分离的实现方式：在接口请求参数中传入 goods_type 参数，参数值为0代表虚拟类商品，支付宝会禁用花呗渠道；参数值为1代表实物类商品，支付宝会打开花呗渠道。虚实分离的产品支持情况，以及参数的具体使用方法，请详见各产品的请求参数列表。
