花呗分期接入说明

前提：

商户必须已经是花呗分期的准入状态且已经签约了花呗分期资金通道的前提下，才能够使用花呗分期进行收款，准入后有以下两种可选方式。手机APP如果以上两个均确认已经完成但仍不支持花呗分期业务，联系支付宝技术支持查询手机APP签约是否是V4，如若不是，请先升级至V4；

接入方式:

花呗分期单通道（可选用户或商户承担手续费），需要签约并开发相应接口来实现。商家无需签约即可实现用户付费情况下使用花呗分期，无需开发；如签约花呗分期，并按照下文的介绍进行开发并接入，可实现商家付费及用户付费两种可选模式。

集成指南：

商户pid的获取

该产品是在原签约的支付产品的基础上进行的签约变更，故延用原PID。PID的查看方式请参见：https://doc.open.alipay.com/doc2/detail?treeId=58&articleId=103544&docType=1

秘钥的生产和上传

如上所述，该产品和原支付产品使用相同的PID，故无需重新对密钥进行配置，可直接使用原支付产品的密钥。

RSA商户公钥与支付宝公钥的查看方法：https://doc.open.alipay.com/doc2/detail.htm?spm=a219a.7629140.0.0.p7Gld8&treeId=58&articleId=103546&docType=1

MD5（Key）查看方法：https://doc.open.alipay.com/doc2/detail.htm?spm=a219a.7629140.0.0.mS4enu&treeId=58&articleId=103545&docType=1

 

产品接口及文档

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

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

支付接入说明

1.      订单结算页和商品详情页（可选）增加花呗分期渠道展示（支付宝提供logo矢量图，详情见“资源下载”），将标准收银台的支付宝支付和花呗分期渠道的支付宝支付并列展示。

l  如果用户在商户订单结算页选择非分期支付宝支付，则跳转至标准收银台（不包含花呗分期渠道）；

l  如果用户选择了花呗分期渠道，则跳转至花呗分期收银台（若由于额度不足或不准入等原因无法使用花呗分期，可在支付宝域内直接选择其他支付方式）。

详细使用场景请参考“应用案例”。

2.      选择花呗分期支付时，带上花呗分期的期数和承担手续费比例，请求相应渠道的收单接口（格式参见“产品接口及文档”）。

l  参数hb_fq_num指定可选期数，包括3/6/12期的，还款期数越长手续费越高（注：该期数是在签约时约定好的，不可指定未约定的期数，否则调接口时报错）。

l  参数hb_fq_seller_percent指定手续费承担方式，手续费可以由用户全承担（该值为0），也可以商户全承担（该值为100），但不可以共同承担，即不可取0和100外的其他值。

3.      每期支付费用＝手续费和费用的总和/分期数，具体计算方法请参考买家分期费用计算规则。

4.      需要注意如果需要修改分期参数，请务必使用新的外部订单号。若在同一个交易中，第一次请求参数分N期，且用户已经进入支付宝收银台生成交易后，用相同的订单号再次请求参数分M期。则跳转到花呗分期收银台后还是显示N期，金额也是N期的金额，继续支付会报错。

5.      测试时注意使用的买家账号需要在支付宝钱包内开通“花呗”支付，否则测试会报错。

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

l  传入参数goods_type=0，表示虚拟交易，花呗和花呗分期将不会出现在支付宝收银台供用户选择；

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

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

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

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

退款说明

1.     商家退款后，款项原路退回到花呗账户。退款周期在签约时约定，默认3个月。

2.     花呗分期的退款方法和普通支付宝支付相同，详见收单产品（即时到账、App支付、手机网站支付、当面付）接口文档中的退款接口。

3.     发生退款时，资金由商户收款账户退至花呗分期账户，花呗根据用户还款情况，将退款金额做提前还款处理。

4.     分期手续费退费规则：

a)     商户承担手续费，自交易发生后15天内发生退款花呗全额退手续费，15天后不退手续费。

b)    用户已经支付的手续费一概不退，未支付的手续费，如果已经出了账单则不能减免，未出账单的，根据退款金额按比例减免。

5.     用户发起退款，相应的退款资金进入花呗分期放款账户，然后冲抵用户该笔交易的账单。冲抵顺序：先冲抵用户已经出账的账单，出账账单冲抵完成后再从该笔交易的最后一期账单向前冲抵，如仍有多余金额则进入用户支付宝余额。