Version 1.1.0

Release date: 2022/04/15

This version covers the updates since 2022/04/15, which mainly include the following important additions and improvements:

• Released the Alipay+ Unified Payment edition of Cashier Payment. In this version, Alipay+ supports consulting the payment method information via the consultPayment API or the Alipay+ ACQP Client SDK. Since 2022/05/27, Alipay+ has supported the aggregated logo feature.
• Added the support of the TSP integration mode for ACQPs.
• Improve the API reference documentation in terms of the parameter descriptions, result codes, and so on.
• Optimized the documentation of Reconciliation in terms of adding a guide about how to perform reconciliation, refining the parameter description and sample codes, and so on.
• Added the documentation for support of BNPL channels.
• Added the FAQ documentation for ACQPs.

For more information about all the updates in Version 1.1.0, see the change history below.

History for previous updates

Note: Starting from 2022/07/29, the Alipay+ documentation is restructured to support version control. The following list describes important updates to our documentation before this date.

July 15 2022

Enhanced

• Changed the merchantInfo.registrationDetail.registrationNo parameter in the registration API from Required to Optional to satisfy the needs of individual merchant registration.
• Added the following 6 valid values to the pspRegistrationResultList.pspName parameter in the inquiryRegistrationStatus and notifyRegistrationStatus APIs to keep consistent with the newly-launched feature for merchant registration at MPP's side:

• BPI
• RABBIT_LINE_PAY
• BOOST
• NaverPay
• KLARNA
• TINABA

Document improvements

• Improved the Reconcile section in that:

• Optimized the Overview topic to include information about some basic concepts about the reconciliation.
• Added a topic Perform reconciliation to introduce a step-to-step guide on how to do reconciliations.
• Updated the samples and the description of the parameters in each financial report.
• Added a subsection Explore more to introduce miscellaneous information, for example, how to select the reconciliation mode, and how to handle exceptional cases.

• Removed the following 25 request parameters from the specification of the registration API. Note that this change is backward compatible.

• merchantInfo.logo.logoName
• merchantInfo.logo.logoUrl
• merchantInfo.merchantAddress.region
• merchantInfo.merchantAddress.state
• merchantInfo.merchantAddress.city
• merchantInfo.merchantAddress.address1
• merchantInfo.merchantAddress.address2
• merchantInfo.merchantAddress.zipCode
• merchantInfo.representativeName
• merchantInfo.representativeId
• merchantInfo.registrationDetail.attachments.attachmentType
• merchantInfo.registrationDetail.attachments.file
• merchantInfo.registrationDetail.attachments.attachmentName
• merchantInfo.registrationDetail.attachments.content
• merchantInfo.registrationDetail.attachments.contentType
• merchantInfo.registrationDetail.contactInfo.contactNo
• merchantInfo.registrationDetail.contactInfo.contactType
• merchantInfo.registrationDetail.registrationEffectiveDate
• merchantInfo.registrationDetail.registrationExpireDate
• merchantInfo.shareholderName
• merchantInfo.shareholderId
• storeInfo.feeTier
• storeInfo.storeContacts.fullName
• storeInfo.storeContacts.identificationId
• storeInfo.storeContacts.contactNo

June 30 2022

Document improvements

• Updated the API reference documentation, to make it more accurate and clear. This includes:

• Added more detailed descriptions. For example, for optional request parameters, added conditions when these parameters are recommended to be specified by the ACQP; for optional response parameters, added conditions when these parameters are returned by Alipay+.
• Refined the Result processing logic section for APIs that are invoked by the ACQP.
• Added the How to return the result section for APIs that are invoked by Alipay+.
• Adjusted the sequence of some parameters based on their relevance.
• Fixed several errors in the sample codes.
• Fixed some grammatical errors to improve readability.

For more information, see API Reference (ACQP).

• Updated the Result codes table as follows:

• Added the NO_INTERFACE_DEF result code for all APIs.
• Added the PAYMENT_AMOUNT_INVALID result code for the following APIs:

• pay (Auto Debit)
• pay (User-presented Mode Payment)
• pay (Merchant-presented Mode Payment - Entry Code)
• pay (Merchant-presented Mode Payment - Order Code)
• pay (Cashier Payment)
• userInitiatedPay

• Added the ORDER_IS_CLOSED result code for the userInitiatedPay API.
• Added the CURRENCY_NOT_SUPPORT result code for the refund API.
• Deleted the INVALID_API result code for all APIs.
• Deleted the EXPIRED_CODE result code for the following APIs:

• pay (Merchant-presented Mode Payment - Entry Code)
• pay (Merchant-presented Mode Payment - Order Code)
• pay (Cashier Payment)

• Deleted the INVALID_CODE result code for the following APIs:

• pay (Merchant-presented Mode Payment - Entry Code)
• pay (Merchant-presented Mode Payment - Order Code)
• pay (Cashier Payment)

• Deleted the REPEAT_REQ_INCONSISTENT result code for the registration API.
• Deleted the REGISTRATION_STATUS_ABNORMAL result code for the notifyRegistrationStatus API.

• Released a step-by-step guide for merchants on how to consult the Alipay+ payment method information with Web/WAP SDK. For more information, see Consult payment method information with SDK.

• Released the brand display guidelines for Cashier Payment for merchants. For more information, see Brand Display Guidelines for Cashier Payment.

• Updated the brand display guidelines. This includes the following documents:

• Alipay+ Fundamental Brand Guidelines. The original Alipay+ foundational brand guidelines is moved to older edition documents.
• Alipay+ Brand Mark Assets. This provide an entry to download the Alipay+ logo asset.
• Brand Display Guidelines for Cashier Payment. This replaces the UX design guideline for Cashier Payment.
• Brand display guidelines for in-store payment. This replaces the Brand display guidelines for in-store payment in UX design guideline.

• Changed the term Legacy Documentation to Older Edition, because the Tile and Bundle Mode of Cashier Payment is still available for some clients, and its documentation is still maintained. For more information, see Older Edition.

May 27 2022

New

• Released the aggregated logo feature for Cashier Payment (Alipay+ Unified Payment). For more information, see UX design guideline and Product introduction.
• Released the TSP integration mode for ACQPs. In this mode, ACQPs can integrate Alipay+ products by cooperating with their TSPs. For more information, see the following three documents:

• Integration guide for TSP mode
• Alipay+ Developer Center User Guide for Partners
• Alipay+ Developer Center User Guide for TSPs

Enhanced

• Added an entry to download the Alipay+ logo asset in Alipay+ foundational brand guidelines.
• Updated samples for the inquiryRegistrationStatus API to help ACQPs better specify request parameters and obtain the registration result.

Document improvements

• Deleted the appIdentifier parameter in the pay (cashier payment) API.
• Added the enumeration values of the paymentOptions.promoNames parameter in the consultPayment API to include the usable languages for the promotion names.
• Added a parameter pspId to the response parameters in the pay (cashier payment) API.

• Changed the report names in the Reconcile section of all the integration documents to match the names in the Alipay+ Rules. Specifically:

• Clearing Transaction Report is changed to Transaction Detail Report.
• Clearing Summary Report is changed to Transaction Summary Report.
• Clearing Fee Report is changed to Fee Report.

• Deleted the scopes parameter from the idempotency fields table as it can not be used to control the idempotency for the prepare API.

April 29 2022

New

• Released the migration guide doc for AlipayCN to Alipay+. For more information, see Migration guide from AlipayCN to Alipay+.
• Released the migration guide documentation for AMS to Aliapy+. For more information, see Migration guide from AMS to Alipay+.
• Released the documentation for support of BNPL channels. For more information, see Best practices for BNPL channels.
• Released the FAQ documentation for ACQPs. For more information, see FAQ.

Enhanced

• Split the consultPayment API reference into two topics, one for Cashier Payment, one for Auto Debit. For more information, see consultPayment (Cashier Payment) and consultPayment (Auto Debit).
• Updated the UX design guidelines for Cashier Payment and moved the old version to Older Edition. For more information, see UX Design Guidelines and Older Edition.

Document improvements

• Updated the notification retry period from "up to 24 hours" to "up to 24 hours 22 minutes" for the notifyPayment API.
• Changed the accuracy of the Request-Time and Response-Time header fields from milliseconds to seconds.
• Changed the conditionality of the following parameters from Required to Optional for the consultPayment API:

• merchant.merchantMCC
• merchant.merchantName
• merchant.merchantAddress

April 15 2022

New

• Released the Alipay+ Unified Payment edition of Cashier Payment. For more information, see Product introduction.
• Released the Alipay+ ACQP Client SDK. For more information, see SDK Reference.
• Added older edition documentation for Cashier Payment tile and bundle mode. For more information, see Older Edition.

Enhanced

• Upgraded the pay and consultPayment APIs for the Alipay+ Unified Payment edition of Cashier Payment.

March 31 2022

New

• Added a glossary of terms that are used in Alipay+ for your convenience. For more information, see Glossary.

Fixed

• Fixed the spelling of the following parameters in the Clearing Transaction Report and Clearing Fee Report:

• Updated orignalTransactionRequestId to originalTransactionRequestId.
• Updated feeSettleAmountValue to feeSettlementAmountValue.