花呗分期商家接入说明

更新时间：2017-10-26

商户在花呗准入的前提下，才能够使用花呗分期进行收款，准入后有以下两种可选方式。
方式一：支付宝标准收银台展示花呗分期渠道（仅用户承担手续费），无需额外签约花呗分期。
方式二：花呗分期单通道（可选用户或商户承担手续费），需要签约并开发相应接口来实现。商家无需签约即可实现用户付费情况下使用花呗分期，无需开发；如签约花呗分期，并按照下文的介绍进行开发并接入，可实现商家付费及用户付费两种可选模式。

产品接口及文档

若您使用的是老版本的接口，请参考如下老版本接口花呗分期参数。

注：老wap支付接口(alipay.wap.trade.create.direct)不支持开通花呗分期支付渠道。

支付接入说明

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.如果是虚拟商品交易，为防止用户使用花呗分期套现，需要禁止使用花呗分期。如果商家在虚拟商品交易中使用花呗分期支付，一经发现关闭花呗分期权限。禁用花呗分期方法：

1. 传入参数goods_type=0，表示虚拟交易，花呗和花呗分期将不会出现在支付宝收银台供用户选择；
2. 可在交易中通过传参禁用花呗分期渠道，具体方法：在收单接口中传入参数disable_pay_channels=pcreditpayInstallment，花呗和花呗分期将不会出现在支付宝收银台供用户选择。

如果是实物交易，请传goods_type=1。花呗分期虚实分离适用的3个产品：PC即时到账（电脑网站支付）新老接口、手机App支付新老接口、手机网站支付新老接口。

7.如果是用户在支付宝收银台选的花呗分期，花呗分期手续费100%由用户承担。如下图。

退款说明

1. 商家退款后，款项原路退回到花呗账户。退款周期在签约时约定，默认3个月。
2. 花呗分期的退款方法和普通支付宝支付相同，详见收单产品（即时到账、App支付、手机网站支付、当面付）接口文档中的退款接口。
3. 发生退款时，资金由商户收款账户退至花呗分期账户，花呗根据用户还款情况，将退款金额做提前还款处理。
4. 分期手续费退费规则：
   • 商户承担手续费，自交易发生后15天内发生退款花呗全额退手续费，15天后不退手续费。
   • 用户已经支付的手续费一概不退，未支付的手续费，如果已经出了账单则不能减免，未出账单的，根据退款金额按比例减免。
5. 用户发起退款，相应的退款资金进入花呗分期放款账户，然后冲抵用户该笔交易的账单。冲抵顺序：先冲抵用户已经出账的账单，出账账单冲抵完成后再从该笔交易的最后一期账单向前冲抵，如仍有多余金额则进入用户支付宝余额。

对账说明

可登录支付宝企业版后台下载对账单，花呗分期与普通支付宝收单交易在同一张对账单中。