进阶功能

接入花呗分期说明

APP 支付目前支持花呗分期的付款方式。要想在 APP 支付中使用花呗分期,只需要开发者根据自己所使用的接口版本,在对应接口列表中的接口中传入对应的参数即可。

新版接口

相关接口列表

接口英文名 接口中文名
alipay.trade.app.pay app 支付接口 2.0

标准收银台模式

支付宝标准收银台展示花呗分期渠道(仅用户承担手续费),无需额外签约花呗分期,仅需开发者在上表的收单接口中传入参数 enable_pay_channels=pcreditpayInstallment

单通道模式

要实现花呗分期单通道模式,将花呗分期资金渠道与与支付宝并列,开发者除了在收单接口的可用渠道参数传入 enable_pay_channels=pcreditpayInstallment 外,还需要将花呗分期参数传入到 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 支付 老版本移动支付接口:mobile.securitypay.pay

标准收银台模式

支付宝标准收银台展示花呗分期渠道(仅用户承担手续费),无需额外签约花呗分期,仅需开发者根据场景在对应的支付接口中传入参数 enable_paymethod=pcreditpayInstallment

单通道模式

要实现花呗分期单通道模式,将花呗分期资金渠道与与支付宝并列,开发者除了在收单接口的可用渠道参数传入enable_paymethod=pcreditpayInstallment 外,还需要传入以下参数:

hb_fq_param={"hb_fq_num":"3","hb_fq_seller_percent":"100"}
  • hb_fq_num:代表花呗分期数,仅支持传入3、6、12,其他期数暂不支持,传入会报错;
  • hb_fq_seller_percent:商家承担手续费传入 100,用户承担手续费传入 0,仅支持传入 100、0 两种,其他比例暂不支持,传入会报错。

注意
老wap支付接口 (alipay.wap.trade.create.direct) 不支持开通花呗分期支付渠道。

onlineServer