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
PY0002
PY0121
- Card is expiredHTTP 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
PY0007
- Invalid token statusHTTP 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
PY0008
- Token is invalidHTTP 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.
Support by providing any of the following:
If the error persists even after multiple retries, please escalate the issue to
-customerId
orlinkId
-token
PY0021
- Failed to add customer
PY0021
- Failed to add customerHTTP 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
PY0023
- Customer does not exist
PY0023
- Customer does not existHTTP 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
PY0024
- Failed to delete customerHTTP 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
PY0025
- Failed to update customer details
PY0025
- Failed to update customer detailsHTTP 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
PY0026
- Failed to update card details
PY0026
- Failed to update card detailsHTTP 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
PY0027
- Card does not exist
PY0027
- Card does not existHTTP 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
PY0028
- Failed to delete cardHTTP 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
PY0029
- No card found for customer
PY0029
- No card found for customerHTTP 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
PY0030
- Invalid card token statusHTTP 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
PY0036
- Card is not supportedHTTP 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
PY0043
- Card already existsHTTP 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
PY0105
- Account has insufficient balance to perform this transactionHTTP 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
PY0117
- Card is invalidHTTP 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
PY0119
- Issuer declined card or accountHTTP 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
PY0120
- Issuer declineHTTP 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
PY0123
- Account limit exceededHTTP 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
PY0127
- Please update incomplete customer recordsHTTP 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
PY0136
- Account or Card is compromisedHTTP 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.