开放平台
花呗分期支付渠道需签约后才能使用，点此签约。
产品接口及文档
| 支付场景 |
接口 |
花呗分期相关参数 |
|---|---|---|
| 手机网站支付 |
手机网站支付接口alipay.trade.wap.pay |
花呗分期参数传入到extend_params中，格式如下："extend_params":{"hb_fq_num":"3","hb_fq_seller_percent":"100"}
|
| 手机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_num^3
|
| 手机网站支付 |
老版本手机网站支付接口alipay.wap.create.direct.pay.by.user |
传入参数hb_fq_param={"hb_fq_num":"3","hb_fq_seller_percent":"100"}
|
| 手机App支付 |
老版本移动支付接口mobile.securitypay.pay |
注：老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. 如果是虚拟商品交易，为防止用户使用花呗分期套现，需要禁止使用花呗分期。如果商家在虚拟商品交易中使用花呗分期支付，一经发现关闭花呗分期权限。
禁用花呗分期方法：
- 传入参数goods_type=0，表示虚拟交易，花呗和花呗分期将不会出现在支付宝收银台供用户选择；
- 可在交易中通过传参禁用花呗分期渠道，具体方法：在收单接口中传入参数disable_pay_channels=pcreditpayInstallment，花呗和花呗分期将不会出现在支付宝收银台供用户选择。
如果是实物交易，请传goods_type=1。
花呗分期虚实分离适用的3个产品：PC即时到账（电脑网站支付）新老接口、手机App支付新老接口、手机网站支付新老接口。
7. 如果是用户在支付宝收银台选的花呗分期，花呗分期手续费100%由用户承担。如下图。
退款说明
1. 商家退款后，款项原路退回到花呗账户。退款周期在签约时约定，默认3个月。
2. 花呗分期的退款方法和普通支付宝支付相同，详见收单产品（即时到账、App支付、手机网站支付、当面付）接口文档中的退款接口。
3. 发生退款时，资金由商户收款账户退至花呗分期账户，花呗根据用户还款情况，将退款金额做提前还款处理。
4. 分期手续费退费规则：
- 商户承担手续费，自交易发生后15天内发生退款花呗全额退手续费，15天后不退手续费。
- 用户已经支付的手续费一概不退，未支付的手续费，如果已经出了账单则不能减免，未出账单的，根据退款金额按比例减免。
5. 用户发起退款，相应的退款资金进入花呗分期放款账户，然后冲抵用户该笔交易的账单。冲抵顺序：先冲抵用户已经出账的账单，出账账单冲抵完成后再从该笔交易的最后一期账单向前冲抵，如仍有多余金额则进入用户支付宝余额。
对账说明
可登录支付宝企业版后台下载对账单，花呗分期与普通支付宝收单交易在同一张对账单中。
