Response Codes

Responses to any request clearly indicate if the request is processed successfully. We have integrated the following logic and groups in our response codes.

Status Object

Fields	Description	Type	Filterable	Required	Readonly	Level 1	Level 2	Level 3
status	Status Object	Object	No	No	Yes
status.status	`Approved`,`Declined`, `Error`	String	Yes	No	Yes	No	No	No
status.reason	Status reason	String	No	No	Yes	No	No	No

Approval Response

This is the only response that we will return only a status for it. Do not expect a status.reason here

Example:

"status": {
        "status": "Approved",
        "reason": null
    }

Decline Response

The decline response will include a status.reason giving you more details on the type of decline.

Example:

"status": {
        "status": "Declined",
        "reason": Insufficient Funds
    }

Here is a list of all possible decline codes:

Status Reason Message	Details
Duplicate Request (Approved previously)	The transaction was already performed and approved. Verify if the request was submitted twice for the same transaction ID or external reference number.
Reversal Not Allowed	The transaction is not authorized for reversal. This error may occur because the transaction was settled, declined, or already reversed.
Return Not Allowed	The transaction is not authorized for return. This error may occur because the transaction was not settled, was declined, or was already reversed.
Supervisor Override Required
Modify Transaction Not Allowed	The transaction is not authorized for modification. This error may occur because the transaction was already settled, or was declined.
Possible Duplicate Request	This is a duplicate request. The credentials for this transaction (i.e. amount, card number, or same service) are the same as another transaction submitted less than one minute apart.
Duplicate Request (Reversed previously)	The request with the same credentials (amount, card number, or same service) hit the server twice within a minute.
Inactive Device (Terminal)	The device is not registered, or is inactive in the system.
Device (Terminal) Configuration missing	The configuration parameter is missing.
Insufficient privileges
Incremental Auth Not Allowed
Unable to process your request. Settlement InProgress.	The transaction settlement is in progress.
Functionality currently not available.	The functionality is not supported by .
Inactive Merchant (Account)	The merchant is not registered, or is inactive in the system.
Merchant (Account) configuration missing	The configuration parameter is missing.
Processor configuration missing	The processor parameter is missing.
Unique ID Error	The terminal unique ID is invalid, or is not registered in the system.
Service Not Allowed
Inactive terminal (Backend)	The device is inactive or is not registered at the host.
Inactive account (Backend)	The account is inactive, or is not registered at the host.
Unique ID Error (Backend)	The terminal unique ID is invalid, or is not registered at the host.
Duplicate Request (Backend)	This is a duplicate transaction. This transaction was already approved and processed.
Reversal Not Allowed (Backend)	The transaction is not authorized for reversal. This error may occur because the transaction was settled, declined, or already reversed.
Return Not Allowed (Backend)	The transaction is not authorized for return. This error may occur because the transaction was settled, declined, or already reversed.
Re-enter transaction
Encryption failure from host
Return not allowed, Card number requested does not match with original transaction card number
Invalid taskID
Currency code mismatch with original transaction
Multiple amount format in single request not supported
Time out
System Error
Error on Host
System error (DB Insert)
Invalid store ID	Invalid store ID.
Invalid amount	Amount provided in request is invalid.
Coupon service is temporarily unavailable.	Coupon service is temporarily unavailable.
Host Auth initialization declined
Card not accepted by host
Host Auth finalization declined
Host connectivity failed
Host Reversal declined
Host Return initialization declined
Host Return finalization declined
Payment_Facilitator_ID is mandatory for VISA, Mastercard Payment facilitator transactions	The transaction does not contain Payment_Facilitator_ID information, which is mandatory for Payment Facilitator Visa and Mastercard transactions.
General Bill Pay Decline	General declined please contact help desk.
Refer to Issuer	The merchant must call the issuer to obtain verbal authorization.
Suspected Card (pick-up, hot-card)	This credit card has been flagged for fraud. the merchant should call the number on the back of the card to obtain further instructions. Suspected card error occurs in the following scenarios: - The card is restricted by the issuer - Loss of card is reported Theft of card is reported
Honor with identification?	The card is not identified.
Invalid Amount	The amount exceeds the limits established by the issuer for this type of transaction.
Invalid Card	The issuer indicates that this card is invalid.
No such issuer	The card issuer number is invalid.
Invalid fee	The transaction fee is unacceptable.
Incorrect Pin	The PIN entered by the cardholder is incorrect.
Pin attempts exceeded	The number of attempts to enter the PIN has exceeded.
Key synchronization failed from the host	The failure of a key synchronization from the host.
Expired Card	The card has expired.
Insufficient Funds	The credit limit for this account has been exceeded, or the amount is not enough to perform the transaction.
Invalid From Account	The transaction account is invalid.
Invalid To Account	The transaction account is invalid.
Withdrawal Limit exceeded	The withdrawal limit on an account is exceeded.
Withdrawal frequency exceeded	The withdrawal frequency on an account is exceeded.
Time limit for Pre-Auth reached	The time for Pre-Auth has reached its limit.
AVS FAILED	The address verification has failed and the merchant is configured for auto decline on AVS failure.
Billing ZIP Mismatch	The zip provided does not match the billing address on file and the merchant is configured for auto decline on ZIP code mismatch.
CVV2 verification failed	The V code provided is invalid or does not match what is on file and the merchant set up for auto decline on CVV2 failure.
Issuer or Switch inoperative	The bank is unavailable to authorize this transaction.
Duplicate transaction ( Same amount / Account)	The transaction with the same amount and account is performed twice.
Balance unavailable for inquiry	The balance cannot be validated.
Check Digit Err	The credit card number entered did not pass validation. Correct and re-enter the credit card number.
Excluded Bin ID for Merchant	Card is not allowed to do transactions at this merchant.
Do not honor	The transaction was declined by the issuer.
AVS and CVV2 failed	The address verification and V code verification failed and the merchant set up for auto decline on AVS and CVV2 failure.
Invalid Date	The credit card expiration date is invalid. Verify and re-enter the expiration date.
Invalid Service	The service provided by the card is invalid.
Host Validation Error	The host is an invalid host.
Activity Limit exceeded	The daily card activity limit has been exceeded.
Cannot complete because of Violation	The transaction cannot be completed because the credit card account has been flagged with a violation.
Debit Pin Required	The BIN is blocked by the issuer.
Check Service authentication failure
Could Not Retrieve a Valid Card Number for Token
Card information is not provided
No Card found for the BIN
Card verification failed for card number	Verification of the card number has failed.
PreFraudScout Decline	Transaction is declined in Pre Fraud rules.
General Card Auth Decline	This is a general decline error.
Blocked Account	The account provided in transaction is blocked.
Blocked Check	The check provided in transaction is blocked.
Invalid Token
Service Not Allowed

Error Response

These are rare and are usually returned due to incorrect request formatting or general system errors.

Status Reason Message	Details
Format Error field details	Check the formatting of your request parameters
Customer requested stop of all recurring payments from specific merchant
Transaction is in process. Please try again after some time.	Simultaneous actions cannot be performed on the same customer record. The application is unable to perform edits on a customer record while the record is in use.
An error has occurred. Your request couldn't be processed because of a technical issue. Please try again later. We apologize for the inconvenience. Our technical team has been notified	This is a system general error and you can contact us if you are experiencing these errors for more information.

Approval Response#

Decline Response#

Error Response#

Approval Response

Decline Response

Error Response