Common errors

1. Error Code -2: APPID_INVALID

• Missing or misspelled app_id. Correct: app_id. Wrong appid: appId, Appid,...

2. Error Code -53: HMAC_INVALID, when creating an order

• Missing or misspelled required params, see more at here

• Wrong Mac Key (Key1), or wrong param to create mac param, see more at here

3. Error Code -54: TIME_INVALID, when paying

The payment period is invalid (though it may have just been created).

• param app_time get it incorrectly according to unix timestamp in milisecond

• The time to create orders is more than 15 minutes from the time of payment

• Merchant's computer clock is wrong

4. Error Code -68: DUPLICATE_APPTRANSID, when paying

• This order has been paid, or has been with a previous order. app_trans_id must be unique

5. Error Code -92: APPTRANSID_INVALID, when paying

• Param app_trans_id is not in the right format, the right format must start with yymmdd of the current day
• yyMMdd is not correct TimeZone Vietnam (GMT+7) (Because of cross check transactions is in Vietnam time and date)

6. Error Code -49: TRANS_INFO_NOT_FOUND, when getting order's status

The transaction has not been made or may have been successfully performed but the following situations may occur:

• Calling Get order's status API in handle callback function, this time the transaction is still in the processing state (is_processing=true). Call after response callback to get the FINAL status of the transaction. However, when the callback is received as a successful transaction, there is no need to call the get order's status API anymore.

• Call Get order's status API after 48h since ZaloPay created transaction. The transaction is valid only within 48 hours. If after 48 hours you need to check the status of a transaction, use the Merchant Tool https://mc.zalopay.vn/home

Hotline: 1900 54 54 36

| Email: hotro@zalopay.vn