花唄分期接入說明

前提:

商戶必須已經是花唄分期的准入狀態且已經簽約了花唄分期資金通道的前提下,才能夠使用花唄分期進行收款,准入後有以下兩種可選方式。手機APP如果以上兩個均確認已經完成但仍不支持花唄分期業務,聯繫支付寶技術支持查詢手機APP簽約是否是V4,如若不是,請先升級至V4;

接入方式:

花唄分期單通道(可選用戶或商戶承擔手續費),需要簽約並開發相應接口來實現。商家無需簽約即可實現用戶付費情況下使用花唄分期,無需開發;如簽約花唄分期,並按照下文的介紹進行開發並接入,可實現商家付費及用戶付費兩種可選模式。

集成指南:

商戶pid的獲取

該產品是在原簽約的支付產品的基礎上進行的簽約變更,故延用原PID。PID的查看方式請參見:https://doc.open.alipay.com/doc2/detail?treeId=58&articleId=103544&docType=1

祕鑰的生產和上傳

如上所述,該產品和原支付產品使用相同的PID,故無需重新對密鑰進行配置,可直接使用原支付產品的密鑰。

RSA商戶公鑰與支付寶公鑰的查看方法:https://doc.open.alipay.com/doc2/detail.htm?spm=a219a.7629140.0.0.p7Gld8&treeId=58&articleId=103546&docType=1

MD5(Key)查看方法:https://doc.open.alipay.com/doc2/detail.htm?spm=a219a.7629140.0.0.mS4enu&treeId=58&articleId=103545&docType=1

 

產品接口及文檔


若您使用的是老版本的接口,請參考如下老版本接口花唄分期參數。


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


支付接入說明

1.      訂單結算頁和商品詳情頁(可選)增加花唄分期渠道展示(支付寶提供logo矢量圖,詳情見“資源下載”),將標準收銀臺的支付寶支付和花唄分期渠道的支付寶支付並列展示。

l  如果用戶在商戶訂單結算頁選擇非分期支付寶支付,則跳轉至標準收銀臺(不包含花唄分期渠道);

l  如果用戶選擇了花唄分期渠道,則跳轉至花唄分期收銀臺(若由於額度不足或不準入等原因無法使用花唄分期,可在支付寶域內直接選擇其他支付方式)。

詳細使用場景請參考“應用案例”。

2.      選擇花唄分期支付時,帶上花唄分期的期數和承擔手續費比例,請求相應渠道的收單接口(格式參見“產品接口及文檔”)。

l  參數hb_fq_num指定可選期數,包括3/6/12期的,還款期數越長手續費越高(注:該期數是在簽約時約定好的,不可指定未約定的期數,否則調接口時報錯)。

l  參數hb_fq_seller_percent指定手續費承擔方式,手續費可以由用戶全承擔(該值爲0),也可以商戶全承擔(該值爲100),但不可以共同承擔,即不可取0和100外的其他值。

3.      每期支付費用=手續費和費用的總和/分期數,具體計算方法請參考買家分期費用計算規則

4.      需要注意如果需要修改分期參數,請務必使用新的外部訂單號。若在同一個交易中,第一次請求參數分N期,且用戶已經進入支付寶收銀臺生成交易後,用相同的訂單號再次請求參數分M期。則跳轉到花唄分期收銀臺後還是顯示N期,金額也是N期的金額,繼續支付會報錯。

5.      測試時注意使用的買家賬號需要在支付寶錢包內開通“花唄”支付,否則測試會報錯。

6.      如果是虛擬商品交易,爲防止用戶使用花唄分期套現,需要禁止使用花唄分期。如果商家在虛擬商品交易中使用花唄分期支付,一經發現關閉花唄分期權限。禁用花唄分期方法:

l  傳入參數goods_type=0,表示虛擬交易,花唄和花唄分期將不會出現在支付寶收銀臺供用戶選擇;

l  可在交易中通過傳參禁用花唄分期渠道,具體方法:在收單接口中傳入參數disable_pay_channels=pcreditpayInstallment,花唄和花唄分期將不會出現在支付寶收銀臺供用戶選擇。

如果是實物交易,請傳goods_type=1。花唄分期虛實分離適用的3個產品:PC即時到賬(電腦網站支付)新老接口、手機App支付新老接口、手機網站支付新老接口。

如果是用戶在支付寶收銀臺選的花唄分期,花唄分期手續費100%由用戶承擔。如下圖。

7.         如果是用戶在支付寶收銀臺選的花唄分期,花唄分期手續費100%由用戶承擔。如下圖。



退款說明

1.     商家退款後,款項原路退回到花唄賬戶。退款週期在簽約時約定,默認3個月。

2.     花唄分期的退款方法和普通支付寶支付相同,詳見收單產品(即時到賬、App支付、手機網站支付、當面付)接口文檔中的退款接口。

3.     發生退款時,資金由商戶收款賬戶退至花唄分期賬戶,花唄根據用戶還款情況,將退款金額做提前還款處理。

4.     分期手續費退費規則:

a)     商戶承擔手續費,自交易發生後15天內發生退款花唄全額退手續費,15天后不退手續費。

b)    用戶已經支付的手續費一概不退,未支付的手續費,如果已經出了賬單則不能減免,未出賬單的,根據退款金額按比例減免。

5.     用戶發起退款,相應的退款資金進入花唄分期放款賬戶,然後衝抵用戶該筆交易的賬單。衝抵順序:先衝抵用戶已經出賬的賬單,出賬賬單衝抵完成後再從該筆交易的最後一期賬單向前衝抵,如仍有多餘金額則進入用戶支付寶餘額。



發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章