花呗分期商家接入说明
商户在花呗准入的前提下,才能够使用花呗分期进行收款,准入后有以下两种可选方式。
方式一:支付宝标准收银台展示花呗分期渠道(仅用户承担手续费),无需额外签约花呗分期。
方式二:花呗分期单通道(可选用户或商户承担手续费),需要签约并开发相应接口来实现。商家无需签约即可实现用户付费情况下使用花呗分期,无需开发;如签约花呗分期,并按照下文的介绍进行开发并接入,可实现商家付费及用户付费两种可选模式。
支付场景 |
接口 |
花呗分期相关参数 |
手机网站支付 |
手机网站支付接口alipay.trade.wap.pay |
花呗分期参数传入到extend_params中,格式如下:"extend_params":{"hb_fq_num":"3","hb_fq_seller_percent":"100"}
手机网站支付、手机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
|
手机网站支付 |
老版本手机网站支付接口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.选择花呗分期支付时,带上花呗分期的期数和承担手续费比例,请求相应渠道的收单接口(格式参见“产品接口及文档”)。
3.每期支付费用=手续费和费用的总和/分期数,具体计算方法请参考买家分期费用计算规则。
4.需要注意如果需要修改分期参数,请务必使用新的外部订单号。若在同一个交易中,第一次请求参数分N期,且用户已经进入支付宝收银台生成交易后,用相同的订单号再次请求参数分M期。则跳转到花呗分期收银台后还是显示N期,金额也是N期的金额,继续支付会报错。
5.测试时注意使用的买家账号需要在支付宝钱包内开通“花呗”支付,否则测试会报错。
6.如果是虚拟商品交易,为防止用户使用花呗分期套现,需要禁止使用花呗分期。如果商家在虚拟商品交易中使用花呗分期支付,一经发现关闭花呗分期权限。禁用花呗分期方法:
如果是实物交易,请传goods_type=1。花呗分期虚实分离适用的3个产品:PC即时到账(电脑网站支付)新老接口、手机App支付新老接口、手机网站支付新老接口。
7.如果是用户在支付宝收银台选的花呗分期,花呗分期手续费100%由用户承担。如下图。
可登录支付宝企业版后台下载对账单,花呗分期与普通支付宝收单交易在同一张对账单中。