Accept payments with Huabei Installment on the merchant's cashier page
This topic provides a step-by-step guide for Acquiring Service Providers (ACQPs) on how to accept a payment with Huabei Installment that is displayed on the merchant's cashier page.
Huabei Installment is a consumer financial product launched by Ant Group and is supported only by Alipay.
After a consumer selects Huabei Installment to pay when shopping on online merchant platforms or offline stores, the full order amount is settled to the ACQP's account on a regular basis and the consumer repays Huabei in installments.
Huabei Installment provides the following benefits:
- Gives consumers more purchasing power
- Improves the conversion rate
- Increases the price per transaction
- Boosts the sales amount
Before you begin
Before you begin, you need to familiarize yourself with the procedure of implementing Cashier Payment. For more information, see Integration overview.
About the task
This task applies to the scenario where a consumer places an order on a merchant platform and selects Huabei Installment on the merchant's cashier page to pay.
Brand display
When displaying the Huabei Installment logo, you and your merchants need to conform to Alipay's brand display requirements as shown in the following figure:
Figure 1. Huabei Installment brand display
Procedure
The following steps focus on the differences that the ACQP needs to pay attention to when accepting payments with Huabei Installment on the merchant's cashier page in comparison with other payment methods:
Note: The payment method page is also known as the merchant's cashier page.
Step 1. Render the payment method page
In the Huabei Installment scenario, you need to include the following information on the payment method page:
- Display the Huabei Installment logo along with other payment methods. For implementation details, contact your solution architect.
- Display the service charge that is borne by the consumer. For how to calculate the service charge, see How is the service charge calculated.
Step 2. Initiate a payment
After the consumer selects Huabei Installment on the payment method page, you need to call the pay API to initiate a payment and specify the details about the installment payment in the request.
How to specify the request parameters
The following parameters must be configured properly in the request:
- paymentMethod.paymentMethodType: set the value to
ALIPAY_CN
- paymentFactor.presentmentMode: set the value to
TILE
or do not specify this parameter. - passThroughInfo: use this parameter to specify the details about the installment payment as follows:
"passThroughInfo":"{\"hb_fq_seller_percent\":\"0\",\"hb_fq_num\":\"3\"}"
Parameter | Description |
hb_fq_num | The number of installments selected by the consumer. Valid values: 3, 6, 12 |
hb_fq_seller_percent | The percentage of the service charge that is borne by the seller (merchant). In cross-border transactions, Alipay only supports the scenario where the buyer (consumer) bears the service charge. Fixed value: 0 |
Note: The passThroughInfo parameter is only available to ACQPs that have integrated Huabei Installment on the merchant's cashier page.
Sample
The ACQP sends a request to Alipay+.
{
"userRegion": "CN",
"paymentNotifyUrl": "https://xmock.inc.alipay.net/api/Ipay/globalSite/automtion/paymentNotify.htm",
"paymentRequestId": "pay_1089760038715669_102XXX5070000",
"paymentFactor": {
"isInStorePayment": "false",
"isCashierPayment": "true",
"presentmentMode": "TILE"
},
"order": {
"referenceOrderId": "1027XXXXX0000",
"orderDescription": "SHOES",
"orderAmount": {
"currency": "JPY",
"value": "100"
},
"merchant": {
"referenceMerchantId": "M00XXX0000001",
"merchantName": "UGG",
"merchantMCC": "5411",
"merchantAddress": {
"region": "JP",
"city": "xxx"
}
},
"env": {
"terminalType": "APP",
"osType": "IOS"
}
},
"settlementStrategy": {
"settlementCurrency": "USD"
},
"paymentAmount": {
"currency": "JPY",
"value": "100"
},
"paymentMethod": {
"paymentMethodType": "ALIPAY_CN"
},
"passThroughInfo":"{\"hb_fq_seller_percent\":\"0\",\"hb_fq_num\":\"3\"}"
}
Alipay+ returns a response to the ACQP.
{
"acquirerId": "A0XXXXX400000000",
"applinkUrl": "",
"normalUrl": "http://iopengw-eu95-0.sggz00b.stable.alipay.net/api/open/v1/ac/cashier/self/codevalue/checkout.htm?codeValue=281666040091XXX1j0I50amuD31LZvv31dc&route_group=GROUP_20220801XXX459",
"paymentAmount": {
"currency": "JPY",
"value": "100"
},
"paymentId": "2022101819074101000060006443172",
"paymentUrl": "alipays://platformapi/startApp?appId=10000007&actionType=route&qrcode=281666040091lNHk1j0I50XXXXX1dc&externalThrough=%7B%22acTerminalType%22%3A%22WAP%22%7D",
"pspId": "1022XXXX0000000001",
"result": {
"resultCode": "PAYMENT_IN_PROCESS",
"resultMessage": "The payment in process.",
"resultStatus": "U"
},
"schemeUrl": "alipays://platformapi/startApp?appId=10000007&actionType=route&qrcode=281666040091lNHk1j0I50amuD31LZvv31dc&externalThrough=%7B%22acTerminalType%22%3A%22WAP%22%7D"
}
Appendix
How is the service charge calculated?
To demonstrate how the service charge is calculated, the following case is provided for your reference. In this case, a Chinese consumer purchases a ¥ 1111.11 merchandise and chooses to pay in 3 installments.
Note:
- The service charge is calculated in the smallest currency unit. For example, if the currency is HKD and the amount is $1.00, the value of the amount is set to 100; or if the currency is JPY and the amount is ¥1, the value of the amount is set to 1.
- The following case is for reference only. Please refer to your contract for details on the service charge rate and more.
Known conditions
- Order amount: 111111 CNY
- Number of installments: 3
- Service charge rate: 2.3%
Calculation results
- Principal per installment: 111111/3 = 37037 CNY
- Service charge per installment: (111111 * 2.3%)/3 = 852 CNY
- Payment amount per installment: 37037 + 852 = 37889 CNY