Alipay+ DocsAlipay+ Docs

notifyRegistrationStatusMPP Alipay+

POST /aps/api/v1/merchants/notifyRegistrationStatus

The notifyRegistrationStatus API is used by Mobile Payment Providers (MPPs) to notify Alipay+ of the merchant registration result. MPPs need to integrate this API only if they adopt the Approval Mode and cannot return the registration result synchronously via the registration API. For more information about what the Approval Mode is, see Merchant registration.

Note: In the following sections, MPP is also known as Payment Service Partner (PSP). For example, pspId refers to the unique ID that identifies an MPP. 

Request parameters

referenceMerchantId String  REQUIRED

The unique ID that is assigned by Alipay+ to identify a merchant. 

More information about this field

  • Maximum length: 32 characters

registrationResult RegistrationResult object REQUIRED

The registration result from the MPP. 

Show child parameters

registrationRequestId String  REQUIRED

The unique ID that is assigned by Alipay+ to identify a registration request.

More information about this field

  • Maximum length: 64 characters

Response parameters

result Result object REQUIRED

The result of the business processing, including the result status, result code, and the result message. 

Show child parameters
API Explorer
Sample CodesRun in Sandbox

Request

URL
Request Body

Response

Response Body

More information

How to handle the result

You might receive different results from Alipay+. Follow the instructions below to handle the result.

result.resultStatus

result.resultCode

Notification status

Actions

S

SUCCESS

Notification succeeds.

N/A

F

Multiple possible values exist, such as

ACCESS_DENIED,

KEY_NOT_FOUND, etc.

Notification fails.

Take actions according to the result code (specified on the result.resultCode parameter). For more information, see the Result codes section below.

U

Multiple possible values exist, such as

UNKNOWN_EXCEPTION,

REQUEST_TRAFFIC_EXCEED_LIMIT, etc.

Unknown

Use the same parameters to retry the notifyRegistrationStatus request. If you keep receiving the same result indicating the unknown status, contact connect_support@service.alipay.com.

No result received

Unknown

Use the same parameters to retry the notifyRegistrationStatus request. If you keep receiving no result, contact connect_support@service.alipay.com.

Result/Error codes

CodeValueMessage
SUCCESSSSuccess
ABNORMAL_REGISTRATION_STATUSFThe registration status is abnormal.
ACCESS_DENIEDFAccess is denied.
INVALID_CLIENTFThe client is invalid.
INVALID_SIGNATUREFThe signature is invalid.
KEY_NOT_FOUNDFThe key is not found.
MEDIA_TYPE_NOT_ACCEPTABLEFThe server does not implement the media type that is acceptable to the client.
METHOD_NOT_SUPPORTEDFThe server does not implement the requested HTTPS method.
NO_INTERFACE_DEFFAPI is not defined.
PARAM_ILLEGALFIllegal parameters. For example, non-numeric input, invalid date.
PROCESS_FAILFA general business failure occurred. Do not retry.
REQUEST_TRAFFIC_EXCEED_LIMITFThe request traffic exceeds the limit.
UNKNOWN_EXCEPTIONUAn API call failed, which is caused by unknown reasons.