花唄分期是Antt金融推出的消費(fèi)金融產(chǎn)品，在商家端網(wǎng)站或?qū)嶓w店購(gòu)物時(shí)用花唄分期付款，訂單全額實(shí)時(shí)支付到商家支付寶賬戶，用戶分期還款花唄。

產(chǎn)品特色

應(yīng)用場(chǎng)景

目前花唄分期全面支持各種場(chǎng)景下的分期支付，包括：PC網(wǎng)站支付分期、移動(dòng)端支付分期、線下支付分期、口碑支付分期。

具體場(chǎng)景介紹請(qǐng)參見(jiàn)下文“應(yīng)用案例”，接入方法請(qǐng)參見(jiàn)“接入說(shuō)明”。

買(mǎi)家分期費(fèi)用計(jì)算規(guī)則

如應(yīng)用案例中所示，若由用戶承擔(dān)分期手續(xù)費(fèi)，商戶在下單前需要展示用戶所承擔(dān)的手續(xù)費(fèi)具體金額（花唄分期商戶及用戶費(fèi)率詳見(jiàn)計(jì)費(fèi)模式），具體計(jì)算方式如下：

1.計(jì)算精度

計(jì)算中涉及金額均以分為單位，即保留兩位小數(shù)；

2.用戶每期本金

用戶每期本金=商品金額／期數(shù)；

1.把金額單位轉(zhuǎn)化成分 cent

2.計(jì)算每期本金（用總金額/總期數(shù)，結(jié)果以分表示，向下取整）

BigDecimal eachPrin = BigDecimal.valueOf(payAmount).divide(new BigDecimal(“期數(shù)”), BigDecimal.ROUND_DOWN)

3. 用戶每期手續(xù)費(fèi)

用戶每期手續(xù)費(fèi)=（商品金額*手續(xù)費(fèi)率）／期數(shù)；

計(jì)算過(guò)程Java代碼示例

1.把金額單位轉(zhuǎn)化成分 cent；

2.用轉(zhuǎn)化為分后的金額乘以買(mǎi)家費(fèi)率，得到以分表示的買(mǎi)家總費(fèi)用；

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

3.對(duì)費(fèi)用進(jìn)行取整(取整規(guī)則為ROUND_HALF_EVEN)；

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

4.計(jì)算每期費(fèi)用（用總費(fèi)用/總期數(shù)，結(jié)果以分表示，向下取整）

BigDecimal eachFee = BigDecimal.valueOf(totalFeeInLong).divide(new BigDecimal(“期數(shù)”), BigDecimal.ROUND_DOWN)

4.用戶每期總費(fèi)用

用戶每期總費(fèi)用=（商品金額+商品金額*手續(xù)費(fèi)率）／期數(shù)；

根據(jù)上述用戶每期本金、用戶每期手續(xù)費(fèi)計(jì)算結(jié)果，將兩者相加，結(jié)果以分表示；

BigDecimal prinAndFee = eac(eachPrin);

5. 應(yīng)用案例

例：商品金額為1111.11元，用戶選擇3期分期，用戶承擔(dān)手續(xù)費(fèi)，3期分期費(fèi)率為2.3%；

1.用戶每期本金=1111.11/3=370.37；

2.用戶每期手續(xù)費(fèi)=（1111.11*2.3%）／3=8.52；

3.用戶每期總費(fèi)用=370.37+8.52=378.89；

以上計(jì)算均為保留精度后結(jié)果。

準(zhǔn)入條件

1. 公司已接入至少一款支付寶收單產(chǎn)品（當(dāng)面付、APP支付、手機(jī)網(wǎng)站支付、電腦網(wǎng)站支付），并產(chǎn)生一定的交易額；

2. 公司具備一定的技術(shù)能力，能夠獨(dú)立或由服務(wù)商協(xié)助完成技術(shù)對(duì)接；

3. 支持合作后的服務(wù)聯(lián)動(dòng)處理，數(shù)據(jù)反饋和異議處理；

4. 公司運(yùn)營(yíng)穩(wěn)定并具備一定的客戶群，具體考核將參考公司運(yùn)營(yíng)時(shí)長(zhǎng)、交易額、規(guī)模、用戶數(shù)來(lái)做出綜合判定。

   q.785-087-203有現(xiàn)成的企業(yè)支付寶*已簽約支付接口功能的賬號(hào)

計(jì)費(fèi)模式

花唄分期每筆均產(chǎn)生分期手續(xù)費(fèi)，商戶可選擇用戶或自己承擔(dān)（無(wú)法共同承擔(dān)）；

商戶和用戶選擇不同的期數(shù)時(shí)所承擔(dān)的費(fèi)率請(qǐng)參見(jiàn)下表，請(qǐng)商戶以正確的費(fèi)率來(lái)計(jì)算手續(xù)費(fèi)用。

	商戶承擔(dān)手續(xù)費(fèi)花唄分期費(fèi)率
期數(shù)	費(fèi)率
3	1.80%
6	4.5%
12	7.5%
用戶承擔(dān)手續(xù)費(fèi)花唄分期費(fèi)率
期數(shù)	費(fèi)率
3	2.30%
6	4.50%
12	7.50%

資源下載

點(diǎn)此下載花唄分期品牌資源

應(yīng)用案例-PC網(wǎng)站分期

商戶收銀臺(tái)單通道模式

在此模式下，用戶可在商戶收銀臺(tái)處選擇花唄分期支付，跳轉(zhuǎn)到支付寶收銀臺(tái)時(shí)已經(jīng)選定了對(duì)應(yīng)期數(shù)，用戶只需確認(rèn)支付即可。

本模式實(shí)現(xiàn)需要在商戶收銀臺(tái)增加與支付寶平行的花唄分期單通道跳轉(zhuǎn)入口，接口與常規(guī)支付寶收單接口保持一致，只需在傳參時(shí)定義enable_pay_channels=pcreditpayInstallment即可。

以下為支付流程：

1.用戶在商戶網(wǎng)站選擇購(gòu)買(mǎi)的商品；

2.用戶選擇支付渠道，此處建議花唄分期的支付渠道與其他支付渠道并列展示。將各分期數(shù)、各期金額和手續(xù)費(fèi)展示給用戶（商戶界面）；

3.用戶選擇“立即支付”后跳轉(zhuǎn)到支付寶收銀臺(tái)；

4.用戶通過(guò)掃碼或賬號(hào)登錄的方式完成支付。

支付寶收銀臺(tái)模式

在此模式下，用戶在商家收銀臺(tái)選擇支付寶支付，跳轉(zhuǎn)至支付寶收銀臺(tái)后自主選擇分期進(jìn)行支付。

商戶無(wú)需為此額外做收銀臺(tái)開(kāi)發(fā)，花唄準(zhǔn)入即可接受用戶使用花唄分期支付。

以下為支付流程：

1.用戶在商戶網(wǎng)站選擇購(gòu)買(mǎi)的商品；

2.用戶在商戶收銀臺(tái)選擇支付寶支付

3.用戶選擇“立即支付”后跳轉(zhuǎn)到支付寶收銀臺(tái)

4.用戶選擇花唄分期并完成支付。

應(yīng)用案例-APP端分期

商戶收銀臺(tái)單通道模式

在此模式下，用戶可在商戶收銀臺(tái)處選擇花唄分期支付，跳轉(zhuǎn)到支付寶收銀臺(tái)時(shí)已經(jīng)選定了對(duì)應(yīng)期數(shù)，用戶只需確認(rèn)支付即可。

本模式實(shí)現(xiàn)需要在商戶收銀臺(tái)增加與支付寶平行的花唄分期單通道跳轉(zhuǎn)入口，接口與常規(guī)支付寶收單接口保持一致，只需在傳參時(shí)定義enable_pay_channels=pcreditpayInstallment即可。

以下為支付流程：

1.用戶在商戶APP選擇購(gòu)買(mǎi)的商品；

2.用戶選擇支付渠道，此處建議花唄分期的支付渠道與其他支付渠道并列展示。將各分期數(shù)、各期金額和手續(xù)費(fèi)展示給用戶（商戶界面）；

3.用戶選擇“立即支付”后跳轉(zhuǎn)到支付寶APP，用戶確認(rèn)，支付成功。

支付寶收銀臺(tái)模式

在此模式下，用戶在商家收銀臺(tái)選擇支付寶支付，跳轉(zhuǎn)至支付寶收銀臺(tái)后自主選擇分期進(jìn)行支付。

商戶無(wú)需為此額外做收銀臺(tái)開(kāi)發(fā)，花唄準(zhǔn)入即可接受用戶使用花唄分期支付。

以下為支付流程：

1.用戶在商戶APP選擇購(gòu)買(mǎi)的商品

2.用戶選擇支付寶渠道支付并喚起支付寶app進(jìn)行支付

3.用戶自主選擇花唄分期，確認(rèn)并支付

應(yīng)用案例-線下分期

方式一：用戶被掃

1.用戶與收銀員溝通使用花唄分期，由收銀員使用掃碼槍進(jìn)行掃碼；

交易的花唄分期期數(shù)和手續(xù)費(fèi)承擔(dān)方的選擇必須在掃碼前完成，可以由收銀員在收銀臺(tái)選擇，也可以在收銀系統(tǒng)后臺(tái)進(jìn)行統(tǒng)一配置，具體實(shí)現(xiàn)方式以商戶使用的系統(tǒng)功能為準(zhǔn)。

2.用戶確認(rèn)分期，輸入密碼交易成功。

方式二：用戶主掃

1.用戶主動(dòng)掃商戶收款碼。

2.用戶在“付款方式”中選擇花唄分期及期次，輸入支付密碼，完成支付。

應(yīng)用案例-口碑分期

1.進(jìn)入口碑商家優(yōu)惠買(mǎi)單頁(yè)面，輸入買(mǎi)單金額，使用花唄分期；

2.用戶確認(rèn)分期，輸入密碼交易成功。

花唄分期商家接入說(shuō)明

商戶在花唄準(zhǔn)入的前提下，才能夠使用花唄分期進(jìn)行收款，準(zhǔn)入后有以下兩種可選方式。

方式一：支付寶標(biāo)準(zhǔn)收銀臺(tái)展示花唄分期渠道（僅用戶承擔(dān)手續(xù)費(fèi)），無(wú)需額外簽約花唄分期。

方式二：花唄分期單通道（可選用戶或商戶承擔(dān)手續(xù)費(fèi)），需要簽約并開(kāi)發(fā)相應(yīng)接口來(lái)實(shí)現(xiàn)。商家無(wú)需簽約即可實(shí)現(xiàn)用戶付費(fèi)情況下使用花唄分期，無(wú)需開(kāi)發(fā)；如簽約花唄分期，并按照下文的介紹進(jìn)行開(kāi)發(fā)并接入，可實(shí)現(xiàn)商家付費(fèi)及用戶付費(fèi)兩種可選模式。

產(chǎn)品接口及文檔

支付場(chǎng)景	接口	花唄分期相關(guān)參數(shù)
手機(jī)網(wǎng)站支付	手機(jī)網(wǎng)站支付接口ali
手機(jī)App支付	App支付接口ali
線下當(dāng)面付	統(tǒng)一收單交易支付接口ali
統(tǒng)一收單線下交易預(yù)創(chuàng)建接口ali
電腦網(wǎng)站支付	統(tǒng)一收單下單并支付頁(yè)面接口ali

• hb_fq_num代表花唄分期數(shù)，僅支持傳入3、6、12，其他期數(shù)暫不支持，傳入會(huì)報(bào)錯(cuò)；

• hb_fq_seller_percent代表賣(mài)家承擔(dān)收費(fèi)比例，商家承擔(dān)手續(xù)費(fèi)傳入100，用戶承擔(dān)手續(xù)費(fèi)傳入0，僅支持傳入100、0兩種，其他比例暫不支持，傳入會(huì)報(bào)錯(cuò)。

手機(jī)網(wǎng)站支付、手機(jī)APP支付、電腦網(wǎng)站支付若需要使用花唄分期單通道，請(qǐng)?jiān)诮灰装l(fā)起時(shí)傳入 enable_pay_channels=pcreditpayInstallment；前端效果請(qǐng)見(jiàn)應(yīng)用案例-APP端分期、應(yīng)用案例-PC網(wǎng)站分期。

花唄分期參數(shù)傳入到extend_params中，格式如下："extend_params":{"hb_fq_num":"3","hb_fq_seller_percent":"100"}

若您使用的是老版本的接口，請(qǐng)參考如下老版本接口花唄分期參數(shù)。

支付場(chǎng)景	接口	花唄分期相關(guān)參數(shù)
PC端支付	即時(shí)到賬交易接口create_direct_pay_by_user
手機(jī)網(wǎng)站支付	老版本手機(jī)網(wǎng)站支付接口ali
手機(jī)App支付	老版本移動(dòng)支付接口mobile.

• hb_fq_num：代表花唄分期數(shù)；

• hb_fq_seller_percent：商家承擔(dān)手續(xù)費(fèi)傳入100，用戶承擔(dān)手續(xù)費(fèi)傳入0。

傳入?yún)?shù)hb_fq_param=hb_fq_seller_percent^100|hb_fq_num^3

• hb_fq_num：代表花唄分期數(shù)；

• hb_fq_seller_percent：商家承擔(dān)手續(xù)費(fèi)傳入100，用戶承擔(dān)手續(xù)費(fèi)傳入0。

傳入?yún)?shù)hb_fq_param={"hb_fq_num":"3","hb_fq_seller_percent":"100"}

注：老wap支付接口)不支持開(kāi)通花唄分期支付渠道。

支付接入說(shuō)明

1.訂單結(jié)算頁(yè)和商品詳情頁(yè)（可選）增加花唄分期渠道展示（支付寶提供logo矢量圖，詳情見(jiàn)“資源下載”），將標(biāo)準(zhǔn)收銀臺(tái)的支付寶支付和花唄分期渠道的支付寶支付并列展示。

• 如果用戶在商戶訂單結(jié)算頁(yè)選擇非分期支付寶支付，則跳轉(zhuǎn)至標(biāo)準(zhǔn)收銀臺(tái)（不包含花唄分期渠道）；

• 如果用戶選擇了花唄分期渠道，則跳轉(zhuǎn)至花唄分期收銀臺(tái)（若由于額度不足或不準(zhǔn)入等原因無(wú)法使用花唄分期，可在支付寶域內(nèi)直接選擇其他支付方式）。

詳細(xì)使用場(chǎng)景請(qǐng)參考“應(yīng)用案例”。

2.選擇花唄分期支付時(shí)，帶上花唄分期的期數(shù)和承擔(dān)手續(xù)費(fèi)比例，請(qǐng)求相應(yīng)渠道的收單接口（格式參見(jiàn)“產(chǎn)品接口及文檔”）。

• 參數(shù)hb_fq_num指定可選期數(shù)，包括3/6/12期的，還款期數(shù)越長(zhǎng)手續(xù)費(fèi)越高（注：該期數(shù)是在簽約時(shí)約定好的，不可指定未約定的期數(shù)，否則調(diào)接口時(shí)報(bào)錯(cuò)）。

• 參數(shù)hb_fq_seller_percent指定手續(xù)費(fèi)承擔(dān)方式，手續(xù)費(fèi)可以由用戶全承擔(dān)（該值為0），也可以商戶全承擔(dān)（該值為100），但不可以共同承擔(dān)，即不可取0和100外的其他值。

3.每期支付費(fèi)用＝手續(xù)費(fèi)和費(fèi)用的總和/分期數(shù)，具體計(jì)算方法請(qǐng)參考買(mǎi)家分期費(fèi)用計(jì)算規(guī)則。

4.需要注意如果需要修改分期參數(shù)，請(qǐng)務(wù)必使用新的外部訂單號(hào)。若在同一個(gè)交易中，第一次請(qǐng)求參數(shù)分N期，且用戶已經(jīng)進(jìn)入支付寶收銀臺(tái)生成交易后，用相同的訂單號(hào)再次請(qǐng)求參數(shù)分M期。則跳轉(zhuǎn)到花唄分期收銀臺(tái)后還是顯示N期，金額也是N期的金額，繼續(xù)支付會(huì)報(bào)錯(cuò)。

5.測(cè)試時(shí)注意使用的買(mǎi)家賬號(hào)需要在支付寶錢(qián)包內(nèi)開(kāi)通“花唄”支付，否則測(cè)試會(huì)報(bào)錯(cuò)。

6.如果是虛擬商品交易，為防止用戶使用花唄分期套現(xiàn)，需要禁止使用花唄分期。如果商家在虛擬商品交易中使用花唄分期支付，一經(jīng)發(fā)現(xiàn)關(guān)閉花唄分期權(quán)限。禁用花唄分期方法：

1. 傳入?yún)?shù)goods_type=0，表示虛擬交易，花唄和花唄分期將不會(huì)出現(xiàn)在支付寶收銀臺(tái)供用戶選擇；

2. 可在交易中通過(guò)傳參禁用花唄分期渠道，具體方法：在收單接口中傳入?yún)?shù)disable_pay_channels=pcreditpayInstallment，花唄和花唄分期將不會(huì)出現(xiàn)在支付寶收銀臺(tái)供用戶選擇。

如果是實(shí)物交易，請(qǐng)傳goods_type=1?；▎h分期虛實(shí)分離適用的3個(gè)產(chǎn)品：PC即時(shí)到賬（電腦網(wǎng)站支付）新老接口、手機(jī)App支付新老接口、手機(jī)網(wǎng)站支付新老接口。

7.如果是用戶在支付寶收銀臺(tái)選的花唄分期，花唄分期手續(xù)費(fèi)100%由用戶承擔(dān)。如下圖。

退款說(shuō)明

1. 商家退款后，款項(xiàng)原路退回到花唄賬戶。退款周期在簽約時(shí)約定，默認(rèn)3個(gè)月。

2. 花唄分期的退款方法和普通支付寶支付相同，詳見(jiàn)收單產(chǎn)品（即時(shí)到賬、App支付、手機(jī)網(wǎng)站支付、當(dāng)面付）接口文檔中的退款接口。

3. 發(fā)生退款時(shí)，資金由商戶收款賬戶退至花唄分期賬戶，花唄根據(jù)用戶還款情況，將退款金額做提前還款處理。

4. 分期手續(xù)費(fèi)退費(fèi)規(guī)則：

• 商戶承擔(dān)手續(xù)費(fèi)，自交易發(fā)生后15天內(nèi)發(fā)生退款花唄全額退手續(xù)費(fèi)，15天后不退手續(xù)費(fèi)。

• 用戶已經(jīng)支付的手續(xù)費(fèi)一概不退，未支付的手續(xù)費(fèi)，如果已經(jīng)出了賬單則不能減免，未出賬單的，根據(jù)退款金額按比例減免。

1. 用戶發(fā)起退款，相應(yīng)的退款資金進(jìn)入花唄分期放款賬戶，然后沖抵用戶該筆交易的賬單。沖抵順序：先沖抵用戶已經(jīng)出賬的賬單，出賬賬單沖抵完成后再?gòu)脑摴P交易的最后一期賬單向前沖抵，如仍有多余金額則進(jìn)入用戶支付寶余額。

對(duì)賬說(shuō)明

可登錄支付寶企業(yè)版后臺(tái)下載對(duì)賬單，花唄分期與普通支付寶收單交易在同一張對(duì)賬單中。

線下分期服務(wù)商合作說(shuō)明

合作政策

服務(wù)商簽約花唄分期協(xié)作費(fèi)協(xié)議，協(xié)助商戶接入并推廣線下花唄分期服務(wù)的，即可獲得花唄分期業(yè)務(wù)返傭，具體業(yè)務(wù)政策及管理制度見(jiàn)公告。

協(xié)作費(fèi)協(xié)議簽約流程

1.服務(wù)商登錄支付寶開(kāi)放平臺(tái)

2.進(jìn)入開(kāi)發(fā)者中心并創(chuàng)建應(yīng)用

3.創(chuàng)建應(yīng)用

4.創(chuàng)建應(yīng)用后會(huì)自動(dòng)關(guān)聯(lián)簽訂花唄分期協(xié)作費(fèi)

5.提交應(yīng)用審核通過(guò)后分期協(xié)作費(fèi)協(xié)議也會(huì)同步生效

6.可在服務(wù)商中心的協(xié)作協(xié)議信息中查詢簽訂的協(xié)作費(fèi)協(xié)議

本接口及文檔資料由作者獨(dú)家碼字，轉(zhuǎn)載請(qǐng)注明來(lái)源