Online Payment Errors

Acquire a better understanding of Maya's Payment error codes and their resolution methods to ensure appropriate management of errors.

Maya Payment Solutions adopts a RESTful architecture and relies on HTTP responses and codes to notify clients about the outcome of their successful requests.

Error responses are returned in JSON format:

{
    "code": "PY0009",
    "message": "Payment does not exist.",
}

ℹ️ Error Code: 2553

If an error with a 2553 code appears in the response body, there will be a parameter object - an array of object containing information about the invalid fields for other errors.

JSON

{
    "code": "2553",
    "message": "Missing/invalid parameters.",
    "parameters": [
        {
            "description": "value must be a number",
            "field": "totalAmount.value"
        },
        {
            "description": "A valid currency is required.",
            "field": "totalAmount.currency"
        }
    ]
}

Error Codes

Error codes, which are alphanumeric, are associated with certain errors and are integral to the suggested error management procedures.

List of Error Codes

• Authentication and API Key Errors
• Payment Related Errors
• Customer, Account, and Card Related Errors
• Direct Pay with Maya Errors
• QRPh Related Errors
• Other Payment Errors