花呗分期集成方案
注意
请先阅读快速指引一节，本节是补充内容。
产品接口及文档
| 支付场景 |
接口 |
花呗分期相关参数 |
| PC端 |
即时到账交易接口 |
传入参数 hb_fq_param=hb_fq_seller_percent^100|hb_fq_num^3。 hb_fq_num：代表花呗分期数； hb_fq_seller_percent：商家承担手续费传入100，用户承担手续费传入0。 |
| 统一下单并支付页面接口 alipay.acquire.page.createandpay |
传入参数 extend_parameters={"hb_fq_num":"3","hb_fq_seller_percent":"0"} hb_fq_num：代表花呗分期数； hb_fq_seller_percent：商家承担手续费传入100，用户承担手续费传入0。 |
|
| 手机网站支付接口 |
老接口 |
传入参数 hb_fq_param={"hb_fq_num":"3","hb_fq_seller_percent":"100"} hb_fq_num：代表花呗分期数； hb_fq_seller_percent：商家承担手续费传入100，用户承担手续费传入0。 |
| 新接口 |
花呗分期参数传入到extend_params中，格式如下： "extend_params":{"hb_fq_num":"3","hb_fq_seller_percent":"100"} hb_fq_num：代表花呗分期数； hb_fq_seller_percent：商家承担手续费传入100，用户承担手续费传入0。 |
|
| 手机APP支付接口 |
老接口 |
传入参数hb_fq_param={"hb_fq_num":"3","hb_fq_seller_percent":"100"} hb_fq_num：代表花呗分期数； hb_fq_seller_percent：商家承担手续费传入100，用户承担手续费传入0。 |
| 新接口 |
花呗分期参数传入到extend_params中，格式如下： "extend_params":{"hb_fq_num":"3","hb_fq_seller_percent":"100"} hb_fq_num：代表花呗分期数； hb_fq_seller_percent：商家承担手续费传入100，用户承担手续费传入0。 |
|
| 线下当面付 |
统一收单交易支付接口 |
花呗分期参数传入到extend_params中，格式如下： "extend_params":{"hb_fq_num":"3","hb_fq_seller_percent":"100"} hb_fq_num：代表花呗分期数； hb_fq_seller_percent：商家承担手续费传入100，用户承担手续费传入0。 |
| 统一收单线下交易预创建 |
花呗分期参数传入到extend_params中，格式如下： "extend_params":{"hb_fq_num":"3","hb_fq_seller_percent":"100"} hb_fq_num：代表花呗分期数； hb_fq_seller_percent：商家承担手续费传入100，用户承担手续费传入0。 |
支付接入说明
1、选择花呗分期支付时，带上花呗分期的期数和承担手续费比例，请求相应渠道的收单接口（格式参见以上表格）。
参数hb_fq_num指定可选期数，包括3/6/12期的，还款期数越长手续费越高（注：该期数是在签约时约定好的，不可指定未约定的期数，否则调接口时报错）。
参数hb_fq_seller_percent指定手续费承担方式，手续费可以由用户全承担（该值为0），也可以商户全承担（该值为100），但不可以共同承担，即不可取0和100外的其他值。（注：该值由哪方承担需要在签约时约定，且只能在调接口时传签约时约定好的值）。
2、若第一次请求参数分N期，且用户登录支付宝交易落地后，如果用相同的外部订单号再次请求参数分M期，跳转到花呗分期收银台后还是显示N期，金额也是N期的金额。后续会修改外直接报错，需要商户注意如果需要修改分期参数，勿必使用新的外部订单号。
3、测试时注意使用的买家账号需要在支付宝钱包内开通“花呗”支付，否则测试会报错。
4、当面付条码支付接口订单金额少于2000元是走的免密支付，无需用户输入支付密码确认即可完成支付。所以，如果使用当面付条码支付时如果用户要使用花呗分期付款，一定要商户传入花呗分期参数。其他支付接口不传入花呗分期参数时，跳转到支付宝收银台用户还可以选花呗分期支付。
5、如果是用户在支付宝收银台选的花呗分期（该方式并非本文描述的接口改造方案），花呗分期手续费100%由用户承担。如下图。
退款说明
1、商家退款后，款项原路退回到花呗账户。退款周期在签约时约定，最长18个月。
2、花呗分期的退款方法和即时到账相同，包括：企业版手工退款；退款API无密退款；退款API有密退款（参见上表中的退款接口）。
3、发生退款时，资金由商户收款账户退至花呗分期账户，花呗根据用户还款情况，将退款金额做提前还款处理。涉及到部分退款的规则请参见后面 “案例分析”部分。
4、手续费原则：已经产生的手续费一概不退。
（1）商户承担手续费，自交易发生后15天内发生退款花呗全额退手续费，15天后不退手续费。
（2）用户已经支付的手续费一概不退，未支付的手续费，如果已经出了账单则不能减免，未出账单的，根据退款金额按比例减免。
5、用户发起退款，相应的退款资金进入花呗分期放款账户，然后冲抵用户该笔交易的账单。
冲抵顺序：先冲抵用户已经出账的账单，出账账单冲抵完成后再从该笔交易的最后一起账单向前冲抵，如仍有多余金额则冲回用户支付宝余额。
