文档中心 > 花呗分期集成方案

花呗分期接入快速指引

更新时间:2017/06/09 访问次数:1399
 
签约准入  完成花呗分期签约及准入

需要支付宝业务经理完成花呗分期签约,支付渠道添加及花呗分期白名单资格准入。

 

开发  花呗分期技术开发

制作查询用户花呗可用额度功能(可选)

给用户提供查询花呗可用额度入口,便于用户提前了解是否可用花呗支付。

地址详情   |   pc场景展示  |   app场景展示

把如下地址做成入口,提供给用户访问查询

PC页面入口:https://ds.alipay.com/fd-iiiblm8p/index.html
H5页面入口(可转成二维码供线下扫码使用):https://ds.alipay.com/fd-iiiblm8p/m-index.html
app入口:alipays://platformapi/startapp?appId=20000199&url=%2Fwww%2Findex.htm%3FbizScenario%3Dalipay-wbsh

收起  

pc场景展示

收起  

app场景展示

收起  

 

增加花呗分期独立支付入口

建议在订单结算页和商品详情页(可选)增加花呗分期渠道展示,将标准收银台的支付宝支付和花呗分期渠道的支付宝支付并列展示。

了解更多  |  LOGO资源下载

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

标准收银台如何禁用花呗分期支付:支付宝新老接口的参数名称有所区别。
如果请求参数中有partner(商户号:2088开头16位数)发起支付请求的接口,传入参数disable_paymethod=pcreditpayInstallment。
如果请求参数中使用app_id发起支付请求的接口,传入参数disable_pay_channels=pcreditpayInstallment。

收起  

 

支付接口改造

如果之前已接入过支付宝支付产品,只需增加个别参数(分期数,承担手续费)即可支持花呗分期支付。如果之前未接入过支付接口,请先接入对应支付产品。

当花呗分期功能不可用时,收银台提供了其他支付渠道供用户选择,避免流程中断。商户需要通过支付成功后的异步通知中支付渠道参数来确认本次交易是否使用了花呗分期(该字段默认不返回,需要联系支付宝技术支持进行配置)。

花呗分期参数  |   异步通知中支付渠道  |   虚实分离

hb_fq_num:代表花呗分期数;
hb_fq_seller_percent:商家承担手续费传入100,用户承担手续费传入0

如上图所示,支付接口中传递分期数与手续费承担比例即可。

注意:各支付产品参数名可能不同,详情请参考对应文档。

收起  |   了解更多细节

由支付宝技术支持配置后,异步通知会增加支付渠道out_channel_type字段。当值为“PCREDIT_CC_PCREDIT_INSTALLMENT”时,说明该笔交易使用了花呗分期支付渠道。

注意:目前仅pc/h5/app支付产品支持,当面付暂未支持,后续会支持。

收起  

如果是虚拟商品交易,为防止用户使用花呗分期套现,需要禁止使用花呗分期。如果商家在虚拟商品交易中使用花呗分期支付,一经发现会关闭花呗分期权限。

虚实分离的方法:
(1)虚拟物品商家收银页面隐藏花呗分期支付。
(2)如果是实物商品,请求参数goods_type设置为1。如果是虚拟商品,请求参数goods_type设置为0,表示虚拟交易;我们会禁用该笔交易的花呗分期渠道。

花呗分期虚实分离适用的3个产品:pc即时到账、手机app支付新老接口、手机wap支付新老接口。

收起  

 

计算并展示分期费用

展示分期入口时,同时需要给用户展示每期支付费用。

每期支付费用=手续费和费用的总和/分期数。我们提供了精简算法供参考,但存在一定误差(小于1元)。同时我们也提供了计算规则更复杂,但是费用精准的算法。根据我们的经验,用户不会在意极小的误差显示。商户请根据需求自行选择算法。

算法

 

对账

不同的支付渠道会有不同的手续费率。如果需要在账单中提供花呗分期的信息,请联系支付宝技术支持/业务经理配置。

字段示例   |   常用对账方式

如上图所示,增加了字段花呗分期数及手续费字段。为了方便阅读,图片没有展示其余字段,以实际账单为准。

收起  

如下三种对账方式:

1.登录企业版后台下载对账单。

2.调用“查询对账单下载地址alipay.data.dataservice.bill.downloadurl.query”接口对账。签约任何一款2.0支付产品(2.0指请求网关为openapi.alipay.com的接口,详见此处左栏支付能力下的产品)会默认开通该接口。

3.sftp对账单(需要联系支付宝技术支持/业务经理单独申请配置)。

收起  

 

调试应用  生产环境调试

目前花呗分期产品只能在生产环境调试,请在生产账号签约准入完成后再进行调试及测试。

 

FAQ

关于此文档暂时还没有FAQ
返回
顶部