Error Codes
February 14, 2023 at 10:38 AMA Pay’nUP API operation can return multiple error and warning codes. Error codes and associated messages are sorted in ascending order by error code number.
While the text for an error message may change, the codes will stay the same. Error handling on clients should be done using ONLY the Error Codes. The message string should be subject to change without prior notice.
| Code | Text | Description |
|---|---|---|
| 400 | Bad Request | The request was invalid or cannot be otherwise served. |
| 401 | Unauthorized | Missing or incorrect authentication credentials. This may also returned in other undefined circumstances. |
| 403 | Forbidden | The request is understood, but it has been refused or access is not allowed. |
| 404 | Not Found | The object requested is invalid or does not exist. |
| 409 | {Variable Conflict Message} | The request could not be completed due to a conflict or error. This error message always should be displayed to final users to take some action. This code is used in situations where the user might be able to resolve the conflict and resubmit the request. |
| 422 | Unprocessable Entity | Validation Error. These errors contains a key “constraintViolations” with all violations. |
| 500 | Internal Server Error | Something is broken. This is usually a temporary error, for example in a high load situation or if an endpoint is temporarily having issues. |
| 1100 | Unprocessable Transaction | The transaction can’t be processed at this moment doe to a system failure, downtime or other issues. Try again later, if the problem persists contact customer support. |
| 1101 | Insufficient Funds | The account does not have sufficient funds to do the requested operation. |
| 1102 | Duplicate Transaction | The system already have a transaction with the same values. To avoid this error ensure pass a unique correlation ID with each transaction. |
| 1103 | Denied Transaction | The transaction has been denied based on security settings or is considered suspicious of possible charged-back. |
| 1104 | Two Factor Auth is required to complete this operation. | This error happen when try to do some operation but need 2FA to proceed. |
| 1105 | Two Factor Authentication failed. | This error happen when submit invalid PIN or token to do a 2FA. |
| 1106 | Two Factor Auth Token and PIN has been expired. | Must request a new PIN and token to submit with 2FA. |
| 1107 | Provide a valid username/customerToken & password to send a verification code. | You are trying to send a Two Factor Authorization code using a service that require a valid user password. |
| 1200 | Invalid Product | The product you are try to use is not valid. |
| 2100 | Service Provider Unavailable | The third party service used to process the transaction is not available or not working as expected. |
| 2101 | Invalid Provider Product | The product you are trying to use does not exist in the service provider. |
| 2102 | {Variable Provider Error Message} | A error happen during the process of the service in the third party service. The error message always contains the reason why the provider could not make the transaction. |
| 2151 | Invalid PIN | The given PIN is not a valid PIN or is already used. |
| 2152 | Invalid PIN Amount | PIN does not match with given amount. The amount must match with the original purchased product price. |
| 2153 | Partial Redemption Not Allowed | Given PIN does not support partial redemption. |
| 2154 | Insufficient PIN Balance | The amount to redeem is greater than current PIN balance |
| 2201 | Invalid Verifone Terminal | Provided terminal number is not valid. |
| 2202 | Invalid Verifone Activation Code | Provided activation code is not valid for given terminal. |
| 2203 | Invalid Verifone Serial Number | Device serial number is not valid or not allowed for given terminal. |
| 2204 | Invalid Verifone Ani | Ani is not valid or not allowed for given terminal. |
| 2205 | Invalid Terminal Type | The terminal you are trying to active is already activated with other device type. In this case the field terminalType must match with any other previously activated device in the given terminal. |
| 2300 | Already exist a customer registered with given email or phone. | This error happen when try to register a customer with existing email or phone. In these cases must use the password recovery functionality. |
| 2301 | Bank verification process fails. | This error happen when try to register a customer with invalid personal information like name, SSN,email or phone. |
| 2500 | Unsupported Payment Method | The payment method you are trying to use is not supported by this merchant. |
| 2501 | {Variable Payment Gateway Error} | A unknown error happen during the payment process. This error message contain the original message from gateway, others specific Payment Gateway errors are described below with error number 25XX. |
| 2502 | Consumer Authentication Failed | A unknown error happen during the 3D Authorization process. This error message contain the original message from processor, others specific 3D secure errors are described below with error number 25XX. |
| 2503 | Credit Card is not verified | The credit card is not verified and can’t be accepted. If you receive this error must use our credit card verification tool and submit the transaction again after verify the credit card. |
| 2504 | Your card has been temporary blocked | The credit card is locked for a certain period of time due to invalid verification process or possible CB. |
| 2510 | This transaction has been declined by your Issuing Bank | Payment Gateway Error Customers make sure the credit card number, expiration date or card code (CVV) entered is correct. |
| 2511 | This transaction needs a verbal authorization by issuer. | Payment Gateway Error Customer needs call the phone number on the back of the card to proceed with the transaction. |
| 2512 | This Card has been reported lost or stolen. | Payment Gateway Error Customers need try another credit card. |
| 2513 | Your bank has declined this transaction due to an address mismatch | Payment Gateway Error Customer make sure the Billing address and Zip Code information entered is correct. |
| 2514 | This transaction has been declined due to Card Code (CVV) mismatch. | Payment Gateway Error Customer make sure the Card Code (CVV) entered is correct. |
| 2515 | Credit card expiration date is invalid. | Payment Gateway Error Customers needs verify the exp date of credit card is valid or the credit card is not expired. |
| 2516 | The Credit Card Number in Invalid. | Payment Gateway Error Customers make sure the credit card number entered is correct |
| 2517 | This transaction has been declined due to insufficient funds in the customer account. | The customer need add more funds to his eWallet account to accept this payment. |
| 2550 | Cardholder is not enrolled, or Issuing Bank is not participating in 3D Secure. | Consumer Authentication Failed The customers need try with a card enrolled in 3D secure. |
| 2551 | 3D Secure Bypassed | Consumer Authentication Failed Due to rules in place, 3D Secure is being bypassed. |
| 2552 | 3D Secure service not available | Consumer Authentication Failed Cardholder is enrolled, but issuing bank is not available or having issues preventing cardholder from entering bank password. The customer can try again in a few minutes |
| 2553 | Denied Payer Authentication | Consumer Authentication Failed Cardholder is enrolled, but bank password is entered incorrectly. |
| 2554 | Untrusted Payer Authentication | Consumer Authentication Failed Cardholder is enrolled, enters in bank password correctly but the PARes (Payer Authentication Response) cannot be trusted. |