Alipay, China's leading third-party online payment solutionAlipay, China's leading third-party online payment solution

Release Notes

Time

Version

Content

2024-10-24

1.0.16

  • Added various samples of request and response reports for validateTransfer section.
  • Optimized link redirection for Going live in the Integration process section.

2024-11-01

1.0.17

  • Added the description of the procedural steps for integration, including onboarding guidelines and checklists for each node of the workshop/UAT/PVT/Go-live within Intergration Process section.
  • Optimized the CN | C2C reports within validateTransfer interface.
  • Optimized the issue of inconsistent capitalization in titles.
  • Added the guidance of providing evidence documents whereby the declaration is requested for funding collection within User Experience-Inbound China section.

2024-11-07

1.0.18

  • Updated Alipay Global Detailed Error Code List in Integration Process > UAT Check List.
  • Updated the official emails for the post-launch service contact teams in Integration Process > Go-live Check List.
  • Optimized sample request report in validateTransfer | CN | Bank, increasing the required field - beneficiary.userAddress.region in the request report.

2024-11-08

1.0.19

  • Validate_BD_Wallet & Transfer_BD_Wallet (BD0001)

       2% government incentive has been modified with 2.5% government incentive in Best Practice > Transaction purpose and limit.

  • Enum values including TransferPurposeType, FundSourceType, LanguageType, OccupationType, RelationshipType have been added to Data Dictionary part.
  • Optimized the document suffix for each regional interface by adding the interface name (validate/transfer) within the suffix. (For example, cn_wallet_c2c to validate_cn_wallet_c2c)

2024-11-22

1.0.20

  • Updated the response reports within Validate|CN|B2C.
  • Updated the content of Outstanding Balance File and Transfer Transaction File in How to Read the Guide > Files and Reconciliation.
  • Deleted result codes of intermediate status in validateTransfer and its subdocuments, as well as updated content of some result codes.

2024-12-26

1.0.21

  • Completed the desensitization of test case data in request reports in validate|CN|Bank and transfer|CN|Bank, where payer.firstName and payer.lastName are updated as required fields.
  • Either payer.userAddress.address1 or payer.certificate shall be provided in transfer|CN|wallet_C2C.
  • payer.userAddress.address1 has been updated as a required field in validate|CN|wallet_B2C and transfer|CN|wallet_B2C.
  • beneficiary.fullName has been updated as a required field both CN validate and transfer API in the documentation for remittances into China C2C and B2C.
  • The beneficiary field from the response reports has been removed in the validation API.
  • Updated the configuration of the object field types.
  • Max monthly frequency has been updated as 15 times for remittance purpose as FAMILY_SUPPORT and SALARY in CN validate and transfer API for remittances into China wallet C2C and B2C.
  • The payer field has been updated as a required field in validate|CN|wallet_B2C.
  • Added a description for the transferPurpose field in transfer|MY Bank.
  • Updated the length of the result code field in the response reports to 64 characters.
  • Added bank card receipt methods to the validateTransfer main documentation.
  • Updated the length limit of quotePrice as number (0,20) in inquiryPrice API.

2025-01-17

1.0.22

  • Supplemented the response report of inquiryBalance API.

2025-02-13

1.0.23

  • Added beneficiaryReceiptMethod field, which is used to differentiate the receipt method of beneficiary in the section of Transfer Transaction File and Fee Reconciliation File.
  • Added three fields - reverseFromAmount, reverseToAmount, and reverseQuote in section of notifyReverse.
2025-04-031.0.24
  • transfer API: Tile existing 19 EMQ services and 18 Terrpay channel services;
  • validateTransfer API: Tile existing 9 services and add 16 Terrpay channel services;
  • notifyReverse API：update the latest sample code.

2025-04-11

1.0.25

  • validaTransfer API：
  1. update the latest sample code in CN（Wallet&bank）、BD&ID&PH（Wallet）;
  2. modify payer parameter in validateTransfer | CN | CNY | Wallet_B2C to required;
  • transfer API：

   1.update the latest sample code in CN、BD、ID、PH;

   2.modify the default value of businessScope in transfer | CN | CNY | Wallet B2C sample.

Historical Records

Time

Content

2021-05-06

Updated best practice to include new infor for transferPurpose.

Updated the request sample in transfer interface.

Added 1 enum field, SubTransferPurposeType in data dictionary.

Added 1 field, subTransferPurpose to AdditionalTransferDetails.

Added 2 values to enum field, TransferPurposeType.

2021-05-12

Updated best practice to include new info for transferPurpose.

Updated the request sample in transferValidate interface.

Added transferPurpose and subTransferPurpose to transferValidate interface.

2021-05-24

Updated data dictionary, CertificateType.

2021-06-02

Updated request samples for transferValidate interface.

2021-06-11

Added a new interface registerTransferUser.

Added two optional fields transferUserId and sourceType to User.

Added sourceType to data dictionary.

Added hasDefaultCard to the response fileds of validateTransfer interface.

2021-07-29

Added a new interface inquiryPrice.

Added two samples for requests with transferUserId to validateTransfer interface and transfer interface.

2021-09-18

Added 3 new error codes to interface inquiryPrice.

2022-01-27

  • Updated the description of Main flow -- Liquidity.
  • Updated the API workflow image for Reversal result notification.
  • Updated the description of fxTrade API -- quoteRetrieveType.
  • Added a result code, AMOUNT_EXCEED_LIMIT to the notifyFxTrade and inquiryFxTrade API.
  • Updated the Best practice chapter.
  • Removed the reverseNotify API.
  • Udpated the FAQ chapter.
  • Removed the test case reference.
  • Updated the complianceResult parameter.
  • Udpated the samples of validateTransfer, inquiryTransfer, and notifyTrasnfer API. Removed the samples about promotions.
  • Added the result code and result message of complianceResult in the inquiryTransfer and notifyTrasnfer API

2022-03-29

  • Added a sample for the fxTrade API where fxTradeSide=BUY.
  • Added a sample for the inquiryQuote API where the Payer Agent sends the quote inquiry request to Alipay+ with buyAmount.

2022-06-17

  • Removed the below error codes of API Result Code

TRANSACTION_NOT_IN_WINDOW

CANCEL_WINDOW_EXCEED

ORDER_IS_REVERSED

  • Added description of request parameters to validateTransfer and transfer API.
  • Added best Practice to inquiryPrice API.
  • Removed 'transfer to bankAccount through e-wallet' from the best practice part.
  • Removed subTransferPurpose other_service from the 'data dictionary' part.
  • Added the fxtrade window to fxtrade API and changed the window to 5*24.
  • Modified the sample request payload of validateTransfer and transfer API.
  • Removed reverse record from the reconciliation report samples.
  • Changed the sample currency code from PHP to CNY, HKD to USD of transfer transaction report.
  • Added 'How to read the API document' before the main flow part.
  • Added maximum pending windows for U scenarios of inquiryTransfer API.
  • Updated the request conditionality of cancelTransfer API.
  • Added pending windows to inquiryTransfer API.

2022-08-04

Optimized some sentences with gramatical problems.

Added description of the promotion fields to Data Dictionary and transfer API parts

2022-08-09

Added the enums of externalCouponType to Data Dictionary and transfer API parts.

2022-12-27

  • Added B2C relevant parameters or enumerics like bizSceneType , userWebSIte,userType to bestPractice, validateTranfer,transfer,dataDictionary and so on.
  • Delete reverseNotify API.
  • Modified the remittance limitation description and included the collection quotas of to-wallet balance channel.
  • Modified the user experience to bestPractice.
  • Deleted the FAQs related to the bank card solution.
  • Updated the error code list for customer service team.

2023-11-20

  • Added Funds flow for post-funding mode to overview part；
  • Modified the transferPurpose and subTransferPurpose for B2C scenario in BestPractice and transfer parts；
  • Preparations added The key pair format ( Python/C/PHP/Java)；
  • Modified Data dictionary-QuoteBizType, delete "TRANSFER" type ,added "C_TRANSFER"(used for post-funding)；
  • InquiryQuote api added post-funding sample code；
  • Modified FX and funding transfer window, and changed fxTradeAmount minimum value to be 100；
  • Modified validateTransfer and Transfer api transferFromAmount and instructedAmountType about postfunding, added postfunding sample code to transfer API；
  • Modified the FAQs about Beneficiary fails to confirm the receipt-method, AMOUNT_EXCEED_LIMIT, fx-Trade performing window.

@2025 Alipay