🚩 Ran into an error response when you created the transaction? Refer to the error handling section below.
Response Codes
We use the following HTTP status code in the response depending on the success or failure:
| Status Code | Description |
|---|---|
| 201 - ✅ Success | Request successfully processed/created. |
| 202 - ✅ Success | Request accepted, further action required. |
| 400 - ❌ Bad Request | The request was unacceptable. |
| 401 - ❌ Unauthorized | No valid API key provided. |
| 403 - ❌ Forbidden | You don't have permissions to perform the request. |
| 404 - ❌ Not Found | The requested resource doesn't exist. |
| 422 - ❌ Unprocessable Entity | Pay API has failed to process the request. |
| 429 - ❌ Too Many Requests | Too many requests hit the API too fast. |
| 500 - ❌ Internal Server Error | Something went wrong on Pay system. |
Error Troubleshoot
Here is our recommendation in terms of handling errors:
400 - Bad Request
💣 Cause: This error occurs because of Invalid syntax or missing a required parameter.
🛠 Suggestion: Recheck the request that you input. Make sure it has followed the requirements.
401 - Unauthorized
💣 Cause: This error occurs when you try to make an API call using incorrect Pay API credentials.
🛠 Suggestion: Please check your access token or renew the API key if necessary.
403 - Forbidden
💣 Cause: This error occurs when you're not allowed to access the requested page.
🛠 Suggestion: Double-check the URL and make sure you input an actual web page file name and extension.
404 - Not Found
💣 Cause: This error occurs because you provided the wrong URL, or the ID you requested is not associated with any transactions in Pay.
🛠 Suggestion: Use the correct URL (check for typos and our API documentation carefully).
422 - Unprocessable Entity
💣 Cause: This error happens due to invalid data/entity.
🛠 Suggestion: Check that all reference IDs are valid and ensure that the record exists.
429 - Too Many Requests
💣 Cause: This error happens when the user has sent too many requests in a given time or has reached the rate limits.
🛠 Suggestion: Please wait for a bit and retry, or try to use caching.
500 - Internal Server Error
💣 Cause: This error occurs when Pay has encountered an internal system error.
🛠 Suggestion: You can retry later. Please reach out to our support page below if you keep getting this error.
📧 Need some help?
If you encounter errors such as bugs or require assistance, please contact our email support: [email protected]. Provide us with the description of the errors and the image of screen records, if possible. We will help you to resolve the problems.