马上过年了,经过一波年货大采购,花呗都要见底了~
不慌,今天跟大家聊一聊如何接入支付宝的花呗分期。
什么是花呗分期
花呗分期是蚂蚁集团推出的消费金融产品,用户在商家端网站或线下门店购物时使用花呗分期支付,订单全额实时支付到商家支付宝账户中,用户分期偿还资金。
分期产生的手续费用由商家或者用户进行承担,对手续费用感兴趣的同学可以参考 [花呗分期手续费计算规则] 详细了解。
那么花呗分期需要如何接入呢?目前花呗分期的接入有两种样式,
- 一种是标准的收银台模式(无需开发)
- 另一种则是单通道模式(需开发)
⚠️ 要注意 : 接入花呗分期的前提是必须要先接入支付宝的收单产品,例如:当面付、手机网站支付等。
标准的收银台模式(无需开发版)
敲重点!! < 该模式无需额外接口开发,默认为向用户收手续费,仅支持 3 期、 6 期、 12 期。>
敲重点!! < 想要商家承担手续费的话只能走接口开发版>
展示效果说明:用户拉起付款界面之后,花呗分期作为一种收款方式跟其他支付渠道并列展示,用户可以自行选择是否使用,如下图所示:
接入方式
无需任何其他操作,只要找 支付宝客服 开通支付宝收款产品下的花呗分期渠道就可以了,就是这么简单~
单通道模式(开发版)
单通道模式之所以叫单通道,是因为接入这个版本之后,唤起的收款界面是只能使用花呗分期的。所以这个模式很适合集成在商户自己的下单界面作为一个单独的支付渠道进行展示。如下图:
另外接入开发版本之后,可以自行通过接口参数控制分期数以及手续费承担方。
花呗分期的开发版本也很简单。
接入方式
首先在接入之前,我们先要完成前置的权限准备工作:
- 👉 签约 花呗分期, 访问可直接抵达签约界面
- 应用下绑定 花呗分期 产品,可参考 👉 [应用如何实现产品绑定]
是完成前置权限工作后,我们来看下接口涉及到的花呗分期参数:
- extend_params:业务拓展属性,花呗分期参数需要传到该参数下
- hb_fq_num:花呗分期数,目前支持 3 期、 6 期、 12 期
- hb_fq_seller_percent:手续费承担方,用户承担入参 0 ,商家承担入参 100
参数格式如下:
json
"extend_params" :{ "hb_fq_num" : "3" , "hb_fq_seller_percent" : "100" }
收单接口中有这个参数入口的都可以改造成花呗分期单通道的模式
下面以当面付为例子看一下接口上需要如何传参:
typescript
public class AlipayTradePrecreate {
public static void main(String[] args) throws AlipayApiException {
/** 引用初始化方法,Config配置链接:https://opensupport.alipay.com/support/FAQ/08d46c24-15a8-4f1c-85a0-68fdf587f813 **/
AlipayClient alipayClient = new DefaultAlipayClient(Config.gatewayUrl, Config.app_id, Config.merchant_private_key, Config.format, Config.charset, Config.alipay_public_key, Config.sign_type);
AlipayTradePrecreateRequest request = new AlipayTradePrecreateRequest();
JSONObject Content = new JSONObject() ;
Content.put("out_trade_no", "202400094388448");
Content.put("subject", "subject");
Content.put("total_amount", "1000");
Content.put("product_code", "FACE_TO_FACE_PAYMENT");
// 花呗分期参数信息
JSONObject extendParams = new JSONObject();
extendParams.put("hb_fq_num","3");
extendParams.put("hb_fq_seller_percent", "100");
Content.put("extend_params", extendParams);
request.setBizContent(Content.toString());
request.setNotifyUrl(Config.notify_url);
AlipayTradePrecreateResponse response = alipayClient.execute(request);
/** 获取接口调用结果 **/
System.out.println(response.getBody());
}
}
下面列举一些花呗分期中可能会遇到的问题:
- 要计算退款的重点看这篇,很有用的 👉 [花呗分期退款规则介绍 ]
- [花呗分期不可用,请选择其他付款方式]
- [花呗分期限额或花呗限额问题]
- [支付成功,是否返回花呗分期信息]
- [为什么用户没有花呗分期额度?]
- [花呗分期支付失败还能使用其它付款方式吗?]
以上就是「 支付宝花呗分期如何接入 」的全部内容啦,希望对你有所帮助~