Payment method action callback

After creating the payment method and the client performing information validation, the AppotaPay system calls back the results of the requires action to the partner.

Note

• Using the signature parameter to check the integrity of the received data, the partner creates a signature from the data received by AppotaPay and then compares it with the signature parameter sent by AppotaPay.

Redirect

AppotaPay will send the results via the API URL. The partner's URL has been sent to the API via the successReturnUrl và failureReturnUrl parameters. The partner's server checks the data integrity via the signature parameter and then updates the status of the payment method.

Request params

Method: GET

Param	Type	Description
data	String	Transaction information is encode with base64encode & json_encode format
signature	String	Signature to check data signature = HMAC_SHA256(data, secretKey)
time	String	Response time

Decode

1. Partners use the Base64Decode function to decode data in string form.
2. Use the JSON_Decode function to decode the data a second time in json form.

Param	Required	Type	Description
action	Required	Object	Action: AUTH
paymentMethodId	Required	String	Payment Method ID
status	Required	String	Status when performing requires action - PENDING: processing action - VERIFIED: requires action is performed successfully - FAILED: requires action is performed unsuccessfully
errorCode	Required	Integer	Error code
errorMessage	Required	String	Error message