商家接入指引

接入前提

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

  • 支付宝标准收银台展示花呗分期渠道(仅用户承担手续费),无需额外签约花呗分期,仅需设置传入请求参数 enable_pay_channels,详情见 API 列表
  • 花呗分期单通道(可选用户或商户承担手续费),需要签约并开发相应接口来实现,详情见 API 列表

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

商户在接入花呗分期时如有问题,请拨打商户服务电话:95188。

接入流程

第一步:签署支付宝收单

商户收银台需接入支付宝,支持支付宝收款;商户需签署支付宝收单协议中的当面付、APP 支付、电脑网站支付、手机网站支付。商户在登录支付宝商家中心后在“产品中心”页签署收单协议,如下图所示:
image.png

第二步:支付宝账号花呗准入

商户的支付宝帐号需完成花呗准入,即商户支持用户以花呗、花呗分期向该商户账号付款。商户在满足花呗准入条件后,就可以顺利接入花呗
商户点击页面下方的“立即接入”后(如下图所示),系统将检查支付宝账号是否准入;如果暂时不准入,商户可以先将支付宝交易额做到一定规模后再来检查。

花呗API.png

第三步:签署花呗分期手续费协议

在接入花呗后,商户还需签署该协议,才能接通花呗分期单通道和具备贴息能力。

说明
签署该协议,不意味着立刻产生分期费用。只有在商户签署了该协议、设置了分期免息商品、完成了分期免息交易后,才会产生分期手续费。

第四步:商家接入花呗分期单通道

花呗分期单通道模式,是指商家在自己的收银台将花呗分期资金渠道与与支付宝并列,支持用户选择花呗分期的某期数购买,并将分期方案带至支付宝收银台。
目前手机网站支付、手机 APP 支付、电脑网站支付产品支持花呗分期单通道。商户在接入单通道过程中需要签约花呗分期,接口与常规支付宝收单接口保持一致,只需在传参时按上表中的格式传入花呗分期相关参数(如 hb_fq_param 和 extend_params 等)即可。
在接入过程中遇到的花呗分期参数问题可以参考 API 列表;前端效果请见应用案例-APP端分期应用案例-PC网站分期

第五步:完成花呗分期前置

商户在交易流程(搜索、商品详情页、购物车、下单页等)根据花呗分期前置激励计划要求,接入设置花呗分期组件,支持用户使用 (如下图所示),将可以获得花呗的贴息奖励。具体规则商户可以点击查看《花呗分期前置激励计划》。

前置demo.png

支付接入说明

1.订单结算页和商品详情页(可选)增加花呗分期渠道展示(支付宝提供 logo 矢量图,点击下载花呗品牌资源),将标准收银台的支付宝支付和花呗分期渠道的支付宝支付并列展示。

  • 如果用户在商户订单结算页选择非分期支付宝支付,则跳转至标准收银台(不包含花呗分期渠道);
  • 如果用户选择了花呗分期渠道,则跳转至花呗分期收银台(若由于额度不足或不准入等原因无法使用花呗分期,可在支付宝域内直接选择其他支付方式)。

详细使用场景请参考应用案例

2.选择花呗分期支付时,带上花呗分期的期数和承担手续费比例,请求相应渠道的收单接口(格式参见 API 列表)。

  • 参数 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%由用户承担,如下图所示:
huabei.png

退款说明

1.商家退款后,款项原路退回到花呗账户。退款周期在签约时约定,默认3个月。
2.花呗分期的退款方法和普通支付宝支付相同,详见收单产品(即时到账、App支付、手机网站支付、当面付)接口文档中的退款接口。
3.发生退款时,资金由商户收款账户退至花呗分期账户,花呗根据用户还款情况,将退款金额做提前还款处理。
4.分期手续费退费规则:

  • 商户承担手续费,自交易发生后15天内发生退款花呗全额退手续费,15天后不退手续费。
  • 用户已经支付的手续费一概不退,未支付的手续费,如果已经出了账单则不能减免,未出账单的,根据退款金额按比例减免。

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

对账说明

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

安全说明

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

  1. 接入 RiskGo 服务,花呗安全团队将通过 RiskGo 渠道向平台商家输出疑似套现订单信息;平台商需对交易进行拦截,风险店铺进行处罚关闭,并反馈处理结果。点击查看 RiskGo 产品接入指引
  2. 提前对平台商品类型做好虚实分离,实物商品和虚拟商品使用不同的支付宝账户进行收款,或者通过商品名称进行虚拟和实物标注,助于反套现策略防控,降低正常交易打扰情况。

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

onlineServer