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

notifyRegistrationStatus

Antom uses this API to send the merchant registration result to the merchant. 

Structure

A message consists of a header and body. The following sections are focused on the body structure. For the header structure, see: 


Note: Set the data type of each field (except array) as String. This means that you must use double quotation marks (" ") to enclose the field value. Examples:

  • If the data type of a field is Integer and its value is 20, set it as "20". 
  • If the data type of a field is Boolean and its value is true, set it as "true". 

Request parameters

referenceMerchantId String  

The secondary merchant ID that is assigned by the acquirer.

More information:

  • Maximum length: 64 characters

registrationRequestId String  

The unique ID used to identify a registration request. 

More information:

  • Maximum length: 64 characters

referenceStoreId String  

The store ID assigned by the acquirer to identify a store, which is associated with the merchant.

More information:

  • Maximum length: 32 characters

registrationResult RegistrationResult  

The wallet registration result information

Show child parameters

pspRegistrationResultList Array<PSPRegistrationResult>  

The registration result from the Alipay+ payment methods (Alipay+ Mobile Payment Provider).

Show child parameters

Response parameters

result Result  REQUIRED

The request result contains information such as status and error codes.

Show child parameters
API Explorer

Request

Request Body

Response

Response Body

Result process logic

Send the following message with fixed values to Antom after receiving the notification, to acknowledge that the notification from Antom is received:

Sample Code

If no such message is returned to Antom due to operation issues or network issues, Antom will intermittently send the notification until the required message is returned by the merchant. Resending of the notification will be performed within 24 hours after the first notification is sent. The notification will be resent up to eight times, with an interval of 0s, 2min, 10min, 10min, 1h, 2h, 6h, and 15h.

Note: In the sandbox environment, if you do not return information in the specified format, Antom will not resend asynchronous notifications to you.

Result/Error codes

CodeValueMessageFurther action
SUCCESSSSuccess

The registration is successful, no further action is needed.