![PayMaya Developers](https://cdn.paymaya.com/production/devportal/www/images/Logo_Header_v2.png) # PayMaya Payment Gateway - Error Codes Error response are returned in the format ``` { "code": "PY0009", "message": "Payment does not exist.", } ``` Additionally for error 2553 a parameters array is returned with the details of the invalid fields. ``` { "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" } ] } ``` | Http Status | Code | Message | Description | | -------- | -------- | ------- | ---------- | | 400 | 2553 | Missing/invalid parameters. | 400 | PY9999 | Payment Vault is unreachable / timed out. | 400 | PY0001 | A problem is encountered. Please contact your system administrator.' | Generic error please contact support if you encounter this. | 400 | PY0002 | Card is expired. | 400 | PY0007 | Invalid token status. | 400 | PY0008 | Token is invalid. | 404 | PY0009 | Payment does not exist. | 400 | PY0015 | Payment processor server unreachable / timed out. | 400 | PY0016 | Payment processor service error. | 401 | PY0019 | Forbidden. | Your account does not have access to the API. Please contact Fulfillment Team or your Account Manager | 400 | PY0021 | Failed to add customer. | 404 | PY0023 | Customer does not exist. | 400 | PY0024 | Failed to delete customer. | 400 | PY0025 | Failed to update customer details. | 400 | PY0026 | Failed to update card details. | 404 | PY0027 | Card does not exist. | 400 | PY0028 | Failed to delete card. | 400 | PY0029 | No card found for customer. | 400 | PY0030 | Invalid card token status. | 400 | PY0036 | Card is not supported. | 400 | PY0037 | Currency is not supported. | 404 | PY0038 | Webhook does not exist. | 400 | PY0039 | Webhook already exists. | 400 | PY0042 | Charging of subscription is not applicable. | 400 | PY0043 | Card already exists. | 400 | PY0045 | Payment is not available for void. | 404 | PY0046 | Refund does not exist. | 401 | PY0047 | Payment is ineligible for refund. | 400 | PY0048 | Requested refund amount is greater than the original amount. | 404 | PY0049 | Subscription does not exist. | 400 | PY0051 | Failed to update subscription details. | 400 | PY0052 | Failed to cancel subscription. | 400 | PY0053 | Merchant already exists. | 400 | PY0054 | Subscription already charged. | 422 | PY0057 | The payment has expired and cannot be processed. | 403 | PY0058 | The merchant indicated does not have P2M services enabled. | QR functionality is not enabled on the account | 408 | PY0061 | Notification server unreachable / timed out. | 400 | PY0062 | Notification service error. | 404 | PY0063 | Void does not exist. | 400 | PY0064 | Invalid JSON Format. | 400 | PY0065 | This merchant has no customizations present. | 400 | PY0068 | Payment not executed due to authorization failure. | 400 | PY0069 | Authentication server unreachable / timed out. | 400 | PY0070 | Scheme is unsupported by merchant | 400 | PY0071 | Payment mismatch with Merchant. | 400 | PY0072 | Transaction cannot be processed. Cannot refund a transaction before cut off time. | 400 | PY0073 | Transaction cannot be processed. Cannot void a transaction after cut off time. | 400 | PY0082 | Refund already exists. | 400 | PY0085 | Payment must be reversed from terminal. | 400 | PY0088 | Card data already provided | 400 | PY0089 | No card data provided | 400 | PY0090 | Buyer data already provided | 400 | PY0091 | Payment state is invalid for sending webhooks | 400 | PY0092 | Merchant's registered webhook is unreachable | 409 | PY0093 | Payment has already been updated. | 400 | PY0094 | Payment is not available for capture. | 400 | PY0095 | Amount must be less than or equal to amount authorized. | 400 | PY0096 | Amount must be equal to amount authorized. | 200 | PY0100 | Authentication failed. | 200 | PY0101 | Acquirer decline due to high risk. | 400 | PY0102 | Card is required, as there is no Fund Source attached to your account. | 400 | PY0103 | Payment is already expired. | 400 | PY0104 | Reference number is linked to multiple payments. | 400 | PY0105 | Account has insufficient balance to perform this transaction. | 400 | PY0106 | Failed to send notification. | 400 | PY0111 | Invalid batch status. | 400 | PY0112 | QR data is not supported. | 400 | PY0113 | Partial refund is not allowed for this transaction. | 400 | PY0114 | WeChat Service unreachable / timed out. | 400 | PY0115 | WeChat Service error. | 400 | PY0116 | Transaction could not be completed. | 400 | PY0117 | Card is invalid. | 400 | PY0118 | Transaction could not be completed with this terminal. | 400 | PY0119 | Issuer declined card or account. | 400 | PY0120 | Issuer decline. | 400 | PY0121 | Card is expired. | 400 | PY0122 | Issuer system is unavailable. | 400 | PY0123 | Account limit exceeded. | 400 | PY0124 | Transaction could not be verified. | 400 | PY0125 | PIN is invalid or incorrect. | 400 | PY0126 | PIN is invalid or incorrect. | 400 | PY0127 | Please update incomplete customer records.