Standard Numeric Response Codes
| Code | Message | Meaning |
|---|---|---|
| 05 | NO EXISTING HOST | The host system does not exist or is unreachable. |
| 05 | FEES N/A PROFILE | Fee settings are missing or misconfigured in the merchant profile. |
| 05 | STMT/TXN INPRGRS | A settlement or transaction is still being processed. |
| 05 | NO ORIGINAL TXN | The original transaction reference is missing or invalid. |
| 05 | INCAUTH N/A AMEX | Incomplete or unavailable AMEX authorization. |
| 14 | INVALID YEAR | The card's expiration year is incorrect or not accepted. |
| 14 | INVALID MONTH | The card's expiration month is incorrect or not accepted. |
| 91 | HOST NO RESPONSE | The acquiring host did not respond. |
| 35 | GATEWAY KEY ERR | Error with the encryption key used for secure gateway communication. |
Transaction Decline Codes for iPOS S.A.F.E Risk Rules
Click here (opens in a new tab) to learn the full definition of each risk rule
| Code | Message | Meaning |
|---|---|---|
| R02 | R02 RISK FLAGGED | Too many transactions or declines using cards that share the same BIN within a short time. BIN is blocked to prevent abuse. |
| R03 | R03 RISK FLAGGED | High number and percentage of declined transactions within a short time — TPN is deactivated due to suspicious activity. |
| R04 | R04 RISK FLAGGED | Transaction volume for the current open batch has reached its daily limit. No new sales are allowed until the batch is closed. |
| R05 | R05 RISK FLAGGED | The daily limit for manual refunds was exceeded — either in total amount or number of refunds. |
| R06 | R06 RISK FLAGGED | A sale transaction exceeded the maximum amount allowed for this terminal. |
| R07 | R07 RISK FLAGGED | A manual refund exceeded the allowed limit for this terminal. |
| R08 | R08 RISK FLAGGED | Daily EMV fallback limit reached. Further fallback transactions are blocked to prevent fraud. |
| R09 | R09 RISK FLAGGED | International card transactions are not allowed for this terminal. |
| R10 | R10 RISK FLAGGED | Too many transactions attempted using any cards (not limited to a BIN) in a short time. TPN is blocked to prevent bot-based attacks. |
| R11 | R11 RISK FLAGGED | Refunds to international cards are restricted. Only domestic card refunds are allowed on this terminal. |
| R12 | R12: INVALID CVV | The CVV code didn’t match the card. The transaction was declined and automatically voided. |
| R12 | R12: INVALID ZIP | The ZIP code didn’t match the billing address. The transaction was declined and automatically voided. |
Processor Response Codes & Messages
TSYS
| Response Codes | Response Messages | Processor Response Definition | Meaning |
|---|---|---|---|
| 00 | APPROVAL | Approved and completed | Transaction approved and successfully completed. |
| 01 | CALL | Refer to issuer | Refer the cardholder to the issuer. |
| 02 | CALL | Refer to issuer-Special condition | Refer the cardholder to the issuer for a special condition. |
| 03 | TERM ID ERROR | Invalid Merchant ID | Invalid Merchant ID. |
| 04 | HOLD-CALL | Pick up card (no fraud) | Lost card used to perform the transaction. Requesting the merchant to retain the card, but with no suspicion of fraudulent activity. |
| 05 | DECLINE | Do not honor | Transaction was declined by the processor. |
| 06 | ERROR | General error | General error. |
| 07 | HOLD-CALL | Pick up card, special condition (fraud account) | Lost card used to perform the transaction. Suspicion of fraud account. |
| 08 | APPROVAL | Honor Mastercard with ID | |
| 10 | PARTIAL APPROVAL | Partial approval for the authorized amount returned in Group III version 022 | Partial approval granted for the authorized amount returned in Group III version 022. |
| 11 | APPROVAL | VIP approval | Transaction approved with VIP status. |
| 12 | INVALID TRANS | Invalid transaction | Invalid transaction. |
| 13 | AMOUNT ERROR | Invalid amount | The amount is invalid. |
| 14 | CARD NO. ERROR | Invalid card number | The card number is invalid. |
| 15 | NO SUCH ISSUER | No such issuer | The issuer does not exist. |
| 19 | RE ENTER | Re-enter transaction | Packet Format Error. Re-enter the transaction. |
| 21 | NO ACTION TAKEN | Unable to back out transaction | Unable to cancel the transaction. |
| 25 | NO CARD NUMBER | Unable to locate the account number | The account number could not be found. |
| 28 | NO REPLY | File is temporarily unavailable | Transaction timed out with no response from the issuer. |
| 30 | MSG FORMAT ERROR | Transaction was improperly formatted | The transaction format is incorrect. |
| 39 | NO CREDIT ACCT | No credit account | Credit card is not supported. |
| 41 | HOLD-CALL | Lost card, pick up (fraud account) | Lost card used to perform the transaction. Suspicion of fraud account. |
| 43 | HOLD-CALL | Stolen card, pick up (fraud account) | Card used to perform the transaction is stolen. Suspicion of fraud account. |
| 46 | CLOSED ACCOUNT | Closed account | The cardholder's bank account has been closed. |
| 51 | DECLINE | Insufficient funds | The transaction was declined because there were insufficient funds in the cardholder's bank account. |
| 52 | NO CHECK ACCOUNT | No checking account | The account is invalid. |
| 53 | NO SAVE ACCOUNT | No savings account | The account is invalid. |
| 54 | EXPIRED CARD | Expired card | The card has expired. |
| 55 | WRONG PIN | Incorrect PIN | Incorrect PIN used during the transaction. |
| 57 | SERV NOT ALLOWED | Transaction not permitted-Card | The transaction is not permitted for this card. |
| 58 | SERV NOT ALLOWED | Transaction not permitted-Terminal | The transaction is not permitted on this terminal. |
| 59 | SUSPECTED FRAUD | Suspected fraud | Suspected fraud account. |
| 61 | EXC APPR AMT LIM | Exceeds approval amount limit | The transaction amount has exceeded the approved amount limit. |
| 62 | DECLINE | Invalid service code, restricted | The transaction was declined due to an invalid or restricted service code. |
| 63 | SEC VIOLATION | Security violation | Transaction violates SEC (Securities and Exchange Commission) laws. |
| 65 | EXC W/D FREQ LIM | Exceeds withdrawal frequency limit | The transaction withdrawal has exceeded the withdrawal frequency limit. |
| 6P | VERIF DATA FAILD | Verification data failed | Data verification has failed. |
| 75 | PIN EXCEEDED | Allowable number of PIN-entry tries exceeded | PIN Entry limit has been exceeded. |
| 76 | UNSOLIC REVERSAL | Unable to locate, no match | Unable to locate the original transaction and so the transaction cannot be reinitiated. |
| 77 | NO ACTION TAKEN | Inconsistent, reversed, or repeat data | Unable to process the transaction request, and no action has been taken. |
| 78 | NO ACCOUNT | Blocked, first used transaction from new cardholder, and card not properly unblocked | First transaction from a new cardholder failed due to the card not being properly activated or unblocked by the issuer. |
| 79 | ALREADY REVERSED | Already reversed at switch | Transaction has already been reversed by switch. |
| 80 | NO IMPACT | No Financial impact (used in reversal responses to decline originals) | This response indicates there was no financial impact, typically used in reversal scenarios where the original transaction was declined. |
| 81 | ENCRYPTION ERROR | Cryptographic error | Card data error. Encryption was unsuccessful. |
| 82 | INCORRECT CVV | CVV data is not correct Or Offline PIN authentication interrupted | The CVV data is incorrect or the offline PIN authentication was interrupted. |
| 83 | CANT VERIFY PIN | Cannot verify PIN | Cannot verify the PIN used during the transaction. |
| 85 | CARD OK | No reason to decline | The card is okay and there is no reason to decline the transaction. |
| 86 | CANT VERIFY PIN | Cannot verify PIN | Unable to verify the PIN. |
| 91 | NO REPLY | Issuer or switch is unavailable | No reply. Either the card issuer or switch is unavailable at the moment. |
| 92 | INVALID ROUTING | Destination not found | Destination not found. |
| 93 | DECLINE | Violation, cannot complete | Transaction declined. Refer to TSYS processor for further information. |
| 94 | DUPLICATE TRANS | Unable to locate, no match | A duplicate reversal was attempted on an already reversed authorization. |
| 96 | SYSTEM ERROR | System malfunction | System has malfunctioned. |
| A1 | ACTIVATED | POS device authentication successful | The POS (Point of Sale) device has been successfully activated and is ready to use. |
| A2 | NOT ACTIVATED | POS device authentication not successful | The POS device could not be activated; the authentication failed. |
| A3 | DEACTIVATED | POS device deactivation successful | The POS device has been successfully deactivated and is no longer in use. |
| A8 | INVALID REGION CODE | Region code not valid | Region code is invalid. |
| A9 | INVALID COUNTRY CODE | Country code not valid | Country code is invalid. |
| B1 | SRCHG NOT ALLOWD | Surcharge amount not permitted on debit cards or EBT food stamps | A surcharge amount is not allowed on debit cards or EBT food stamp transactions. |
| B2 | SRCHG NOT ALLOWD | Surcharge amount not supported by debit network issuer | Surcharge amount is not supported by the debit card issuer's network. |
| CV | FAILURE CV | Card Type Verification Error | Transaction failed due to a CV card type verification error. This means the processor could not verify the card type based on the CV (Card Verification) information, causing the transaction to fail. |
| D3 | SECUR CRYPT FAIL | Transaction failure due to missing or invalid 3D-Secure cryptogram | Transaction failed due to a missing or invalid 3D-Secure cryptogram. This means the processor couldn't verify the security information required for the transaction, resulting in a failure. |
| E1 | ENCR NOT CONFIGD | Encryption is not configured | Encryption is not configured. |
| E2 | TERM NOT AUTHENT | Terminal is not authenticated | The terminal is not authenticated. |
| E3 | DECRYPT FAILURE | Data could not be decrypted | The data could not be decrypted. |
| EA | ACCT LENGTH ERR | Verification error | Verification failed because the account number length is incorrect. |
| EB | CHECK DIGIT ERR | Verification error | Verification failed due to an invalid check digit in the account number. |
| EC | CID FORMAT ERROR | Verification error | Verification failed because the CID (Card Identification Data) is in the wrong format. |
| H1 | SERV NOT ALLOWED | Contact Merchant Services/Technical Support | The service is not allowed; please contact Merchant Services or Technical Support for assistance. |
| H2 | SERV NOT ALLOWED | Contact Merchant Services/Technical Support | The service is not allowed; please contact Merchant Services or Technical Support for assistance. |
| H3 | SERV NOT ALLOWED | Contact Merchant Services/Technical Support | The service is not allowed; please contact Merchant Services or Technical Support for assistance. |
| H4 | SERV NOT ALLOWED | Contact Merchant Services/Technical Support | The service is not allowed; please contact Merchant Services or Technical Support for assistance. |
| H5 | SERV NOT ALLOWED | Contact Merchant Services/Technical Support | The service is not allowed; please contact Merchant Services or Technical Support for assistance. |
| H6 | SERV NOT ALLOWED | Contact Merchant Services/Technical Support | The service is not allowed; please contact Merchant Services or Technical Support for assistance. |
| H7 | SERV NOT ALLOWED | Contact Merchant Services/Technical Support | The service is not allowed; please contact Merchant Services or Technical Support for assistance. |
| H8 | SERV NOT ALLOWED | Contact Merchant Services/Technical Support | The service is not allowed; please contact Merchant Services or Technical Support for assistance. |
| H9 | SERV NOT ALLOWED | Contact Merchant Services/Technical Support | The service is not allowed; please contact Merchant Services or Technical Support for assistance. |
| HV | FAILURE HV | Hierarchy Verification Error | Transaction failed due to a hierarchy verification error, meaning the system could not verify the required hierarchical data for the transaction. |
| K0 | TOKEN RESPONSE | Token request was processed | The token request was successfully processed. |
| K1 | TOKEN NOT CONFIG | Tokenization is not configured | Tokenization has not been set up or configured. |
| K2 | TERM NOT AUTHENT | Terminal is not authenticated | The terminal could not be authenticated. |
| K3 | TOKEN FAILURE | Data could not be de-tokenized | The data could not be de-tokenized (converted back to the original data). |
| M0 | DOM DBT NOT ALWD | Mastercard: Canada region-issued Domestic Debit Transaction not allowed | Mastercard transactions from the Canada region for domestic debit are not allowed. |
| N3 | CACHBACK NOT AVL | Cash back service not available | Cashback service is not available for this transaction. |
| N4 | DECLINE | Exceeds issuer withdrawal limit | The transaction was declined because it exceeds the issuer's withdrawal limit. |
| N7 | CVV2 MISMATCH CVV2 | Value supplied is invalid | The CVV2 value provided does not match the one on file. |
| P0 | SERV NOT ALLOWED | Contact Merchant Services/Technical Support | The service is not allowed; please contact Merchant Services or Technical Support for assistance. |
| P1 | SERV NOT ALLOWED | Contact Merchant Services/Technical Support | The service is not allowed; please contact Merchant Services or Technical Support for assistance. |
| P2 | SERV NOT ALLOWED | Contact Merchant Services/Technical Support | The service is not allowed; please contact Merchant Services or Technical Support for assistance. |
| P3 | SERV NOT ALLOWED | Contact Merchant Services/Technical Support | The service is not allowed; please contact Merchant Services or Technical Support for assistance. |
| P4 | SERV NOT ALLOWED | Contact Merchant Services/Technical Support | The service is not allowed; please contact Merchant Services or Technical Support for assistance. |
| P5 | SERV NOT ALLOWED | Contact Merchant Services/Technical Support | The service is not allowed; please contact Merchant Services or Technical Support for assistance. |
| P6 | SERV NOT ALLOWED | Contact Merchant Services/Technical Support | The service is not allowed; please contact Merchant Services or Technical Support for assistance. |
| P7 | MISSING SERIAL NUM | The terminal has not yet completed the boarding process. The Serial Number has not been set up. | The terminal has not completed the boarding process yet, and the Serial Number has not been set up. |
| Q1 | CARD AUTH FAIL | Card authentication failed | Card authentication failed. |
| R0 | STOP RECURRING | Customer requested stop of specific recurring payment | The customer has requested to stop a specific recurring payment from their account. |
| R1 | STOP RECURRING | Customer requested stop of all recurring payments from specific merchant | The customer has requested to stop all recurring payments from a specific merchant. |
| R3 | STOP ALL RECUR | All recurring payments have been canceled for the card number in the request | All recurring payments for the provided card number have been canceled. |
| S0 | INACTIVE CARD | The PAN used in the transaction is inactive. | The card number (PAN) used in the transaction is inactive and cannot be processed. |
| S1 | MOD 10 FAIL | The Mod-10 check failed. | The Mod-10 validation check, used to verify the card number, failed. |
| S5 | DCLN NO PRE AUTH | Decline – no preauthorization found. | Transaction declined because no preauthorization was found for the transaction. |
| S9 | MAX BALANCE | Maximum working balance exceeded. | The transaction exceeds the maximum allowed balance for the account or card. |
| SA | SHUT DOWN | The Authorization Server is shut down. | The Authorization Server is currently shut down and unable to process the transaction. |
| SB | INVALID STATUS | Invalid card status – status is other than active | The card has an invalid status (e.g., not active), preventing the transaction. |
| SC | UNKNOWN STORE | Unknown dealer/store code – special edit. | The store or dealer code provided is unknown, requiring special handling. |
| SD | TOO MANY RCHRGS | Maximum number of recharges is exceeded. | The maximum number of allowed recharges has been exceeded for this transaction. |
| SE | ALREADY USED | Card was already used. | The card has already been used for a transaction, making this request invalid. |
| SF | NOT MANUAL | Manual transactions not allowed. | Manual transactions are not permitted for this type of request. |
| SH | TYPE UNKNOWN | Transaction type was unknown. | The transaction type provided is unrecognized or not supported by the system. |
| SJ | INVALID TENDER | An invalid tender type was submitted. | The tender type (payment method) submitted is not valid or accepted. |
| SK | CUSTOMER TYPE | An invalid customer type was submitted. | The customer type provided is not valid for processing this transaction. |
| SL | PIN LOCKED | PIN was locked. | The PIN entered for the transaction has been locked due to multiple failed attempts. |
| SM | MAX REDEMPTS | The maximum number of redemptions was exceeded. | The card has exceeded the allowed number of redemptions for a specific offer or service. |
| SP | MAX PAN TRIES | The maximum number of PAN tries was exceeded. | The card has exceeded the maximum allowed number of attempts to enter the PAN (card number). |
| SR | ALREADY ISSUED | The card was already issued. | The card has already been issued and cannot be reissued. |
| SS | NOT ISSUED | The card was not issued. | The card has not been issued or is not recognized by the system. |
| T0 | APPROVAL | First check is okay and has been converted. | The check passed initial verification and was successfully converted. |
| T1 | CANNOT CONVERT | The check is okay but cannot be converted. This is a declined transaction. | The check passed verification but cannot be converted; transaction declined. |
| T2 | INVALIDABA | Invalid ABA number, not an ACH participant. | The ABA number provided is invalid or not registered as an ACH participant. |
| T3 | AMOUNT ERROR | Amount greater than the limit. | The transaction amount exceeds the allowed limit. |
| V1 | FAILURE VM | Daily threshold exceeded. | The daily transaction threshold has been exceeded. |
| Z6 | FIX INVALID MCC | Invalid use of MCC - correct and reattempt. | The MCC (Merchant Category Code) is incorrect; correct it and try again. |
FISERV - Omaha & North
| Response Code | Response Message | Meaning |
|---|---|---|
| 000 | Approved | The transaction was approved successfully. |
| 001 | Approve with ID | The transaction is approved but requires cardholder identification. |
| 002 | Partial Approval (Prepaid Cards only) | Only a portion of the requested transaction amount is approved, typically for prepaid cards. |
| 100 | Deny | The transaction is denied without a specific reason provided. |
| 101 | Expired Card/Invalid Expiration Date | The card has expired, or the expiration date entered is incorrect. |
| 106 | Exceeded PIN attempts | The maximum number of allowed PIN entry attempts has been reached. |
| 107 | Please Call Issuer | The cardholder must contact the issuing bank for further assistance. |
| 109 | Invalid Merchant | The merchant details provided are incorrect or unregistered. |
| 110 | Invalid Amount | The transaction amount is invalid or incorrectly formatted. |
| 111 | Invalid Account /Invalid MICR (Travelers Cheque) | The account or MICR number is invalid or incorrectly entered. |
| 115 | Requested function not supported | The requested transaction type or function is not supported by the issuer or processor. |
| 116 | Not Sufficient Funds | The cardholder’s account has insufficient funds to complete the transaction. |
| 117 | Invalid PIN | The PIN entered is incorrect and does not match issuer records. |
| 119 | Cardmember not enrolled/ not permitted | The cardholder is not enrolled in the service required to complete the transaction. |
| 121 | Limit Exceeded | The transaction exceeds account limits set by the issuer. |
| 122 | Invalid card security code (a.k.a, CID, 4DBC, 4CSC) | The card security code (e.g., CVV, CID) is invalid or incorrectly entered. |
| 125 | Invalid effective date | The effective date for the card or transaction is invalid. |
| 130 | Additional customer identification required | Additional identification is required to complete the transaction. |
| 181 | Format Error | The transaction message was improperly formatted and cannot be processed. |
| 183 | Invalid currency code | The currency code provided is invalid or not supported for the transaction. |
| 187 | Deny - New card issued | The card has been replaced by a new one; the old card is no longer valid. |
| 189 | Deny - Cancelled or Closed Merchant /SE | The merchant or account associated with the transaction has been canceled or closed. |
| 200 | Deny - Pick up card | The transaction is denied, and the card should be confiscated. |
| 400 | Reversal Accepted | The reversal of a previous transaction has been successfully processed. |
| 900 | Accepted - ATC Synchronization | The transaction is approved, with ATC synchronization successfully performed. |
| 909 | System Malfunction (Cryptographic error) | A cryptographic or system error occurred during processing. |
| 912 | Issuer not available | The issuer’s system is unavailable, and the transaction could not be completed. |
WORLDPAY
| Response Code | Response Message | Meaning |
|---|---|---|
| 601 | CALL OPER | Refer to card issuer |
| 602 | CALL OPER | Refer to card issuer, special condition |
| 603 | INV MERCHANT (Visa) | Invalid merchant |
| 603 | NV MERCHANT (Mastercard) | Invalid merchant |
| 604 | PICK UP CARD | Pick up card |
| 605 | TRANS DENIED | Do not honor |
| 606 | TRANS DENIED | One or more errors in message |
| 607 | PICK UP CARD | Pick up card (special condition) |
| 608 | HONOR WITH ID | Honor with identification |
| 611 | APP FOR VIP | VIP approval |
| 612 | INV TRANS | Invalid transaction |
| 613 | INV DOLLAR AMT (Mastercard) | Invalid dollar amount |
| 613 | INV DOLLAR AMT (Visa) | Invalid amount |
| 614 | TRANS DENIED | Invalid cardholder account |
| 615 | INV ISSUER | No such issuer |
| 616 | NEW ACCT INFO | Recurring payment - new account info available |
| 617 | CANNOT APPROVE | Recurring payment - cannot approve |
| 618 | DO NOT TRY AGAIN | Recurring payment - do not try again |
| 619 | RE-ENTER TRANSACTION | Re-enter transaction |
| 621 | NO ACTION TAKEN | No action taken, unable to back out prior transaction |
| 625 | TRANS DENIED (Mastercard) | Unable to locate record |
| 625 | TRANS DENIED (Visa) | Unable to locate record in file |
| 627 | FILE UPDATE ERR | File update field edit error |
| 628 | TRANS DENIED | File is unavailable |
| 630 | FORMAT ERROR | Format error |
| 637 | DO NOT TRY AGAIN | Recurring payment - obtain another type of payment from customer |
| 639 | TRANS DENIED | No credit account |
| 640 | FUNCTION NOT AVAIL | Requested function not supported |
| 641 | PICK UP CARD | Lost card - pick up |
| 643 | PICK UP CARD | Stolen card - pick up |
| 651 | TRANS DENIED | Insufficient funds |
| 652 | TRANS DENIED | No checking account |
| 653 | TRANS DENIED | No savings account |
| 654 | CARD EXPIRED | Expired card |
| 655 | INVALID PIN | Incorrect PIN |
| 657 | TRANS NOT ALLOW | Transactions not allowed to cardholder |
| 658 | TRANS NOT ALLOW | Transactions not allowed to terminal |
| 661 | EXCEEDS MAX AMT (Mastercard) | Exceeds purchase limits |
| 661 | EXCEEDS MAX AMT (Visa) | Exceeds withdrawal/approval amount limits |
| 662 | TRANS DENIED | Restricted card |
| 663 | TRANS DENIED | Security violation |
| 665 | TRANS DENIED (Mastercard) | Account activity limit exceeded |
| 665 | TRANS DENIED (Visa) | Activity count limit exceeded |
| 668 | RESPONSE LATE | Response received late |
| 670 | CONTACT CARD ISSUER | Contact the card issuer |
| 675 | TRANS DENIED (Mastercard) | Exceeded PIN tries - no capture |
| 675 | TRANS DENIED (Visa) | Allowable number of PIN entry tries exceeded |
| 676 | BAD "TO" ACCT (Mastercard) | Invalid/non-existent "to" account specified |
| 676 | INV REF NUMBER (Visa) | Unable to locate previous message |
| 677 | BAD "FROM" ACCT (Mastercard) | Invalid/non-existent "from" account specified |
| 677 | DATA INCONSISTENT (Visa) | Previous message located for repeat/reversal, but data inconsistent |
| 678 | BAD GENERAL ACCT | Invalid non-existent account specified (general) |
| 679 | KEY EXCHG FAILED (Mastercard) | Key exchange validation failed |
| 679 | TRANS DENIED (Visa) | Already reversed by switch |
| 680 | DUPLICATE ADD (Mastercard) | Duplicate add - action not performed |
| 680 | INVALID DATE (Visa) | Invalid date |
| 681 | TRANS DENIED | Cryptographic error found in PIN or CVV |
| 682 | TRANS DENIED | Incorrect CVV |
| 683 | INCORRECT PIN | Unable to verify PIN |
| 684 | BAD LIFE CYCLE (Mastercard) | Invalid authorization life cycle |
| 684 | TRANS DENIED (Visa) | Time limit for a pre-authorization is to long |
| 685 | NOT DECLINED (Mastercard) | No reason to decline |
| 685 | NOT DECLINED (Visa) | No reason to decline AVS request |
| 686 | TRANS DENIED | Cannot verify PIN |
| 687 | RECON TOTAL STOPPED | Reconciliation totaling has stopped for current settlement day |
| 688 | NO TOTALS TRY LATER | Switch cannot provide totals now, try again in 30 minutes |
| 689 | GIV TRANS DENIED | Ineligible to receive financial position information (GIV) |
| 691 | AUTH DOWN | Issuer/switch inoperative |
| 692 | AUTH DOWN (Mastercard) | Unable to route transaction |
| 692 | AUTH DOWN (Visa) | Financial Inst facility cannot be found for routing |
| 693 | TRANS NOT ALLOW | Illegal transaction - violation of law |
| 694 | DUPLICATE TRANS | Duplicate transmission detected |
| 696 | AUTH DOWN (Mastercard) | System malfunction |
| 696 | AUTH DOWN (Visa) | System Malfunction |
| 697 | CVV2 DATA MISSING | Transaction did not contain CVV2 data - retry |
| 698 | STOP PAYMENT (Mastercard) | Stop payment order |
| 698 | STOP PAYMENT ORDER (Visa) | Recurring payment - cardholder requested specific payment stopped |
| 699 | RECUR REVOCATION (Mastercard) | Recurring payment revocation of authorization order |
| 699 | REVOKE AUTH ORDER (Visa) | Recurring payment - cardholder requested all payment stopped |
| 701 | CALL VOICE OPERATOR (Discover) | Call for Authorization |
| 701 | HONOR W/ID (Amex) | Honor with identification |
| 702 | CALL VOICE OPERATOR (Discover) | Call for Authorization |
| 702 | DECLINED (Amex) | Declined by issuer |
| 703 | CARD EXPIRED (Amex) | Expiration date check failed |
| 703 | INV MERCHANT (Discover) | Invalid Merchant |
| 704 | CALL SERVICE CENTER (Amex) | Please call card issuer |
| 704 | PICK UP CARD (Discover) | Pick up card - No Fraud |
| 705 | FORMAT - MERCHANT (Amex) | Format error - invalid merchant ID |
| 705 | TRANS DENIED (Discover) | Do Not Honor |
| 706 | FORMAT - AMOUNT | Format error - invalid amount |
| 707 | FORMAT - ACCOUNT (Amex) | Format error - invalid account number |
| 707 | PICK UP CARD (Discover) | Pick up card (Special Condition) (Fraud Account) |
| 708 | HONOR WITH ID (Discover) | Honor with ID |
| 708 | TRAN NOT ALLOWED (Amex) | Service not valid |
| 709 | FORMAT - BAD CARD | Invalid card security code (CID) |
| 710 | DECLINED | Invalid effective date on card |
| 711 | FORMAT ERROR | Format error |
| 712 | INVALID TRANS (Discover) | Invalid Transaction |
| 712 | NETWK NOT AVAILABLE (Amex) | Network unavailable - please wait |
| 713 | AMOUNT ENTRY ERROR (Discover) | Invalid Amount |
| 713 | FORMAT - CURRENCY (Amex) | Invalid currency code |
| 714 | INVALID CARD NUMBER (Discover) | Invalid Card Number |
| 714 | PICK UP CARD (Amex) | Decline - pick up card |
| 715 | INVALID CARD NUMBER (Discover) | Invalid Card Number Prefix |
| 715 | INVALID TRAN (Amex) | Invalid transaction for network |
| 716 | FORMAT ERROR | Format error |
| 717 | NETWK NOT AVAILABLE | Host/card issuer not available |
| 719 | RE-ENTER TRANS | Re-enter Transaction |
| 730 | MESSAGE FORMAT ERROR | Message Format Error |
| 731 | BANK NOT SUPPORTED | Bank not supported by switch. MID not valid for processing |
| 733 | EXP CARD-CALL CENTER | Expired Card - Call Center |
| 734 | SUSPECTED FRAUD | Suspected Fraud - Call Center |
| 735 | ACCPTOR CONTACT REQD | Card Acceptor Contact Required |
| 736 | RESTRICTED CARD | Restricted Card - Call Center |
| 737 | CALL ACQUIRER SECURTY | Call Center |
| 738 | AUTH DECLINED | Declined PIN attempts |
| 739 | NO CREDIT ACCOUNT | No Credit Account |
| 740 | CALL VOICE OPERATOR | Call for authorization function not available |
| 741 | HOLD - CALL | Pick up - lost card |
| 743 | HOLD - CALL | Pick up - stolen card |
| 751 | AUTH DECLINED | Declined - over limit account |
| 753 | INVALID ACCOUNT # | Declined - No Savings Account |
| 754 | EXPIRED CARD | Expired card |
| 755 | INVALID PIN | Invalid PIN |
| 756 | NO CARD RECORD | No card record |
| 757 | AUTH DECLINED | Transaction not permitted to issuer/cardholder |
| 758 | INVALID TERMINAL ID | Merchant closed or merchant not authorized for authorization type |
| 759 | DO NOT HONOR | Do not honor - Suspected Fraud |
| 760 | CONTACT ACQUIRER | Card acceptor contact acquirer |
| 761 | AUTH DECLINED | Exceeds withdrawal limit |
| 762 | RESTRICTED CARD | Declined - Authorization prohibited |
| 763 | SECURITY VIOLATION | Security violation |
| 764 | ORIG. AMT INCORRECT | Original amount incorrect |
| 765 | AUTH DECLINED | Exceeds withdrawal limit Count limit |
| 766 | CALL ACQUIRER SECUR. | Card acceptor contact acquirer's security |
| 767 | HARD CAPTURE | Hard capture (Requires ATM pickup) |
| 768 | RESP. REC. TOO LATE | Response received too late |
| 775 | AUTH DECLINED | Allowable number of PIN tries exceeded |
| 776 | INVALID "TO" ACCT | Invalid/Nonexistent "to" Account |
| 777 | INVALID "FROM" ACCT | Invalid/Nonexistent "From" Account |
| 778 | INVALID ACCT | Invalid/Nonexistent Account Specified |
| 783 | AUTH DECLINED | Domain Restriction Controls Fail |
| 787 | NETWORK UNAVAILABLE | Network Unavailable |
| 791 | CALL VOICE OPERATOR | Call for authorization - network problems |
| 792 | UNABLE TO ROUTE | Unable to route transaction |
| 793 | AUTH DECLINED | Declined - transaction in violation of law |
| 794 | CALL VOICE OPERATOR | Call for authorization - duplicate authorization request |
| 796 | CALL VOICE OPERATOR | Call for authorization - system malfunction |
| 800 | AVS MATCH | Exact Match of address and 9 digit zip code |
| 801 | AVS MATCH | Match of address and 5 digit zip code |
| 802 | AVS MATCH - ZIP | Match of 5 digit code only address does not match |
| 803 | AVS MATCH - ADDRESS | Match of address only zip code does not match |
| 804 | AVS MATCH - ZIP ONLY | Match of 9 digit zip only address does not match |
| 805 | NO MATCH | Neither address or zip code matched |
| 806 | RETRY | System is unavailable or has timed out |
| 807 | SERVICE UNSUPPORTED | AVS service is unsupported by issuer |
| 808 | DATA UNAVAILABLE | Address info is unavailable |
| 809 | AVS NOT SUPPORTED (Visa) | Issuer does not support AVS |
| 809 | NEW ACCT INFO AVAIL (Mastercard) | Recurring payment - Obtain new account information before the next billing cycle. |
| 810 | ADDRESS MATCH ONLY (Visa) | International address matches, but postal code format incompatible |
| 810 | TRY AGAIN LATER (Mastercard) | Recurring payment - Recycle the transaction 72 hours later. |
| 811 | DO NOT TRY AGAIN (Mastercard) | Recurring payment - Obtain another type of payment from customer. |
| 811 | NOT VERIFIED (Visa) | International address and postal code are in incompatible format. |
| 812 | AVS MATCH | International address and postal code both match |
| 813 | NOT VERIFIED | International address not verified |
| 814 | AVS MATCH | International addresses and postal codes match |
| 815 | AVS MATCH - ZIP | Match of international postal code only. Address format incompatible |
| 819 | TRANS DENIED | Token requirements not fulfilled for this token type |
ELAVON
| Response Codes | Response Messages | Processor Response Definition | Meaning |
|---|---|---|---|
| 4 | Pick Up Card | PICK UP CARD | Card must be confiscated |
| 05 | Do Not Honor | REPRINT PREV TXN | The transaction was declined because an identical transaction using the same card BIN and amount was submitted within one second of the original transaction. Reprint or reference the previous transaction instead of resubmitting the request. |
| 05 | Do Not Honor | BIN NOT FOUND | The card BIN could not be identified by iPOSpays |
| 7 | PICK UP CARD | Pick Up Card (other than lost/stolen) | Card should be retained |
| 41 | PICK UP CARD | Pick Up Card (Lost Card) | Card reported lost |
| 43 | PICK UP CARD | Pick Up Card (Stolen Card) | Card reported stolen |
| 12 | INVALID TRAN | Invalid Transaction | Transaction type invalid |
| 14 | INVALID CARD | Invalid Account Number | Card number invalid |
| 15 | INVALID ISSUER | No Such Issuer | Issuer not recognized |
| 46 | DECLINED:CLOSED | Closed Account | Account closed |
| 57 | TRAN NOT ALLOWED | Transaction Not Permitted | Not allowed for cardholder |
| R0 | STOP PAYMENT | Stop Payment Order | Payment stopped |
| R1 | STOP ORDER | Revocation of Authorization | Authorization revoked |
| R3 | STOP ALL ORDERS | Revocation of All Authorizations | All authorizations revoked |
| 3 | INVALID MERCHANT | Invalid Merchant | Merchant invalid |
| 19 | PLEASE RETRY | Re-enter Transaction | Retry transaction |
| 51 | DECLINED: NSF | Insufficient Funds | Not enough balance |
| 59 | SUSPECTED FRAUD | Suspected Fraud | Fraud suspected |
| 61 | EXCEEDS AMT LMT | Exceeds Amount Limit | Limit exceeded |
| 62 | RESTRICTED CARD | Restricted Card | Card restricted |
| 65 | WITHDRAWAL LIMIT | Withdrawal Limit Exceeded | Too many withdrawals |
| 75 | PIN ENTRY LIMIT | PIN Attempts Exceeded | Too many PIN tries |
| 78 | DECLINED:BLOCKED | Blocked Card | Card blocked |
| 86 | CANT VERIFY PIN | Cannot Verify PIN | PIN verification failed |
| 91 | ISSUER UNAVAIL | Issuer Unavailable | Issuer/system down |
| 93 | DECLINED | Violation of Law | Legal restriction |
| 96 | SYSTEM ERROR | System Malfunction | System error |
| N3 | CASHBACK UNAVAIL | Cash Service Not Available | Cashback unavailable |
| N4 | CASHBACK AMT LMT | Cashback Limit Exceeded | Cashback exceeds limit |
| 54 | EXPIRED CARD | Expired Card | Card expired |
| 55 | INCORRECT PIN | Incorrect PIN | Wrong PIN |
| 82 | INVALID CAM/CVV | Invalid CVV/CAM | Verification failed |
| N7 | DECLINE CVV2 | CVV2 Failure | CVV2 mismatch |
EPX
| Response Codes | Response Messages | Processor Response Definition | Meaning |
|---|---|---|---|
| 0 | APPROVAL | APPROVED | Transaction approved successfully |
| 1 | CALL APPROVE WITH ID | REFER TO CARD ISSUER APPROVE WITH ID | Contact issuer for further action Approval with ID verification |
| 2 | CALL PARTIAL APPROVAL | REFER TO CARD ISSUER, SPECIAL CONDITION PARTIAL APPROVAL | Issuer review required due to special condition Only part of the requested amount approved |
| 3 | TERM ID ERROR | INVALID MERCHANT OR SERVICE PROVIDER TERMINAL ID ERROR | Merchant/terminal not recognized Invalid or missing terminal ID |
| 4 | HOLD-CALL | PICK UP CARD (NO FRAUD) CAPTURE CARD DENY - PICK UP CARD | Retain card; no fraud suspected Retain card as instructed Transaction denied; retain card |
| 5 | DECLINE | DO NOT HONOR DENY | Issuer declined without specific reason Transaction denied |
| 6 | ERROR | ERROR | General processing error |
| 7 | HOLD-CALL | PICK UP CARD, SPECIAL CONDITION (POSSIBLE FRAUD) HOLD-CALL | Retain card; possible fraud Hold card and contact issuer |
| 8 | HONOR WITH ID | HONOR WITH ID | Approval requires ID verification |
| 10 | PARTIAL APPROVED PARTIAL APPROVAL | APPROVED PARTIAL PARTIAL APPROVAL | Partial approval granted Partial amount approved |
| 12 | INVALID TRANS | INVALID TRANSACTION | Transaction type not supported |
| 13 | AMOUNT ERROR | INVALID AMOUNT | Invalid transaction amount |
| 14 | CARD NO. ERROR INVALID ACCT NBR | INVALID ACCOUNT NUMBER | Card number invalid Account number invalid |
| 15 | NO SUCH ISSUER | NO SUCH ISSUER | Issuer not recognized |
| 17 | DECLINE | CUSTOMER CANCEL | Transaction cancelled by customer |
| 19 | RE ENTER | RE-ENTER TRANSACTION | Retry transaction entry |
| 21 | NO ACTION TAKEN | NO ACTION TAKEN | No processing performed |
| 25 | UNABLE TO LOCATE | UNABLE TO LOCATE RECORD IN FILE | Record not found |
| 28 | NO REPLY | FILE IS TEMPORARILY UNAVAILABLE | System temporarily unavailable |
| 30 | FORMAT ERROR CALL | FORMAT ERROR | Message format invalid Contact issuer due to format issue |
| 31 | CALL | BANK NOT SUPPORTED BY SWITCH | Issuer not supported |
| 33 | EXPIRED CARD | EXPIRED CARD | Card expired |
| 34 | CALL | CALL SUSPECTED FRAUD | Contact issuer Possible fraud detected |
| 35 | CALL | CARD ACCEPTOR CONTACT ACQUIRER | Merchant must contact acquirer |
| 36 | CALL | RESTRICTED CARD | Card usage restricted |
| 37 | CALL | CALL - SECURITY | Security-related issue |
| 38 | PIN EXCEEDED | ALLOWABLE PIN TRIES EXCEEDED | Too many incorrect PIN attempts |
| 39 | NO CREDIT ACCT | NO CREDIT ACCOUNT | No valid credit account |
| 40 | CALL | REQUESTED FUNCTION NOT SUPPORTED | Operation not supported |
| 41 | HOLD-CALL | LOST CARD LOST CARD, PICK UP CARD (FRAUD ACCOUNT) | Card reported lost Retain lost card (fraud) |
| 43 | HOLD-CALL | STOLEN CARD STOLEN CARD, PICK UP (FRAUD ACCOUNT) | Card reported stolen Retain stolen card (fraud) |
| 46 | DECLINE | CLOSED ACCOUNT | Account closed |
| 51 | INSUFF FUNDS | INSUFFICIENT FUNDS | Not enough balance |
| 52 | NO CHECK ACCOUNT | NO CHECKING ACCOUNT | Checking account missing |
| 53 | NO SAVE ACCOUNT | NO SAVINGS ACCOUNT | Savings account missing |
| 54 | EXPIRED CARD | EXPIRED CARD | Card expired |
| 55 | WRONG PIN | INCORRECT PIN | Invalid PIN entered |
| 56 | NO CARD RECORD | NO CARD RECORD | Card not found |
| 57 | SERV NOT ALLOWED | TRANSACTION NOT PERMITTED TO ISSUER/CARDHOLDER | Not allowed for cardholder |
| 58 | SERV NOT ALLOWED | TRANSACTION NOT PERMITTED TO ACQUIRER/TERMINAL | Not allowed for terminal |
| 59 | CALL | SUSPECTED FRAUD | Fraud suspected |
| 60 | CALL | CARD ACCEPTOR ERROR | Merchant/terminal issue |
| 61 | DECLINE | EXCEEDS APPROVAL AMOUNT LIMIT EXCEEDS WITHDRAWAL AMOUNT LIMIT | Amount exceeds limit Withdrawal exceeds limit |
| 62 | DECLINE | RESTRICTED CARD RESTRICTED CARD - INVALID IN REGION OR COUNTRY | Card restricted Region restriction |
| 63 | SEC VIOLATION | SECURITY VIOLATION | Security breach detected |
| 64 | CALL | ORIGINAL AMOUNT INCORRECT | Amount mismatch |
| 65 | DECLINE | ACTIVITY COUNT LIMIT EXCEEDED EXCEEDS WITHDRAWAL COUNT LIMIT | Too many transactions Withdrawal count exceeded |
| 66 | CALL | CARD ACCEPTOR ERROR | Terminal error |
| 67 | HOLD-CALL | HARD CAPTURE - CALL | Retain card, call issuer |
| 68 | CALL | RESPONSE RECEIVED TOO LATE | Timeout from issuer |
| 70 | CALL | CONTACT CARD ISSUER | Contact issuer |
| 75 | PIN EXCEEDED | ALLOWABLE NUMBER OF PIN ENTRY TRIES EXCEEDED | PIN retries exceeded |
| 76 | NO ACTION TAKEN | UNABLE TO LOCATE PREVIOUS MESSAGE | Previous record not found |
| 77 | NO ACTION TAKEN | NO MATCH ON ORIGINAL MESSAGE | No matching transaction |
| 78 | NO ACCOUNT BLOCKED 1ST USE | INVALID/NONEXISTENT ACCOUNT BLOCKED FIRST USE BY CARDHOLDER | Account does not exist First use blocked |
| 79 | DECLINE | LIFE CYCLE (NEW ABU AVAIL) | Updated account info available |
| 80 | DECLINED DATE ERROR | NO FINANCIAL IMPACT DATE ERROR | Informational decline Invalid date |
| 81 | ENCRYPTION ERROR SERV NOT ALLOWED | PIN CRYPTOGRAPHIC ERROR FOUND DEBIT TRANSACTION NOT ALLOWED | Encryption failure Debit not allowed |
| 82 | CVV ERROR DECLINE | INCORRECT CVV POLICY (NEW ABU AVAIL) | CVV mismatch Policy-based decline |
| 83 | CANT VERIFY PIN DECLINE | UNABLE TO VERIFY PIN FRAUD/SECURITY | PIN verification failed Fraud/security risk |
| 84 | INVALID ALC | INVALID ALC | Invalid authorization lifecycle |
| 85 | NOT DECLINED | ISSUER HAS NO REASON TO DECLINE | Informational approval |
| 86 | CANT VERIFY PIN | CAN NOT VERIFY PIN | PIN verification unavailable |
| 87 | NO REPLY CASHBACK NOT AVL | NETWORK UNAVAILABLE NO CASH BACK | Network down Cashback unavailable |
| 88 | CRYPTO FAILURE | CRYPTO FAILURE | Cryptographic failure |
| 89 | PIN REQUIRED | PIN REQUIRED | PIN must be entered |
| 91 | NO REPLY | ISSUER UNAVAILABLE OR SWITCH INOPERATIVE ISSUER NOT AVAILABLE | Issuer not responding Issuer unavailable |
| 92 | INVALID ROUTING | DESTINATION CANNOT BE FOUND FOR ROUTING INVALID ROUTING NUMBER | Routing failure Invalid routing |
| 93 | DECLINE | TRANSACTION CANNOT BE COMPLETED, VIOLATION | Rule violation |
| 94 | CALL DUP TRANS | DUPLICATE TRANSMISSION DETECTED | Duplicate request Duplicate transaction |
| 96 | SYSTEM ERROR | SYSTEM MALFUNCTION | System failure |
| 1A | DECLINE | ADDITIONAL CUSTOMER AUTHENTICATION REQUIRED | Extra authentication needed |
| 6P | DECLINE | VERIFICATION DATA FAILED | Verification failed |
| B1 | DECLINE | SURCHARGE AMOUNT NOT PERMITTED ON VISA | Surcharge not allowed |
| DA | INVALID FLEET | REQUIRED FLEET PROMPTS INVALID OR MISSING | Fleet data invalid |
| E2 | AVS REQUIRED | AVS DATA REQUIRED | Address verification needed |
| E3 | CVV2 REQUIRED | CVV2 DATA REQUIRED | CVV2 required |
| E4 | SERV NOT ALLOWED | SERVICE NOT ALLOWED | Operation not permitted |
| E5 | SERV NOT ALLOWED | SERVICE NOT ALLOWED | Operation not permitted |
| E6 | SERV NOT ALLOWED | SERVICE NOT ALLOWED | Operation not permitted |
| E7 | TERM ID ERROR | TERMINAL ID ERROR | Invalid terminal ID |
| E9 | NO REPLY | NO REPLY NETWORK | Network unavailable |
| EA | ACCT LENGTH ERR | ACCOUNT LENGTH ERROR | Invalid account length |
| EB | CHK DIGIT ERROR | CHECK DIGIT ERROR | Check digit mismatch |
| EC | CID FORMAT ERROR | CID FORMAT ERROR | CID format invalid |
| ED | EXPIRED AUTH | AUTH IS TOO OLD FOR CAPTURE | Authorization expired |
| EE | RESTRICTED CARD | CARD PRODUCT BLOCKED | Card type blocked |
| EF | INVALID TRANS | BRIC ON PIN TRAN NOT ALLOWED | PIN transaction not allowed |
| EH | CEM INVALID | INVALID CARD ENTRY METHOD | Invalid entry method |
| EI | CARD_ID INVALID | INVALID CARD ID | Card ID invalid |
| EJ | NO PIN BLK | NO PIN BLOCK | Missing PIN block |
| EK | SERV NOT ALLOWED | PINLESS ROUTING NOT ALLOWED | Routing not allowed |
| EL | STORAGE FAILED | BRIC STORAGE FAILED | Storage error |
| EM | DEBIT SWIPE ONLY | DEBIT SWIPE ONLY | Swipe required |
| EN | BRIC RESPONSE TO | BRIC RESPONSE TIMEOUT | Timeout |
| EO | CVV2 MISMATCH | CVV2 MISMATCH | CVV mismatch |
| EQ | SYSTEM ERROR | NETWORK GATEWAY NOT AVAILABLE | Gateway down |
| ES | DECLINE | TRANSACTION NOT ALLOWED (VALIDATION FAILURE) | Validation failed |
| ET | FORMAT ERROR | EMV DATA REQUIRED | EMV data missing |
| EU | NO REPLY | NETWORK REJECTED ITEM | Network rejected |
| EV | NO ACTION TAKEN | ITEM ALREADY CAPTURED | Already processed |
| EW | FORMAT ERROR | FAILED REGEX VALIDATION | Format validation failed |
| EX | CHECK NBR REQUIR | CHECK NUMBER REQUIRED | Check number missing |
| EY | RETRY - DIP CARD | CONTACTLESS MSD NOT ALLOWED. DIP CARD | Use chip instead |
| N0 | DECLINE | FORCE STIP | Stand-in processing decline |
| N3 | CASHBACK NOT AVL | CASH SERVICE NOT AVAILABLE CASHBACK NOT AVAILABLE | No cash service Cashback unavailable |
| N4 | DECLINE | CASH REQUEST EXCEEDS ISSUER LIMIT DECLINE | Cash limit exceeded Generic decline |
| N6 | DECLINE | DECLINE | Generic decline |
| N7 | CVV2 MISMATCH CVV AVS MISMATCH | DECLINE FOR CVV2 FAILURE CVV2 / AVS FAILURE | CVV failed CVV/AVS failed |
| NR | NO DEBIT ROUTE | NO VALID DEBIT NETWORK AVAILABLE | No routing path |
| P2 | DECLINE | INVALID BILLER INFORMATION | Invalid biller |
| P5 | DECLINE | PIN CHANGE/UNBLOCK REQUEST DECLINED | PIN change failed |
| P6 | DECLINE | UNSAFE PIN | Weak PIN |
| Q1 | DECLINE | CARD AUTHENTICATION FAILED | Auth failed |
| R0 | DECLINE | STOP PAYMENT ORDER | Payment stopped |
| R1 | DECLINE | REVOCATION OF AUTHORIZATION ORDER | Authorization revoked |
| R3 | DECLINE | REVOCATION OF ALL AUTHORIZATIONS ORDER | All auth revoked |
| RR | ERROR | INVALID DATA IN REQUEST | Request invalid |
| S4 | CRYPTO FAILURE | PIN BLOCK TRANSLATION ERROR | PIN block error |
| S5 | UNABLE TO LOCATE | UNABLE TO LOCATE A MATCHING ORIGINAL PURCHASE TRANSACTION | Original txn not found |
| S7 | INVALID RETURN | UNABLE TO LOCATE A MATCHING ORIGINAL PURCHASE TRANSACTION | Return txn not found |
| S8 | NO AUTHORIZATION | UNABLE TO LOCATE A MATCHING AUTHORIZATION | Auth not found |
| S9 | TLV TAGS INVALID | TLV TAGS INVALID | TLV data invalid |
| SA | DECLINED | LIFE CYCLE - NEW ACCOUNT INFORMATION AVAILABLE | Updated account info |
| SB | DECLINED | LIFE CYCLE - TRY AGAIN LATER | Retry later |
| SC | DECLINED | LIFE CYCLE - DO NOT TRY AGAIN | Do not retry |
| SD | DECLINED | TOKEN REQUIREMENTS NOT FULFILLED | Token issue |
| SE | DECLINED | PAYMENT CANCELLATION | Payment cancelled |
| SF | DECLINED | MERCHANT DOES NOT QUALIFY | Merchant restriction |
| SG | DECLINED | POLICY - NEW ACCOUNT INFO AVAILABLE | Policy update |
| SH | DECLINED | POLICY - TRY AGAIN LATER | Retry later |
| SI | DECLINED | POLICY - DO NOT TRY AGAIN | Do not retry |
| SJ | DECLINED | POLICY - TOKEN REQUIREMENTS NOT FULFILLED | Token issue |
| SK | DECLINED | POLICY - PAYMENT CANCELLATION | Cancelled |
| SL | DECLINED | POLICY - MERCHANT DOES NOT QUALIFY | Merchant restriction |
| SM | DECLINED | FRAUD/SECURITY - NEW ACCOUNT INFO | Fraud update |
| SN | DECLINED | FRAUD/SECURITY - TRY AGAIN LATER | Retry later |
| SO | DECLINED | FRAUD/SECURITY - DO NOT TRY AGAIN | Do not retry |
| SP | DECLINED | FRAUD/SECURITY - TOKEN REQUIREMENTS NOT FULFILLED | Token issue |
| SQ | DECLINED | FRAUD/SECURITY - PAYMENT CANCELLATION | Cancelled |
| SR | DECLINED | FRAUD/SECURITY - MERCHANT DOES NOT QUALIFY | Merchant restriction |
| Z1 | DECLINE | OFFLINE DECLINED | Offline decline |
| Z3 | DECLINE | UNABLE TO GO ONLINE | Cannot connect |
| 100 | DECLINE | DENY | Denied |
| 101 | EXPIRED CARD | EXPIRED CARD | Card expired |
| 106 | PIN EXCEEDED | PIN EXCEEDED | PIN limit exceeded |
| 107 | PLEASE CALL | PLEASE CALL ISSUER | Contact issuer |
| 109 | TERM ID ERROR | INVALID MERCHANT | Merchant invalid |
| 110 | AMOUNT ERROR | INVALID AMOUNT | Amount invalid |
| 111 | NO ACCOUNT | INVALID ACCOUNT | Account invalid |
| 115 | SERV NOT ALLOWED | SERVICE NOT PERMITTED | Not allowed |
| 116 | DECLINE | INSUFFICIENT FUNDS | Insufficient funds |
| 117 | WRONG PIN | INVALID PIN | Wrong PIN |
| 119 | NO CARD RECORD | NO CARD RECORD | No record |
| 121 | DECLINE | LIMIT EXCEEDED | Limit exceeded |
| 125 | EXPIRED CARD | INVALID EFFECTIVE DATE | Invalid date |
| 181 | FORMAT ERROR | FORMAT ERROR | Format issue |
| 183 | DECLINE | INVALID CURRENCY CODE | Currency invalid |
| 187 | INVALID ACCT NBR | DENY - NEW CARD ISSUED | New card issued |
| 189 | TERM ID ERROR | DENY - CANCELED OR CLOSED MERCHANT | Merchant closed |
| 200 | HOLD-CALL | DENY - PICK UP CARD | Retain card |
| 900 | SYSTEM ERROR | ATC SYNCHRONIZATION | Sync issue |
| 909 | SYSTEM ERROR | SYSTEM MALFUNCTION (CRYPTO ERROR) | Crypto failure |
| 912 | NO REPLY | ISSUER NOT AVAILABLE | Issuer unavailable |
Error Codes & Messages
HTTPs Error Messages
| Error Code | Error Message | Meaning |
|---|---|---|
| 400 | Bad Request | The server could not understand the request due to invalid syntax |
| 401 | Unauthorized | Authentication is required to access the requested resource |
| 403 | Forbidden | Valid credentials, but access is explicitly denied |
| 404 | Not Found | The server cannot find the requested resource |
| 405 | Method Not Allowed | The HTTP method used is not supported for the requested resource |
| 408 | Request Timeout | The server timed out waiting for the complete request from the client |
| 429 | Too Many Requests | The user has sent too many requests in a given amount of time |
| 500 | Internal Server Error | The server encountered an unexpected condition |
| 502 | Bad Gateway | Error occurred between gateway/proxy and the backend server |
| 503 | Service Unavailable | The server is currently unable to handle the request |
| 504 | Gateway Timeout | The server did not receive a timely response from the upstream server |
| 505 | HTTP Version Not Supported | The HTTP version used in the request is not supported by the server |
SPIn Specification
| <RespMSG>…</RestMSG> | Description | What to do |
|---|---|---|
| Active route not found | A terminal does not have an active SPIn Connection. The Connection is created, but is disabled. | On the Terminal Details page check that SPIn Proxy is activated for this terminal. |
| Not pars request | There is an error in the request message format. | Check a request format. |
| Route not found | A terminal does not have SPIn Connection. The Connection is not created. | On the Terminal Details page create a new SPIn Proxy connection. |
| Terminal not connected to SPIn proxy server | A terminal is not connected to the internet or it is inaccessible due to network settings. The terminal might be just disconnected due to reconnecting to the network, a terminal restart, being in sleep mode, or being in SPIn bypass mode. | Check a terminal whether it works or not and be sure that terminal is on the SPIn mode screen and online. Send a status request to get actual connection status to continue to work with a terminal. see Check Terminal Connection Status |
| The operation has timed out | A request was sent to a terminal, but the terminal did not provide a response at a proper time. Probably the terminal lost a connection, was switched off, a discharged battery, some bug on a terminal, a terminal not in the IDLE screen and busy by some process e.g. a terminal menu is open and a transaction not in focus. Possible that the terminal will respond to this transaction after a timeout event, a transaction will be performed and approved on a host side and added to a settlement report. But SPIn Proxy cannot guarantee a delivery on this POS request and a timeout is the best response in this case. Default timeout 120 seconds. | Check a terminal whether it works or not and be sure that terminal is on the SPIn mode screen and online. Do Status request to check transaction Status Alternative way: Repeat the transaction with the same parameters if the transaction was already performed you will get an error “Duplicated ReferenceID”. Continue to perform transactions |
| This terminal handles a different query | A terminal operates another request. | Wait when the previous request is completed and repeat a new request to a terminal. |
| Terminal in use | Register/Server/Host will get this error if it attempts to send a second request before the full time out period of previous request. | Wait for transaction timing out before attempting another transaction |
| Invalid Reference ID | Reference Id value sent from Register/POS/Server will have to be unique per transaction within the batch. | Change the reference id value and retry the transaction |
| Reconnected | Terminal was reconnected after receiving the request and before providing the response | Do Status request to check transaction Status |
| Service busy | If the terminal is not ready to receive a transaction for any reason (usually because it is not on the idle screen to receive the request, is busy processing another operation, or has not yet completed a previous transaction). | Try once the existing transaction is completed. |
Freedom to Design
| Error Code | Error Message | Meaning |
|---|---|---|
| FTD_001 | Card Number is not valid, Please try with a valid Card Number | Triggered when the card number fails validation against the expected format. |
| FTD_002 | Card Cvv is not valid,Please try with valid Cvv | Occurs when the CVV format does not meet validation criteria |
| FTD_003 | Card is Expired | The transaction was declined due to the card being past its expiration date. |
| FTD_004 | Card is Expiry Month is Not Valid | The expiration month could not be parsed from the request. |
| FTD_005 | Card is Expiry Month is Not Valid | The expiration month format is incorrect. |
| FTD_006 | Data Tokenization Key is not valid,Please try with valid Key | The tokenization key provided is invalid or expired. |
| FTD_007 | Requested Origin is Not Registered. Please Contact Support Team | The request originated from an unrecognized domain. |
| FTD_008 | Invalid Payload. Please Try With Valid Payload | The paymentTokenId is invalid or expired (older than 24 hours). |
| FTD_009 | Data Tokenization Key is not valid,Please try with valid Key | The tokenization key has expired or is no longer valid. |
| FTD_010 | Invalid Request, Please try again | Either the request is invalid or the HSM (Hardware Security Module) is down |
| FTD_011 | Process Failed. Please try with new Token | No response was received from the HSM to complete decryption. |
| FTD_012 | Invalid Request, Please try again | An internal exception occurred while invoking the HSM application. |
| FTD_013 | Invalid Request, Please try again | HSM returned an invalid or unexpected response. |
Clear Card Encryption
Encryption Card Error Codes
| Error Code | Error Message | Meaning |
|---|---|---|
| MTERR_001 | Invalid TPN. Please verify the Terminal Profile Number. | The TPN you entered is incorrect. Please check and try again. |
| MTERR_002 | TPN status is suspended. Please contact support to reactivate the terminal. | The TPN is suspended. You’ll need to contact support to get it reactivated. |
| MTERR_003 | TPN is inactive. Please activate the TPN or contact support. | The TPN is not active. Please activate it or reach out to support for help. |
| MTERR_004 | Invalid token. Please authenticate again with a valid token. | The token used isn’t valid. Try logging in again to get a new one. |
| MTERR_005 | Token is expired. | Your token has expired. To generate a new one, call the “Refresh-Token” API. |
| MTERR_006 | Invalid Token. Please Provide Valid Token. | The token provided is not valid. Make sure you’re using the correct one. |
| MTERR_007 | Token must include encrypted scope and uniqueId. | The token is missing some required details. It needs both scope and uniqueId. |
| MTERR_008 | User is not registered for Payment Tokenization. | Your account isn’t set up for payment tokenization. Please register or contact support. |
| MTERR_009 | The token contains an invalid scope. Please ensure the scope matches one of the allowed values. | The scope inside your token isn’t correct. Please use one of the supported options. |
| MTERR_010 | The merchant token is not encrypted using a valid or recognized public key. Please verify the encryption process and key used. | The token wasn’t encrypted properly. Make sure you’re using the correct method and key. |
Authentication Error Codes
| Error Code | Error Message | Meaning |
|---|---|---|
| AUTH_ERR_001 | API Key is required. | The API key is missing. Please include it in your request. |
| AUTH_ERR_002 | Secret Key is required. | The secret key is missing. Make sure to provide it for authentication. |
| AUTH_ERR_003 | Scope is required. | You must specify a scope in your request. |
| AUTH_ERR_004 | Invalid Credentials, Please Contact Support Team. | The API key or secret is incorrect. Contact support if you’re unsure. |
| AUTH_ERR_005 | Invalid scope provided. Please use a valid scope. | The scope provided is not valid. Use one of the supported scopes. |
| AUTH_ERR_006 | Invalid Token, Please try with a Valid Token. | The token used is not valid. Please get a new one and try again. |
| AUTH_ERR_007 | Invalid Token, Please try with a Valid Token. | Same as above. Token is invalid. Please use a valid one. |
| AUTH_ERR_008 | Invalid Signature. | The request signature doesn’t match. Check your signing method and try again. |
| AUTH_ERR_009 | Refresh Token needs to be true in the Header. | You must set refreshToken=true in the request header for this action. |
Batch Report API
Error Response Code & Message
| Error Code | Message | Meaning |
|---|---|---|
| IPOS_BATCH_001 | Authentication token required. | The request must include a valid authentication token. |
| IPOS_BATCH_002 | Invalid Request | The request format or structure is incorrect. |
| IPOS_BATCH_003 | TPN Required | The Terminal Profile Number (TPN) must be provided in the request. |
| IPOS_BATCH_004 | Invalid Batch Request | The batch request payload is invalid or improperly constructed. |
| IPOS_BATCH_005 | Invalid Batch Request | The batch request could not be processed due to incorrect input. |
| IPOS_BATCH_006 | Invalid Batch Request. | The batch submission is invalid. |
| IPOS_BATCH_007 | Invalid Request | The system could not process the request due to invalid input. |
| IPOS_BATCH_008 | Invalid TPN | The TPN provided is not recognized or is formatted incorrectly. |
| IPOS_BATCH_009 | TPN suspended. Please contact the support team | Access is restricted because the TPN is currently suspended. |
| IPOS_BATCH_010 | TPN inactive. Please contact the support team | The requested TPN is inactive and cannot be used for batch operations. |
| IPOS_BATCH_011 | Invalid Token | The authentication token is not valid. |
| IPOS_BATCH_012 | Token not supported with BatchReport API. | The token provided is not authorized for use with this API. |
| IPOS_BATCH_013 | ISO not authorized to access the BatchReport API. | The ISO account is not configured for Batch Report access. |
| IPOS_BATCH_014 | Merchant not authorized to access the BatchReport API. | The merchant account is not configured for Batch Report access. |
| IPOS_BATCH_015 | Store is not authorized to access the BatchReport API. | The store does not have permission to use the BatchReport API. |
| MTERR_004 | Re-authentication required. Please authenticate again with a valid token. | The token is invalid; you must log in again or generate a new one. |
| MTERR_005 | Token has expired | The token has passed its validity period and can no longer be used. |
| MTERR_006 | Invalid token. Please provide a valid token. | The token provided cannot be used for authentication. |
| MTERR_007 | Token must include encrypted scope and unique identifier. | The token format is incomplete or improperly generated. |
Hosted Payment Page
Error Response Code & Message - Upon Payment Form Generate URL request
| Error | Error Response Message |
|---|---|
| merchantAuthentication | Merchant Auth request errors |
| merchantAuthentication[object] | Merchant authentication cannot be null |
| merchantAuthentication.merchantId | Merchant Id cannot be null |
| merchantAuthentication.merchantId | Invalid merchant id |
| merchantAuthentication.transactionReferenceId | Invalid transaction reference id |
| merchantAuthentication.transactionReferenceId | Transaction reference id cannot be null |
| Transaction request errors | |
| transactionRequest[object] | Transaction request cannot be null |
| transactionRequest.amount | Invalid amount |
| transactionRequest.amount | Transaction type cannot be null |
| transactionRequest.transactionType | Invalid transaction type |
| transactionRequest.feeAmount | Invalid fee amount |
| transactionRequest.feeLabel | Invalid fee label |
| transactionRequest.lTaxAmount | Invalid lTax amount |
| transactionRequest.lTaxLabel | Invalid lTax label |
| transactionRequest.gTaxAmount | Invalid gTax amount |
| transactionRequest.gTaxLabel | Invalid gTax label |
| Notify By request errors | |
| notificationOption[object] | Notification option cannot be null |
| notificationOption.postAPI | Invalid post API |
| notificationOption.returnUrl | Invalid return URL |
| notificationOption.failureUrl | Invalid failure URL |
| notificationOption.mobileNumber | Invalid mobile number |
| notificationOption.cancelUrl | Invalid Cancel URL |
| Preference request errors | |
| preferences[object] | Preferences cannot be null |
| preferences.integrationType | Integration type cannot be null |
| preferences.integrationType | Invalid integration type |
| preferences.customerName | Invalid customer name |
| preferences.customerEmail | Invalid customer email |
| preferences.customerMobile | Invalid customer mobile |
| preferences.customerEmail, preferences.customerMobile | Both customer email and customer mobile cannot be empty |
| Personalization request errors | |
| personalization.merchantName | Invalid merchant name |
| personalization.logoUrl | Invalid logo URL |
| personalization.themeColor | Invalid theme color |
| personalization.description | Invalid description |
| personalization.payNowButtonText | Invalid pay button text |
| personalization.buttonColor | Invalid button color |
| personalization.cancelButtonText | Invalid cancel button text |
| personalization.disclaimer | Invalid disclaimer |
Recurring Payments API
API Error Response Message Reference
| Code | Meaning | Description |
|---|---|---|
| 500 | PUBLIC_KEY_MISSING | Authentication system is not configured. Please try again later. |
| 401 | TOKEN_MISSING | Missing authentication token. Please include a valid API token in your request. |
| 401 | TOKEN_EXPIRED | Your API token has expired. Please generate a new token. |
| 401 | TOKEN_INVALID | The provided API token is invalid. Please check your credentials. |
| 401 | TOKEN_VERIFICATION_FAILED | Unable to verify the provided API token. Please try again. |
| 500 | TOKEN_VERIFICATION_FAILED | An internal error occurred while verifying your API token. Please try again later. |
| 401 | TOKEN_INACTIVE | The provided API token is inactive or revoked. Please request a new token. |
| 401 | ACCESS_DENIED | Only ISO, MERCHANT, STORE allowed to set Recurring! |
| 401 | IN_ACTIVE | ISO is in-active! |
| 401 | IN_ACTIVE | MERCHANT is in-active! |
| 401 | IN_ACTIVE | STORE is in-active! |
| 400 | NOT_FOUND | We couldn’t find a match for this Customer ID. Please check the ID and try again. |
| 412 | PRECONDITION_FAILED | Consumer ID and TPN must be from the same store. |
| 401 | ACCESS_DENIED | The Customer ID does not belong to this iso. |
| 401 | ACCESS_DENIED | The Customer ID does not belong to this merchant. |
| 401 | ACCESS_DENIED | The Customer ID does not belong to this store. |
| 400 | NOT_FOUND | We couldn’t find a match for this Subscription ID. Please check the ID and try again. |
| 400 | NOT_FOUND | Subscription ID and TPN must be from the same store. |
| 400 | NOT_FOUND | The subscription is not active. Please activate it before making changes. |
| 401 | ACCESS_DENIED | The Subscription ID does not belong to this iso. |
| 401 | ACCESS_DENIED | The Subscription ID does not belong to this merchant. |
| 401 | ACCESS_DENIED | The Subscription ID does not belong to this store. |
| 400 | GENERATE_ECOM_TOKEN | The card is not linked to this customer. To proceed with pre-authorization, an Ecom token is required. Please generate the Ecom token for TPN (). |
| 500 | INTERNAL_ERROR | An error occurred while processing your request. Please try again later. |
| 400 | INVALID_CARD_TOKEN | Card token is invalid! |
| 400 | NOT_FOUND | No ACH payment method is available for this customer. |
| 400 | NOT_FOUND | No valid ACH payment method found. Please check the ACH token. |
| 400 | NOT_FOUND | No valid PPD payment method found. Please check the ACH token or SEC code. |
| 400 | NOT_FOUND | No valid WEB payment method found. Please check the ACH token or SEC code. |
| 400 | NOT_FOUND | No valid CCD payment method found. Please check the ACH token or SEC code. |
| 400 | NOT_FOUND | No valid TEL payment method found. Please check the ACH token or SEC code. |
| 400 | NOT_FOUND | We couldn’t find a match for this TPN. Please check the TPN and try again. |
| 400 | NOT_FOUND | TPN is not active. |
| 401 | ACCESS_DENIED | The TPN does not belong to this iso. |
| 401 | ACCESS_DENIED | The TPN does not belong to this merchant. |
| 401 | ACCESS_DENIED | The TPN does not belong to this store. |
| 400 | BAD_REQUEST | Start date is required. |
| 400 | BAD_REQUEST | Start date is invalid. Please enter a valid date in YYYY-MM-DD format (e.g., 1947-01-01). |
| 400 | BAD_REQUEST | Start date cannot be today or in the past. Please choose a future date. |
| 400 | BAD_REQUEST | End criteria is required. |
| 400 | BAD_REQUEST | End criteria must be one of: NEVER, AFTER_A_SPECIFIC_DATE, AFTER_NO_OF_INSTALLMENTS. |
| 400 | BAD_REQUEST | Status is required. |
| 400 | BAD_REQUEST | Status must be one of: ACTIVE, CANCEL. |
| 400 | BAD_REQUEST | Preferred day is required. |
| 400 | BAD_REQUEST | Preferred day must be one of: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY. |
| 400 | BAD_REQUEST | The preferred day must align with the start date. Your start date falls on (EST), but selected day is <SELECTED_DAY>. Please choose as your preferred day. |
| 400 | BAD_REQUEST | End date is required. |
| 400 | BAD_REQUEST | End date is invalid. Please enter a valid date in YYYY-MM-DD format (e.g., 1947-01-01). |
| 400 | BAD_REQUEST | End date cannot be today or in the past. Please choose a future date. |
| 400 | BAD_REQUEST | End date must be after start date. |
| 400 | BAD_REQUEST | End date must be after both day 1 and day 2. Please choose a date after <MAX_DATE>. |
| 400 | BAD_REQUEST | End value is required. |
| 400 | BAD_REQUEST | End count must be greater than 1. |
| 400 | BAD_REQUEST | End count can’t be more than 100. |
| 400 | BAD_REQUEST | Custom interval days is required. |
| 400 | BAD_REQUEST | Custom interval days must be greater than 1. |
| 400 | BAD_REQUEST | Custom interval days can’t be more than 365. |
| 400 | BAD_REQUEST | Day 1 is required. |
| 400 | BAD_REQUEST | Day 1 must be at least 1. |
| 400 | BAD_REQUEST | Day 1 cannot be more than 31. |
| 400 | BAD_REQUEST | Day 2 is required. |
| 400 | BAD_REQUEST | Day 1 and Day 2 cannot be the same. |
| 400 | BAD_REQUEST | Day 2 must be at least 1. |
| 400 | BAD_REQUEST | Day 2 cannot be more than 31. |
| 400 | BAD_REQUEST | Day 1 is invalid. Please enter a valid date in YYYY-MM-DD format (e.g., 1947-01-01). |
| 400 | BAD_REQUEST | Day 2 is invalid. Please enter a valid date in YYYY-MM-DD format (e.g., 1947-01-01). |
| 400 | BAD_REQUEST | Day 2 cannot be today or in the past. Please choose a future date. |
| 400 | BAD_REQUEST | Sec code must be one of: PPD, WEB, CCD, TEL. |
| 400 | BAD_REQUEST | Description must not be longer than 100 characters. |
| 400 | BAD_REQUEST | Reference ID can only contain letters and numbers. |
| 400 | BAD_REQUEST | Reference ID must be at least 1 character long. |
| 400 | BAD_REQUEST | Reference ID cannot exceed 12 characters. |
| 200 | SUCCESS | subscription added successfully |
| 200 | SUCCESS | subscription updated successfully |
| 400 | NOT_FOUND | Subscription not found. |
| 200 | NO_CHANGE | The subscription is already ACTIVE. |
| 200 | NO_CHANGE | The subscription is already CANCELLED. |
| 200 | SUCCESS | Your subscription has been activated. |
| 200 | SUCCESS | Your subscription has been cancelled. |
| 200 | SUCCESS | transactions |
| 200 | SUCCESS | cards and ach |
| 500 | INTERNAL_ERROR | An error occurred while processing your request. Please try again later. |
Printer SDK
| Error code | Error message |
|---|---|
| -1 | Invalid printer data |
| -2 | Unknown exception while printing |
| -3 | Invalid printer data body |
| -4 | No paper roll |
| -5 | If any unknown exceptions while printing |
| -6 | Printer data limit exceeded |
| Other error codes | Printing failed |
Swipereader SDK
| Code | Type | Description |
|---|---|---|
| 00 | Success | The swipe card operation was successful. |
| 01 | Failure | Please update the timeout to be in the range of 10 to 90 seconds. |
| 02 | Failure | Unable to support this device model. |
| 03 | Failure | Unable to initialize card reader. |
| 04 | Failure | Unable to initialize card reader. Context is null. |
| 05 | Failure | Unable to support this device model. |
| 06 | Failure | Failed to open card reader |
| 07 | Failure | Failed to read card data. |
| 08 | Timeout | Card detection timeout. |
| 09 | Failure | Exception in card detection. |
| 10 | Failure | All track data null. |
| 11 | Failure | Card detection timeout. |
| 12 | Failure | We don’t support this device. |
| 13 | Failure | Swipe reader failed. |
| 14 | Failure | Device exception. |
iPOS Transact API
| HTTP Response Code | Response Message |
|---|---|
| 200 | Success |
| 400 | Declined |
| Error | Error Message | Meaning |
|---|---|---|
| Failed | Invalid Token | The request failed due to an invalid or expired token. |
| Failed | Device does not exist | The specified device was not found in the system. |
| Failed | TPN status is suspended | Transactions are blocked because the TPN is suspended. |
| Failed | TPN status is not active | The TPN must be active to proceed with the transaction |
| transactionRequest.amount | Invalid amount | The transaction amount is either missing or improperly formatted. |
| transactionRequest.transactionType | Invalid transaction type | The transaction type is not recognized or unsupported |
| transactionRequest.cardToken | Card Token cannot be empty | Card token is required for processing the transaction |
| transactionRequest.rrn | RRN cannot be empty | RRN is required but was not provided in the request |
| transactionRequest.applySteamSettingTipFeeTax | Steam setting for tip, fee & tax are not found to requested TPN | Tip/Fee/Tax settings are not configured in S.T.E.A.M → Edit Parameters for the requested TPN |
| IPOSTRANSCT_001 | AVS is Mandatory -- (using multiple place) | Address Verification System (AVS) information is required |
| IPOSTRANSCT_004 | Street No is Mandatory | Street number is required for AVS or transaction validation |
| IPOSTRANSCT_006 | Zip Code is Mandatory | Zip code is required as part of address verification or validation |
| transactionRequest.rrn | RRN cannot be null | RRN field must contain a value and cannot be null |
| IPOS_001 | REFUND cannot be processed as you have exceeded the maximum limit of + refundenableCount + attempts | Refund request exceeded the allowed number of attempts |
| Failed | High amount value | Transaction amount exceeds the allowable or configured limit |
| Failed | This transaction is already voided | The transaction cannot be voided again |
| Failed | This transaction is already refunded | Refund cannot proceed as it has already been processed |
| Failed | Refund option is disabled for this TPN | Refunds are not permitted for the current TPN configuration |
| Failed | Void option is disabled for this TPN | Void transactions are not permitted for this TPN |
| Failed | Invalid transaction request | The transaction request failed due to validation or formatting issues |
| transactionRequest.amount | Amount cannot be empty | amount field is missing or empty and it must be provided for processing |
| transactionRequest.cardToken | Card Token cannot be empty | Card token is mandatory and must be included |
| Failed | Tip is not enabled for this TPN | Tips are not supported under this TPN |
| Failed | Txn not supported | The type of transaction is not allowed under current settings |
| No PreAuth Transaction | Incremental auth can be done with Original PreAuth | Incremental authorization requires a valid PreAuth transaction |
| This ticket is now closed | Incremental auth can only be done before closing the ticket | You cannot perform incremental authorization after closing the ticket |
| This ticket is now closed | Please close this ticket | The number of incremental auth attempts has been exceeded |
| IPOS_BATCH_001 | No Open Batch For this TPN | No active batch session is available for the given TPN |
| IPOS_BATCH_002 | Error Connecting With Open Batch Api, Please Try Again | System failed to connect to the batch service API |
| Failed | Transaction reference ID must be unique | Duplicate reference ID detected. Each transaction must have a distinct reference ID |
| Failed | Partial Approval Decline | The transaction was partially approved but ultimately declined |
| Socket Timeout Exception | Settlement Is Being Processed | Settlement process timed out or is currently in progress |
ACH Error Messages
| Error Code | Error Message |
|---|---|
| ACH_TOKEN_ERR_01 | AchToken is required. |
| ACH_TOKEN_ERR_02 | Transaction amount is required. |
| ACH_TOKEN_ERR_03 | Invalid amount format. Please enter a valid number. |
| ACH_TOKEN_ERR_04 | Merchant account is inactive. |
| ACH_TOKEN_ERR_05 | Store account is inactive. |
| ACH_TOKEN_ERR_06 | ACHTransactionId is required for ACH void/refund. |
| ACH_TOKEN_ERR_07 | This transaction ID is not eligible for ACH void or refund. |
| ACH_TOKEN_ERR_08 | This transaction ID is not eligible for ACH void or refund. |
| ACH_TOKEN_ERR_09 | This transaction ID is not eligible for ACH void or refund. |
| ACH_TOKEN_ERR_10 | Transaction has already been voided or refunded. |
| ACH_TOKEN_ERR_11 | Invalid request payload. Please check the input and try again. |
| ACH_TOKEN_ERR_12 | Transaction not found. Please verify the transaction ID. |
| ACH_TOKEN_ERR_13 | Transaction has already been voided or refunded. |
| ACH_TOKEN_ERR_14 | Transaction has already been voided or refunded. |
| ACH_TOKEN_ERR_15 | Transaction has already been declined. |
| ACH_TOKEN_ERR_16 | Invalid request payload. Please check the input and try again. |
| ACH_TOKEN_ERR_17 | ACH is not enabled for this tpn. |
| ACH_TOKEN_ERR_18 | ACH is not enabled for this tpn. |
| ACH_TOKEN_ERR_19 | Transaction reference ID must be unique. |
| ACH_TOKEN_ERR_20 | Transaction not found. Please verify the transaction ID. |
| ACH_TOKEN_ERR_21 | Invalid request payload. Please check the input and try again. |
| ACH_TOKEN_ERR_22 | Invalid ach processor. |
HSA Error Codes and Message
| Error Code | Error Message |
|---|---|
| HSA_ERR_01 | Total Amount must not be passed when Optical Amount is provided for HSA Cards |
| HSA_ERR_02 | Optical Amount must be greater than zero |
| HSA_ERR_03 | Total Amount must be provided unless Optical Amount is present for HSA Cards. |
| HSA_ERR_04 | Total Amount must be greater than zero. |
| HSA_ERR_05 | Invalid HSA data. Please verify and resend the required fields. |
ACH Freedom To Design Error Codes And Messages
| Error Code | Error Message |
|---|---|
| FTD_ERR_001 | Host Name Cannot be null |
| FTD_ERR_002 | Token Required |
| FTD_ERR_003 | Invalid token provided |
| FTD_ERR_004 | TPN Status is not Active |
| FTD_ERR_005 | TPN is null or empty |
| FTD_ERR_006 | TPN Does not Exist |
| FTD_ERR_007 | Api Key Required |
| FTD_ERR_008 | Invalid Api Key |
| FTD_ERR_009 | Tpn Cannot be null |
| FTD_ERR_010 | Domain not Whitelisted |
| FTD_ERR_011 | PosParam Data Object is null |
| FTD_ERR_012 | PosParam Data Object is Empty |
| FTD_ERR_013 | PosParam TemplateValue Json is Empty |
| FTD_ERR_014 | PosParam Transaction Object is Empty |
| FTD_ERR_015 | Pos Param ValueAdd Object is null Empty |
| FTD_ERR_016 | Data Not Found |
| FTD_ERR_017 | TPN is null or empty |
| FTD_ERR_018 | Data Not Found |
| FTD_ERR_019 | No Data Found |
| FTD_ERR_020 | Alternate Processor Data Not Found |
| FTD_ERR_021 | Alternate Processor Data Not Found |
| FTD_ERR_022 | Alternate Processor Data Not Found |
| FTD_ERR_023 | Alternate Processor Data Not Found |
| FTD_ERR_024 | Alternate Processor Data Not Found |
| FTD_ERR_025 | Data Not Found |
| FTD_ERR_026 | Data Not Found |
| FTD_ERR_027 | Data Not Found |
| FTD_ERR_028 | Data Not Found |
| FTD_ERR_029 | Data Not Found |
| Failed | TPN Does not Exist |
| Failed | TPN Status is not Active |
Onboard Merchant API
| Error | Error Message |
|---|---|
| mandatory_field | If input field is mandatory |
| invalid_characters_or_length | If input field characters or length are not as specified |
| invalid_data | If input field data given is invalid |
| already_exists | If input given is already exists in our database |
| Methodinvalid_dependent_data | If dependent input given is invalid |
| invalid_object_name | If the payload has invalid object or not as specified |
| Error | Error message |
|---|---|
| mandatory_field | Merchant dba name input is mandatory |
| invalid_characters_or_length | Merchant dba name should have min 2 chars and upto 35 chars |
| mandatory_field | Merchant e-mail address input is mandatory |
| invalid_email | Merchant e-mail address should be valid and check email address is properly formatted |
| invalid_characters_or_length | Merchant e-mail address length cannot be exceed 255 chars |
| already_exists | Given merchant e-mail address input is already exists |
| mandatory_field | Merchant first name input is mandatory |
| invalid_data | Merchant first name input is invalid |
| invalid_characters_or_length | Merchant first name input should have min 2 & upto 50 characters |
| invalid_data | Merchant last name input is invalid |
| invalid_characters_or_length | Merchant last name input should have min 2 & upto 50 characters |
| mandatory_field | Merchant address line 1 input is mandatory |
| invalid_data | Merchant address line 1 input is invalid |
| invalid_characters_or_length | Merchant address line 1 input should have min 2 & upto 35 characters |
| invalid_data | Merchant address line 2 input is invalid |
| invalid_characters_or_length | Merchant address line 2 should have min 2 and upto 35 characters |
| mandatory_field | Merchant zip code input is mandatory |
| invalid_data | Merchant zip code input is invalid |
| mandatory_field | Merchant ISD code input is mandatory |
| invalid_data | Merchant ISD code input is invalid (eg., input format is +1) |
| mandatory_field | Merchant phone number input is mandatory |
| invalid_data | Merchant phone number input is invalid |
| invalid_characters_or_length | Merchant phone number input must have 10 characters |
| invalid_data | Merchant ebt data input is invalid, must be alphanumeric value |
| invalid_characters_or_length | Merchant ebt data input must have 7 characters |
| invalid_data | ISO agent reference input is invalid, must have alphanumeric value |
| invalid_characters_or_length | ISO agent reference input should have min 2 & upto 15 characters |
| invalid_data | ISO merchant input is invalid, must have alphanumeric value |
| invalid_characters_or_length | ISO merchant input should have min 1 & upto 6 characters |
| invalid_data | Merchant Logo URL input is invalid (Ex: https://example.com/image.png) |
| invalid_characters_or_length | Merchant Logo URL input value should not exceed 2000 characters |
| mandatory_field | Store dba name input is mandatory |
| invalid_characters_or_length | Store dba name input should have min 2 & upto 35 characters |
| already_exists | Given store dba name input is already exists |
| mandatory_field | Store email address input is mandatory |
| invalid_data | Store email address should be valid and check email address is properly formatted |
| invalid_characters_or_length | Store email address length cannot be exceed 255 chars |
| mandatory_field | Store first name input is mandatory |
| invalid_data | Store first name input is invalid |
| invalid_characters_or_length | Store first name input should have min 2 & upto 50 characters |
| invalid_data | Store last name input is invalid |
| invalid_characters_or_length | Store last name input should have min 2 & upto 50 characters |
| mandatory_field | Store address line 1 input is mandatory |
| invalid_data | Store address line 1 input is invalid |
| invalid_characters_or_length | Store address line 1 input should have min 2 & upto 35 characters |
| invalid_data | Store address line 2 input is invalid |
| invalid_characters_or_length | Store address line 2 should have min 2 and upto 35 characters |
| mandatory_field | Store zip code input is mandatory |
| invalid_data | Store zip code input is invalid |
| mandatory_field | Store ISD code input is mandatory |
| invalid_data | Store ISD code input is invalid (eg., input format is +1) |
| mandatory_field | Store phone number input is mandatory |
| invalid_data | Store phone number input is invalid |
| invalid_characters_or_length | Store phone number input must have 10 characters |
| mandatory_field | MCC code input is mandatory |
| invalid_data | MCC code input is invalid |
| invalid_characters_or_length | MCC code input must have 4 characters |
| invalid_mcc_code | invalid_mcc_code |
| mandatory_field | Device manufacture input is mandatory |
| invalid_data | Device manufacturer input is invalid |
| mandatory_field | Device model input is mandatory |
| invalid_data | Device model input is invalid |
| mandatory_field | Application sign input is mandatory |
| invalid_data | Application sign input is invalid |
| mandatory_field | Routing type input is mandatory |
| invalid_data | Routing type is invalid |
| mandatory_field | Bin number input is mandatory |
| invalid_data | Bin number input is invalid |
| invalid_characters_or_length | Bin number input must have 6 characters |
| invalid_data | Bin number input is invalid |
| invalid_characters_or_length | Bin number input must have 6 characters |
| invalid_data | Default label input is invalid |
| invalid_characters_or_length | Default label input should have min 1 and upto 18 characters |
| invalid_data | Assign template input is invalid, must be alphanumeric value |
| invalid_characters_or_length | Assign template input should have min 2 and upto 28 characters |
| mandatory_field | TPN processor name input is mandatory |
| mandatory_field | TPN profile input is mandatory |
| invalid_data | TPN profile input is invalid, must have 2 profiles |
| mandatory_field | TPN profile id input is mandatory |
| invalid_data | TPN profile id input should not be same to both profiles |
| invalid_data | TPN profile id input is invalid |
| mandatory_field | MID input is mandatory |
| invalid_data | MID input must be in number |
| invalid_characters_or_length | MID input must have 12 characters |
| invalid_data | MID input should not be same in both profiles |
| mandatory_field | Agent input is mandatory |
| invalid_data | Agent input must be in number |
| invalid_characters_or_length | Agent input number must hae 6 digits |
| mandatory_field | Chain input is mandatory |
| invalid_data | Chain input must be in number |
| invalid_characters_or_length | Chain input number must have 6 digits |
| mandatory_field | Store input is mandatory |
| invalid_data | Store input must be in number |
| invalid_characters_or_length | Store input number must have 4 digits |
| mandatory_field | TermNo input is mandatory |
| invalid_data | TermNo input must be in number |
| invalid_characters_or_length | TermNo input must have 4 digits |
| mandatory_field | TermId input is mandatory |
| invalid_data | TermId input must be in alphanumeric |
| invalid_characters_or_length | TermId input must have 8 characters |
| invalid_data | TermId input should not be same to both profiles |
| invalid_data | ABA_No input must be number |
| invalid_characters_or_length | ABA_No input must have 9 digits |
| invalid_data | Agent_FIID must be in alphanumeric |
| invalid_characters_or_length | Agent_FIID must have 4 characters |
| invalid_data | dsGroup input must be alphanumeric |
| invalid_characters_or_length | dsGroup must contain between 1 and 30 characters |
| mandatory_field | AccessTokenUser input is mandatory |
| invalid_data | AccessTokenUser input must be alphanumeric |
| invalid_characters_or_length | AccessTokenUser must have min 25 characters and should not exceed 56 characters |
| mandatory_field | AccessTokenPassword input is mandatory |
| invalid_data | AccessTokenPassword must be in alphanumeric |
| invalid_characters_or_length | AccessTokenPassword must have min 25 characters and should not exceed 50 characters |
| invalid_processor_name | invalid_processor_name |
| invalid_data | TerminalNumber input must be number |
| invalid_characters_or_length | TerminalNumber must have min 10 characters and should not exceed 16 characters |
| invalid_data | Password input must be alphanumeric |
| invalid_characters_or_length | Password must have min 6 characters and should not exceed 16 characters |
| invalid_data | Track2 input must be alphanumeric |
| invalid_characters_or_length | Track2 must have min 8 characters and should not exceed 18 characters |
| invalid_data | ApiKey input can have alphanumeric and following special characters _@.,/#&+’- |
| invalid_characters_or_length | ApiKey must have 45 characters |
| invalid_data | MID input can have alphanumeric and following special characters _@.,/#&+’- |
| invalid_characters_or_length | MID must have 15 characters |
| invalid_data | TermID input must be number |
| invalid_characters_or_length | TermID must have 8 characters |
| invalid_data | GroupID input must be number |
| invalid_characters_or_length | GroupID must have 5 characters |
| invalid_data | DID input must be number |
| invalid_characters_or_length | DID must have 5 characters |
| invalid_data | RegStatus input can have alphanumeric and following special characters _@.,/#&+’- |
| invalid_characters_or_length | RegStatus must have min 2 characters and should not exceed 3 characters |
| mandatory_field | Merchant Id input is mandatory |
| invalid_characters_or_length | Merchant Id input must have alphanumeric |
| invalid_data | Merchant Id input is invalid |
| mandatory_field | Store Id input is mandatory |
| invalid_characters_or_length | Store Id input must have alphanumeric |
| invalid_data | Store Id input is invalid |
Tap to Pay on iPhone
| Messages | Description |
|---|---|
notAllowed | Account not allowed |
backgroundRequestNotAllowed | Background request not allowed |
unsupported | Unsupported hardware or a problem with the device |
osVersionNotSupported | Please update your app to the latest iOS version |
modelNotSupported | Current device doesn't support NFC |
networkError | Please check your network settings and try again |
networkAuthenticationError | An authentication error occurred during the server connection |
serviceConnectionError | Internal service is unavailable |
notReady | Please try the session again to resolve the issue |
emptyReaderToken | The token is empty, making it invalid |
prepareExpired | Please reinitiate the session to try again |
tokenExpired | Token Expired |
readerMemoryFull | The card reader is busy |
accountNotLinked | Accept the Terms and Conditions using a valid Apple ID |
accountAlreadyLinked | Terms and Conditions have already been accepted |
accountLinkingFailed | The system couldn't link or relink the merchant using the provided Apple ID |
accountLinkingRequiresiCloudSignIn | Please accept the Terms and Conditions on your device while signed into iCloud |
accountLinkingCancelled | The linking or relinking operation has been canceled |
merchantBlocked | The merchant is blocked |
invalidMerchant | The merchant is invalid or unknown |
somethingWentWrong | The merchant is invalid or unknown |
cardReadFailed | The reader was unable to read a card |
invalidAmount | Amount must be positive and contain less than 10 digits |
invalidCurrencyCode | Currency code in the request must follow the ISO 4217 standard |
nfcDisabled | The user needs to enable their NFC |
noReaderSession | No reader session is available or the session isn't ready |
passcodeDisabled | Passcode disabled. Please set a security passcode on your device |
paymentCardDeclined | The payment card declined the transaction |
paymentReadFailed | An internal failure prevented the read operation |
pinCancelled | The current PIN capture was canceled, thereby canceling any ongoing read operation |
pinNotAllowed | The time window for capturing a PIN after a card read has expired |
pinEntryFailed | An error occurred when capturing the PIN |
pinEntryTimeout | The ongoing PIN capture was not completed within the given time |
pinTokenInvalid | An error that indicates an invalid PIN token |
readFromBackgroundError | Read operations aren't allowed when an app is running in the background |
readNotAllowed | This error usually occurs when there's an entitlement issue |
readNotAllowedDuringCall | Read operations aren't allowed during a phone call |
readerServiceConnectionError | The session wasn't able to connect the system UI or other services |
readerServiceError | Reader service internal state issue occurred |
readerSessionAuthenticationError | An authentication error occurred while refreshing reader session |
readerSessionBusy | The reader is busy with another session |
readerSessionExpired | The reader session expired and couldn't refresh due to other state changes |
readerSessionNetworkError | Network error occurred that prevented a reader session refresh |
readerTokenExpired | The configuration token for the reader session expired |
vasReadFail | Error occurred when reading a loyalty pass |
invalidReaderToken | Invalid reader token |
prepareFailed | Prepare session failed |
entitlementIssue | Please check the tap on phone entitlement configuration |
environmentIssue | The token key environment is not acceptable |
deviceSupportTapOnPay | Device Supports Tap to Pay |
deviceUnSupportTapOnPay | Your current device does not support NFC |
readerSessionCleanUp | Reader session cleaned up |