Best practices for BNPL channels
Definition of the BNPL channels and special requirements
Alipay+ is planning to add some Mobile Payment Partners (MPPs) with the Buy Now Pay Later (BNPL) feature. BNPL is a type of installment loan, which gives a user a certain credit line that is long-term effective and recyclable. The user can use this credit line for transactions. However, MPPs still need to apply real-time risk control to BNPL transactions to reduce risks on the user side and the MPP side, which requires the Acquiring Partners (ACQPs) to provide specific information in the API request to Alipay+. The required information is categorized into basic ones and extended ones, and they have a heavy impact on the success of payments.
Currently, the requirements in this document only apply to the Cashier Payment.
Requirements for the ACQP
Certain parameters are required for the pay API requests. See the following sections for details.
Basic info parameters
Parameters in the following tables are strongly recommended to be passed in by the ACQPs. The MPP's risk control relies heavily on these parameters. The payment success rate is estimated to rise by 5%~10% if these parameters are provided.
The unique ID that is assigned by the merchant to identify a buyer.
Recipient shipping address. See shippingAddress for details.
The two-character ISO 3166 country/region code
State, country, or province
City, district, suburb, town, or village
Address line 1, such as street, PO Box, or company name.
Address line 2 (such as apartment, suite, unit, or building)
ZIP or postal code
Extended info parameters
Parameters in the following tables are recommended to be passed in by the ACQPs. The payment success rate is estimated to rise by 5% if these parameters are provided.
The unique ID assigned by the merchant that directly provides services or goods to users to identify goods.
A categorization of the goods type.
Goods price. See Amount for details.
REQUIRED String (3)
The three-character ISO-4217 currency code.
REQUIRED Integer (16)
The value is in the smallest currency unit (for example, if the value is 100, the amount is $1.00 when currency is USD, or ￥100 when currency is JPY). Value range: 0 - unlimited.