花呗分期商家接入说明

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

产品接口及文档

支付场景
接口
花呗分期相关参数
手机网站支付
手机网站支付接口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_num^3
  • hb_fq_num:代表花呗分期数;
  • 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

注:老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%由用户承担。如下图。
image

退款说明

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

对账说明

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

onlineServer