Customer, Account and Card Related Errors

Customer, Account and Card-Related Errors

This page provides a comprehensive list of potential error codes that may arise during Customer, Account, or Card validations, whether within the Vault or as determined by the Acquirer or by the Issuer.


PY0002 PY0121 - Card is expired

HTTP Status: 400

Product/s: INVOICE CHECKOUTVAULTPLUGINS

⚠️ Applicable for Card payments only.

This occurs when an expired card is used. You can suggest to the customer to attempt the transaction using a valid and active card. This specific error is determined by the Acquirer.


PY0007 - Invalid token status

HTTP Status: 400

Product/s: VAULT

Please note that tokens are for one-time use only. This error will occur when the token has already been used on a transaction. Please create a new token and retry the transaction.


PY0008 - Token is invalid

HTTP Status: 400

Product/s: VAULT

If the token is unavailable for payment, you will encounter this error. Please verify that the token is not expired or deleted. Kindly retry the transaction using a valid and existing token.

ℹ️ If the error persists even after multiple retries, please escalate the issue to Support by providing any of the following:
-customerId or linkId
-token


PY0021 - Failed to add customer

HTTP Status: 400

Product/s: VAULT

This is a systemic error that occurs when creating a customer record. Please review the mandatory fields for creating a customer and try again.

ℹ️ If the error persists even after multiple retries, please escalate the issue to Support.


PY0023 - Customer does not exist

HTTP Status: 404

Product/s: VAULT

The customerId provided does not exist in the merchant's records. Please ensure that you have provided the correct customerId under your merchant and retry the operation.


PY0024 - Failed to delete customer

HTTP Status: 400

Product/s: VAULT

This is a systematic error in deleting a customer record.

Validate the status of the customer record by calling Retrieve Customer. If it still exists, retry sending another request to delete the customer record.

ℹ️ If the error persists even after multiple retries, please escalate the issue to Support.


PY0025 - Failed to update customer details

HTTP Status: 400

Product/s: VAULT

This is a systematic error in updating Customer details.

Validate the status of the customer record by calling Retrieve Customer. If it exists and details are not modified, retry sending another request to update the customer record.

ℹ️ If the error persists even after multiple retries, please escalate the issue to Support.


PY0026 - Failed to update card details

HTTP Status: 400

Product/s: VAULT

This is a systematic error in updating Card details. Kindly retry the transaction.

ℹ️ If the error persists even after multiple retries, please escalate the issue to Support.


PY0027 - Card does not exist

HTTP Status: 404

Product/s: VAULT

This error happens when the Card token does not exist for the Customer. Validate that the Card token used is not deleted and kindly retry the transaction.


PY0028 - Failed to delete card

HTTP Status: 400

Product/s: VAULT

This is a systematic error in deleting the Card. Kindly retry the transaction.

Validate the Card record by calling Retrieve Card. If it still exists, retry sending another request to delete the card record.

ℹ️ If the error persists even after multiple retries, please escalate the issue to Support.


PY0029 - No card found for customer

HTTP Status: 400

Product/s: VAULT

This error response will be encountered when no Card record is associated with the customer. Please ensure that you have successfully linked a card to this customer record.


PY0030 - Invalid card token status

HTTP Status: 400

Product/s: VAULT

This error will happen if the Card token status is not allowed for payment. Possible reasons are any of the following:

  • Used Card Token
  • Deleted Card Token
  • Linking of Card tokens that is not successful

Kindly retry the transaction and use a valid and existing Card Token.


PY0036 - Card is not supported

HTTP Status: 400

Product/s: INVOICE CHECKOUTVAULTPLUGINS

⚠️ Applicable for Card payments only.

If you encounter this error, it means that the card scheme being used is not supported by the application. Please ensure that you are using one of the supported card schemes, which are MasterCard, Visa, and JCB.


PY0043 - Card already exists

HTTP Status: 400

Product/s: VAULT

This error will happen if the card you are trying to link is already linked to the customer.

Validate the Card record by calling Retrieve Card.


PY0105 - Account has insufficient balance to perform this transaction

HTTP Status: 400

Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS CHECKOUT-QRPHDYNAMIC QRPH

The linked account or the account being used does not have sufficient balance to make the transaction.

You can inform the user that the transaction was declined due to insufficient funds and advise them to cash in before making a transaction.


PY0117 - Card is invalid

HTTP Status: 400

Product/s: INVOICE CHECKOUTVAULTPLUGINS

This error will happen if the card being used is invalid or no longer valid (card BIN is not supported or the card is inactive).

Make sure you are using a valid and active card when making a transaction.


PY0119 - Issuer declined card or account

HTTP Status: 400

Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS CHECKOUT-QRPH

You will encounter this issue when the Issuer rejects any transactions to be made using this card.

Recommend trying with a different card.


PY0120 - Issuer decline

HTTP Status: 400

Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS CHECKOUT-QRPHDYNAMIC QRPH

You will encounter this error when the customer has provided invalid card details (e.g. expired card, or wrong card number).

Recommend trying a different card.


PY0123 - Account limit exceeded

HTTP Status: 400

Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS CHECKOUT-QRPHDYNAMIC QRPH

The linked account or the account being used has reached the maximum number of transactions.

You can inform the user that the transaction was declined due to a limit. They can retry the transaction on the next day or use other accounts.


PY0127 - Please update incomplete customer records

HTTP Status: 400

Product/s: VAULT

You will encounter this error when Fraud protection is enabled and the provided customer details are incomplete.

Make sure to provide the minimum required customer details, as described in Fraud Protection guide, and retry the transaction.


PY0136 - Account or Card is compromised

HTTP Status: 400

Product/s: INVOICE CHECKOUTPAY WITH MAYAVAULTPLUGINS

You will encounter this error when the account is closed and is no longer usable.

You have to unlink the account and ask the user to link another account.