花呗分期接入说明

接入方式

商户在花呗准入的前提下，才能够使用花呗分期进行收款，准入后有以下两种可选方式。

l   支付宝标准收银台展示花呗分期渠道（仅用户承担手续费），无需额外签约花呗分期。

 

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

集成指南

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