Payment Related Errors
This page provides a comprehensive list of potential error codes that may arise during the actual payment transaction, determined by either the acquirer or the issuer.
PY0009 PY0076 - Payment does not exist
PY0009 PY0076 - Payment does not existHTTP Status: 404
Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS
If the paymentId provided does not correspond to any existing payment intent, this error will occur. Please verify the payment and ensure that you are passing the correct paymentId.
You can also attempt to retrieve payment details (including the ID) by calling the Retrieve Payment via RRN endpoint to validate your paymentId.
PY0017 - Merchant not found
PY0017 - Merchant not foundHTTP Status: 401
Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS CHECKOUT-QRPHDYNAMIC QRPH
You will encounter this if there is a problem with the configuration of your merchant account.
If the error occurs, please escalate the issue to Support.
PY0019 - Forbidden
PY0019 - ForbiddenHTTP Status: 401
Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS
This error may happen when your merchant profile is not allowed to do a specific request.
Please escalate the issue to your Relationship Manager.
PY0037 - Currency is not supported
PY0037 - Currency is not supportedHTTP Status: 400
Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS
If you encounter this error, it means that the currency used in the payment is not supported by the merchant account. Please note that Maya currently only supports one currency per account, and if you require support for multiple currencies, you will need to request multiple accounts. Please review your transaction request and ensure that you are using the correct currency.
PY0044 - Payment is invalid
PY0044 - Payment is invalidHTTP Status: 400
Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS CHECKOUT-QRPH
Will be encountered when paymentId does not exist.
Make sure you have supplied a correct paymentId and retry again.
PY0045 PY0055 - Payment is not available for void
PY0045 PY0055 - Payment is not available for voidHTTP Status: 400
Product/s: INVOICE CHECKOUTVAULTPLUGINS
You will come across this error if the payment is not eligible for void. Similarly, attempting to void the transaction beyond 12am GMT+8 of the transaction date will also result in encountering this error.
Validate the payment by getting the payment status via Retrieve Payment via ID endpoint.
Kindly also refer to the Manual Capture document for the transition rules.
You may execute and validate voids using the Maya Business Manager.
PY0046 - Refund does not exist
PY0046 - Refund does not existHTTP Status: 404
Product/s: INVOICE CHECKOUTVAULTPLUGINS
You will encounter this error if refundId does not exist.
Validate if you are using a correct refundId and it is not currently deleted, then retry the request.
You may execute and validate refunds using the Maya Business Manager.
PY0047 - Payment is ineligible for refund
PY0047 - Payment is ineligible for refundHTTP Status: 400
Product/s: INVOICE CHECKOUTVAULTPLUGINS
This error can be caused by either of the following reasons:
- The transaction being refunded is not yet eligible according to cut-off rules. Refunds can only be initiated after 12am GMT+8 of the transaction date, which means you may have to wait until the start of the next day.
- The transaction being refunded is older than 180 days.
You may execute and validate refunds using the Maya Business Manager.
PY0048 - Requested refund amount is greater than the original amount
PY0048 - Requested refund amount is greater than the original amountHTTP Status: 400
Product/s: INVOICE CHECKOUTVAULTPLUGINS
This error will occur when the requested amount to refund is greater that the original amount.
Validate your request and make sure your requested refund amount is the same as the original.
You may execute and validate refunds using the Maya Business Manager.
PY0057 - The payment has expired and cannot be processed
PY0057 - The payment has expired and cannot be processedHTTP Status: 422
Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS
You will encounter this error when a transaction exceeds the given time limit.
You can also get and validate the payment status by calling the Retrieve Payment Status.
Once a payment has expired, it cannot be processed any further. If the user still wishes to proceed with the payment, a new payment transaction must be created.
PY0058 - The merchant indicated does not have P2M services enabled
PY0058 - The merchant indicated does not have P2M services enabledHTTP Status: 400
You will encounter this error when P2M service is not activated in your merchant profile.
Please escalate the issue to your Relationship Manager.
PY0063 - Void does not exist
PY0063 - Void does not existHTTP Status: 404
Product/s: INVOICE CHECKOUTVAULTPLUGINS
Will be encountered when no void requests existed for the paymentId provided.
Make sure you have supplied the correct paymentId and retry again.
You may execute and validate voids using the Maya Business Manager.
PY0065 - This merchant has no customizations present
PY0065 - This merchant has no customizations presentHTTP Status: 400
This error may happen from Get or Delete Customizations API. When this is raised, it means that the merchant’s request to Get or Delete is invalid because page customizations are already disabled to begin with. No further action required.
PY0068 - Payment not executed due to authorization failure
PY0068 - Payment not executed due to authorization failureHTTP Status: 400
Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS
This is a systematic error for Authentication. Kindly retry transaction.
If the error persists even after multiple retries, please escalate the issue to Support.
PY0070 - Scheme is unsupported by merchant
PY0070 - Scheme is unsupported by merchantHTTP Status: 400
You will encounter this error when specific card scheme is not enabled in your merchant profile.
Please escalate the issue to your Relationship Manager.
PY0072 - Transaction cannot be processed. Cannot refund a transaction before cut off time
PY0072 - Transaction cannot be processed. Cannot refund a transaction before cut off timeHTTP Status: 400
Product/s: INVOICE CHECKOUTVAULTPLUGINS
Capture payments can only be refunded after the 12am cut-off time.
PY0073 - Transaction cannot be processed. Cannot void a transaction after cut off time
PY0073 - Transaction cannot be processed. Cannot void a transaction after cut off timeHTTP Status: 400
Product/s: INVOICE CHECKOUTVAULTPLUGINS
Authorized payments can only be voided before the 12am cut-off time.
PY0082 - Refund already exists
PY0082 - Refund already existsHTTP Status: 400
Product/s: INVOICE CHECKOUTVAULTPLUGINS
Will be encountered when paymentId already has a refund request.
You may execute and validate refunds using the Maya Business Manager.
PY0093 - Payment has already been updated
PY0093 - Payment has already been updatedHTTP Status: 400
Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS
In rare cases, the error is raised in case concurrent calls to refund a transactions have been issued and the transaction reached a non-refundable state.
PY0094 - Payment is not available for capture
PY0094 - Payment is not available for captureHTTP Status: 400
Product/s: INVOICE CHECKOUTVAULTPLUGINS
Will be encountered when the payment state is not allowed to be captured.
Validate the payment by getting the payment status via
Retrieve Payment via ID endpoint.
Kindly also refer to the Manual Capture document for the transition rules.
PY0095 - Amount must be less than or equal to amount authorized
PY0095 - Amount must be less than or equal to amount authorizedHTTP Status: 400
Product/s: INVOICE CHECKOUTVAULTPLUGINS
This error will occur when the requested amount to capture is greater that the authorization amount.
Refer to Manual Capture and follow the recommended steps.
PY0096 - Amount must be equal to amount authorized
PY0096 - Amount must be equal to amount authorizedHTTP Status: 400
Product/s: INVOICE CHECKOUTVAULTPLUGINS
This error will occur when the requested amount to capture is not equal to the authorization amount.
Refer to Manual Capture and follow the recommended steps.
PY0100 - Authentication failed
PY0100 - Authentication failedHTTP Status: 200
Product/s: INVOICE CHECKOUTVAULTPLUGINS
⚠️ Applicable for Card payments only.
You will encounter this error when user fails to authenticate the request in 3DS.
PY0101 - Acquirer decline due to high risk
PY0101 - Acquirer decline due to high riskHTTP Status: 400
Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS CHECKOUT-QRPH
You will encounter this error when the transaction was suspected to be fraud.
Please escalate the issue to Support by providing any of the following:
-paymentId
PY0103 - Payment is already expired
PY0103 - Payment is already expiredHTTP Status: 400
Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS
You will encounter this error when a transaction exceeds the given time limit.
You can also get and validate the payment status by calling the Retrieve Payment Status.
Once a payment has expired, it cannot be processed any further. If the user still wishes to proceed with the payment, a new payment transaction must be created.
PY0104 - Reference number is linked to multiple payments
PY0104 - Reference number is linked to multiple paymentsHTTP Status: 400
Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS
You will encounter this error when the payment you are trying to process using Reference number is linked to a multiple payment records.
If you intend to process specific payment, you can try calling the endpoints that will use paymentId.
PY0113 - Partial refund is not allowed for this transaction
PY0113 - Partial refund is not allowed for this transactionHTTP Status: 400
Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS
You will come across this error if the payment is not eligible for partial refunds.
Validate the payment by calling Retrieve Payment via ID endpoint.
Kindly also refer to the Manual Capture document for the transition of status and refund rules.
You may execute and validate refunds using the Maya Business Manager.
PY0116 - Transaction could not be completed
PY0116 - Transaction could not be completedHTTP Status: 400
Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS CHECKOUT-QRPH
The operation you are trying to do with the transaction has encountered error.
If the error persists even after multiple retries, please escalate the issue to Support by providing any of the following:
-paymentId
-transactionId
PY0124 - Transaction could not be verified
PY0124 - Transaction could not be verifiedHTTP Status: 400
Product/s: INVOICE CHECKOUTVAULTPLUGINS
⚠️ Applicable for Card payments only.
Reason for this error may vary depends on the 3DS verification.
PY0137 - Decline due to high risk
PY0137 - Decline due to high riskHTTP Status: 400
Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS
You will encounter this error when the transaction was suspected to be fraud.
Please escalate the issue to Support by providing any of the following:
-paymentId
PY0138 - Acquirer decline
PY0138 - Acquirer declineHTTP Status: 400
Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS
You will encounter this error when the transaction was suspected to be fraud.
Please escalate the issue to Support by providing any of the following:
-paymentId
PY0146 - Login cancelled by user
PY0146 - Login cancelled by userHTTP Status: 200
Product/s: PAY WITH MAYA
You will encounter this error when customer decides to cancel the request during user login.
| Error Code ( code) | HTTP Status | Description ( message) | What to do? |
|---|---|---|---|
| PY0065 | 400 | This merchant has no customizations present. | |
| PY0070 | 400 | Scheme is unsupported by merchant | |
| PY0100 | 200 | Authentication failed. | |
| PY0146 | 200 | Login cancelled by user. |