网站和App接入花呗分期支付功能*教程*开发文档

[复制链接]
Discuz技术网实名认证 官方认证 VIP会员 永久VIP 发表于 2018-5-21 19:29:49 | 显示全部楼层 |阅读模式 打印 上一主题 下一主题
花呗分期是蚂蚁金服推出的消费金融产品,用户在商家端网站或线下门店购物时使用花呗分期支付,订单全额实时支付到商家支付宝账户中,用户分期偿还花呗。

产品特色
1.jpg

应用场景
目前花呗分期全面支持各种场景下的分期支付,包括:PC网站支付分期、移动端支付分期、线下支付分期、口碑支付分期。

具体场景介绍请参见下文“应用案例”,接入方法请参见“接入说明”。
2.jpg
买家分期费用计算规则
如应用案例中所示,若由用户承担分期手续费,商户在下单前需要展示用户所承担的手续费具体金额(花呗分期商户及用户费率详见计费模式),具体计算方式如下:

1.计算精度

计算中涉及金额均以分为单位,即保留两位小数;

2.用户每期本金

用户每期本金=商品金额/期数;

1.把金额单位转化成分 cent

2.计算每期本金(用总金额/总期数,结果以分表示,向下取整)

BigDecimal eachPrin = BigDecimal.valueOf(payAmount).divide(new BigDecimal(“期数”), BigDecimal.ROUND_DOWN)

3. 用户每期手续费

用户每期手续费=(商品金额*手续费率)/期数;

计算过程Java代码示例

1.把金额单位转化成分 cent;

2.用转化为分后的金额乘以买家费率,得到以分表示的买家总费用;

BigDecimal totalFeeInDecimal = BigDecimal.valueOf(cent).multiply(feeRate)

3.对费用进行取整(取整规则为ROUND_HALF_EVEN);

long totalFeeInLong = totalFeeInDecimal.setScale(0, BigDecimal.ROUND_HALF_EVEN).longValue()

4.计算每期费用(用总费用/总期数,结果以分表示,向下取整)

BigDecimal eachFee = BigDecimal.valueOf(totalFeeInLong).divide(new BigDecimal(“期数”), BigDecimal.ROUND_DOWN)

4.用户每期总费用

用户每期总费用=(商品金额+商品金额*手续费率)/期数;

根据上述用户每期本金、用户每期手续费计算结果,将两者相加,结果以分表示;

BigDecimal prinAndFee = eachFee.add(eachPrin);

5. 应用案例

例:商品金额为1111.11元,用户选择3期分期,用户承担手续费,3期分期费率为2.3%;

1.用户每期本金=1111.11/3=370.37;

2.用户每期手续费=(1111.11*2.3%)/3=8.52;

3.用户每期总费用=370.37+8.52=378.89;

以上计算均为保留精度后结果。

准入条件

  • 公司已接入至少一款支付宝收单产品(当面付、APP支付、手机网站支付、电脑网站支付),并产生一定的交易额;

  • 公司具备一定的技术能力,能够独立或由服务商协助完成技术对接;

  • 支持合作后的服务联动处理,数据反馈和异议处理;

  • 公司运营稳定并具备一定的客户群,具体考核将参考公司运营时长、交易额、规模、用户数来做出综合判定。

    q.785-087-203有现成的企业支付宝*已签约支付接口功能的账号

计费模式
花呗分期每笔均产生分期手续费,商户可选择用户或自己承担(无法共同承担);

商户和用户选择不同的期数时所承担的费率请参见下表,请商户以正确的费率来计算手续费用。


商户承担手续费花呗分期费率


期数

费率


3

1.80%


6

4.5%


12

7.5%


用户承担手续费花呗分期费率



期数

费率


3

2.30%


6

4.50%


12

7.50%

资源下载
点此下载花呗分期品牌资源

应用案例-PC网站分期
商户收银台单通道模式
在此模式下,用户可在商户收银台处选择花呗分期支付,跳转到支付宝收银台时已经选定了对应期数,用户只需确认支付即可。

本模式实现需要在商户收银台增加与支付宝平行的花呗分期单通道跳转入口,接口与常规支付宝收单接口保持一致,只需在传参时定义enable_pay_channels=pcreditpayInstallment即可。

以下为支付流程:

1.用户在商户网站选择购买的商品;
3.jpg
2.用户选择支付渠道,此处建议花呗分期的支付渠道与其他支付渠道并列展示。将各分期数、各期金额和手续费展示给用户(商户界面);
4.jpg
3.用户选择“立即支付”后跳转到支付宝收银台;
5.jpg
4.用户通过扫码或账号登录的方式完成支付。

支付宝收银台模式
在此模式下,用户在商家收银台选择支付宝支付,跳转至支付宝收银台后自主选择分期进行支付。

商户无需为此额外做收银台开发,花呗准入即可接受用户使用花呗分期支付。

以下为支付流程:

1.用户在商户网站选择购买的商品;
6.jpg
2.用户在商户收银台选择支付宝支付
7.jpg
3.用户选择“立即支付”后跳转到支付宝收银台
8.jpg
4.用户选择花呗分期并完成支付。

应用案例-APP端分期
商户收银台单通道模式
在此模式下,用户可在商户收银台处选择花呗分期支付,跳转到支付宝收银台时已经选定了对应期数,用户只需确认支付即可。

本模式实现需要在商户收银台增加与支付宝平行的花呗分期单通道跳转入口,接口与常规支付宝收单接口保持一致,只需在传参时定义enable_pay_channels=pcreditpayInstallment即可。

以下为支付流程:

1.用户在商户APP选择购买的商品;
9.jpg
2.用户选择支付渠道,此处建议花呗分期的支付渠道与其他支付渠道并列展示。将各分期数、各期金额和手续费展示给用户(商户界面);
10.jpg
3.用户选择“立即支付”后跳转到支付宝APP,用户确认,支付成功。
11.jpg
支付宝收银台模式
在此模式下,用户在商家收银台选择支付宝支付,跳转至支付宝收银台后自主选择分期进行支付。

商户无需为此额外做收银台开发,花呗准入即可接受用户使用花呗分期支付。

以下为支付流程:

1.用户在商户APP选择购买的商品
12.jpg
2.用户选择支付宝渠道支付并唤起支付宝app进行支付
13.jpg
3.用户自主选择花呗分期,确认并支付
14.jpg
应用案例-线下分期
方式一:用户被扫
1.用户与收银员沟通使用花呗分期,由收银员使用扫码枪进行扫码;

交易的花呗分期期数和手续费承担方的选择必须在扫码前完成,可以由收银员在收银台选择,也可以在收银系统后台进行统一配置,具体实现方式以商户使用的系统功能为准。
15.jpg
2.用户确认分期,输入密码交易成功。
16.jpg
方式二:用户主扫
1.用户主动扫商户收款码。
17.jpg
2.用户在“付款方式”中选择花呗分期及期次,输入支付密码,完成支付。
18.jpg
应用案例-口碑分期
1.进入口碑商家优惠买单页面,输入买单金额,使用花呗分期;
19.jpg
2.用户确认分期,输入密码交易成功。
20.jpg
花呗分期商家接入说明
商户在花呗准入的前提下,才能够使用花呗分期进行收款,准入后有以下两种可选方式。

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

方式二:花呗分期单通道(可选用户或商户承担手续费),需要签约并开发相应接口来实现。商家无需签约即可实现用户付费情况下使用花呗分期,无需开发;如签约花呗分期,并按照下文的介绍进行开发并接入,可实现商家付费及用户付费两种可选模式。

产品接口及文档

支付场景

接口

花呗分期相关参数

手机网站支付

手机网站支付接口alipay.trade.wap.pay


手机App支付

App支付接口alipay.trade.app.pay


线下当面付

统一收单交易支付接口alipay.trade.pay


统一收单线下交易预创建接口alipay.trade.precreate



电脑网站支付

统一收单下单并支付页面接口alipay.trade.page.pay


  • hb_fq_num代表花呗分期数,仅支持传入3、6、12,其他期数暂不支持,传入会报错;

  • hb_fq_seller_percent代表卖家承担收费比例,商家承担手续费传入100,用户承担手续费传入0,仅支持传入100、0两种,其他比例暂不支持,传入会报错。

手机网站支付、手机APP支付、电脑网站支付若需要使用花呗分期单通道,请在交易发起时传入 enable_pay_channels=pcreditpayInstallment;前端效果请见应用案例-APP端分期、应用案例-PC网站分期。

花呗分期参数传入到extend_params中,格式如下:"extend_params":{"hb_fq_num":"3","hb_fq_seller_percent":"100"}

若您使用的是老版本的接口,请参考如下老版本接口花呗分期参数。

支付场景

接口

花呗分期相关参数

PC端支付

即时到账交易接口create_direct_pay_by_user


手机网站支付

老版本手机网站支付接口alipay.wap.create.direct.pay.by.user


手机App支付

老版本移动支付接口mobile.securitypay.pay


  • hb_fq_num:代表花呗分期数;

  • hb_fq_seller_percent:商家承担手续费传入100,用户承担手续费传入0。

传入参数hb_fq_param=hb_fq_seller_percent^100|hb_fq_num^3

  • hb_fq_num:代表花呗分期数;

  • hb_fq_seller_percent:商家承担手续费传入100,用户承担手续费传入0。

传入参数hb_fq_param={"hb_fq_num":"3","hb_fq_seller_percent":"100"}

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

支付接入说明
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.如果是虚拟商品交易,为防止用户使用花呗分期套现,需要禁止使用花呗分期。如果商家在虚拟商品交易中使用花呗分期支付,一经发现关闭花呗分期权限。禁用花呗分期方法:

  • 传入参数goods_type=0,表示虚拟交易,花呗和花呗分期将不会出现在支付宝收银台供用户选择;

  • 可在交易中通过传参禁用花呗分期渠道,具体方法:在收单接口中传入参数disable_pay_channels=pcreditpayInstallment,花呗和花呗分期将不会出现在支付宝收银台供用户选择。

如果是实物交易,请传goods_type=1。花呗分期虚实分离适用的3个产品:PC即时到账(电脑网站支付)新老接口、手机App支付新老接口、手机网站支付新老接口。

7.如果是用户在支付宝收银台选的花呗分期,花呗分期手续费100%由用户承担。如下图。
21.jpg
退款说明

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

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

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

  • 分期手续费退费规则:

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

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

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

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

线下分期服务商合作说明
合作政策
服务商签约花呗分期协作费协议,协助商户接入并推广线下花呗分期服务的,即可获得花呗分期业务返佣,具体业务政策及管理制度见公告。

协作费协议签约流程
1.服务商登录支付宝开放平台
22.jpg
2.进入开发者中心并创建应用
23.jpg
3.创建应用
24.jpg
4.创建应用后会自动关联签订花呗分期协作费
25.jpg
5.提交应用审核通过后分期协作费协议也会同步生效

6.可在服务商中心的协作协议信息中查询签订的协作费协议
26.jpg






目标做全球最大的建站资源及源码免费下载站-做网站-就选Discuz技术网






上一篇:Windows Server 2016 IIS10 设置HTTPS HTTP/2 并跑分到 A+
下一篇:[DC]VIP中心 尊享版v3.0.7
Discuz技术网,全网领先的建站资源下载基地!Discuz模板、Discuz插件、素材、特效,源码,建站,就上Discuz技术网!
通告:谨防魔趣吧(m***8.com)骗子!【Discuz技术网唯一官方网站:https://www.dzmip.com   请谨防假冒网站!】
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

发布主题
专注模板-插件-素材-教程免费分享
全国免费热线电话
155-3511-0758

周一至周日9:00-23:00

反馈建议
admin@dzmip.com 在线QQ咨询/ 在线QQ咨询
扫描二维码关注我们/

扫描二维码关注我们

今天是: | 本站已经安全运行: //这个地方可以改颜色

QQ- Archiver-手机版-小黑屋- Discuz技术网_DiscuzMIP_建站资源一条龙站! |网站地图 Discuz_DiscuzMIP_վԴһվ积分充值 |

晋ICP备18003582号 运营:Discuz技术网 山西星莹网络科技有限公司版权所有

山西省金融信息行业协会理事单位 | 山西省信息服务业行业协会会员单位 | 山西省网络信贷服务业企业联盟单位

实名认证/ 行业认证/ 官网认证/ 安全认证/