商家接入指引

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

  • 支付宝标准收银台展示花呗分期渠道(仅用户承担手续费),无需额外签约花呗分期。

  • 花呗分期单通道(可选用户或商户承担手续费),需要签约并开发相应接口来实现。

商家无需签约即可实现用户付费情况下使用花呗分期,无需开发;如签约花呗分期,并按照下文的介绍进行开发并接入,可实现商家付费及用户付费两种可选模式。

支付场景 接口 花呗分期相关参数
手机网站支付 手机网站支付接口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_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 | |

支付接入说明

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

退款说明

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

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

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

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

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

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

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

对账说明

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

安全说明

支付宝不允许花呗套现,如发现套现行为,参与套现的用户的花呗及花呗分期支付渠道将做关闭处理。同时,支付宝针对套现行为,为平台类商家花呗防套现给出以下建议:

  1. 接入 RiskGo 服务,花呗安全团队将通过 RiskGo 渠道向平台商家输出疑似套现订单信息;平台商需对交易进行拦截,风险店铺进行处罚关闭,并反馈处理结果。点击查看 RiskGo 产品接入指引

  2. 提前对平台商品类型做好虚实分离,实物商品和虚拟商品使用不同的支付宝账户进行收款,或者通过商品名称进行虚拟和实物标注,助于反套现策略防控,降低正常交易打扰情况。

虚实分离的实现方式:在接口请求参数中传入 goods_type 参数,参数值为0代表虚拟类商品,支付宝会禁用花呗渠道;参数值为1代表实物类商品,支付宝会打开花呗渠道。虚实分离的产品支持情况,以及参数的具体使用方法,请详见各产品的请求参数列表。

onlineServer