Payment Failures & Forte Error Codes

Updated by Janelle Heuton

Payment Status

All payments are processed by Forte. These transactions are displayed in the Transaction sub-tab in Payments. If the transaction was processed successfully, the status will show as completed. You can also see if a payment failed, has been voided, reversed, or refunded.

Payment Failures

In the event a payment failed, there may be several reasons for the failure. You can view the transaction and, based on the code provided by Forte, understand why the payment failed.

First, open the specific transaction by clicking on the Transaction ID from the table. This will provide more details about this specific transaction including payment vendor details. The Payment Vendor Details section contains a transaction ID, Action, Status, and Response. The Response line will display a description along with a code provided by Forte. You can use this line to understand why the payment failed.

Forte Transaction Response Codes

Transactions that are accepted for processing return the A01 response code. Transactions that are rejected for processing return the "U" response codes. The table below is a list of the various codes from Forte that may be in the Response line and what they mean. Please keep in mind that gWorks has no control over these codes; they are provided by the payment vendor as a direct result of the payment process. The information below is provided by Forte - any questions or concerns about these items should be addressed directly with them. For more information, review Forte's Transaction and Settlement Codes.

Code

Description

Comments

A01

APPROVED

Transaction approved/completed

A03

PARTIAL AUTHORIZATION

Transaction approved for a partial authorization (credit card only)

U02

ACCOUNT NOT APPROVED

The customer is either:

U03

DAILY TRANS LIMIT

Merchant daily limit exceeded (EFT only)

U04

MONTHLY TRANS LIMIT

Merchant monthly limit exceeded (EFT only)

U05

AVS FAILURE ZIPCODE

AVS state/area code check failed. Ensure that you've entered the correct zip code and state abbreviation.

U06

AVS FAILURE AREACODE

AVS state/area code check failed. Ensure that you've entered the correct area code for the phone number and state abbreviation. 

U07

AVS FAILURE EMAIL

AVS anonymous email check failed. Ensure the customer's provided email address is not from a free service like hotmail.com or gmail.com.

U08

DAILY VELOCITY

Merchant has exceeded the maximum number of transactions per hour, which may indicate a security problem. This error rarely occurs, but if you receive it, contact Forte by calling Customer Service at 800-337-3060 option 1.

U09

WINDOW VELOCITY

Merchant has exceeded the maximum number of transactions per hour, which may indicate a security problem. This error rarely occurs, but if you receive it, contact Forte immediately by calling Customer Service at 800-337-3060 option 1.

U10

DUPLICATE TRANSACTION

The transaction has the same attributes (e.g., authorization amount, payment method, billing address, etc) as another transaction within the time set by the merchant in Dex echeck settings. If you do not set a Duplicate Timeout time, Forte defaults to five minutes.

U11

RECUR TRANS NOT FOUND

The recurring transaction cannot be found. This error will trigger when a recurring transaction cannot be identified when attempting to suspend, activate, or delete a recurring transaction within a schedule.

U12

UPDATE NOT ALLOWED

The original transaction is not voidable or captureable. Transactions in the following statuses can be neither voided nor captured: 

U13

ORIG TRANS NOT FOUND

The original transaction that you are attempting to void or capture cannot be found. Ensure the original_transaction_id included in the request is correct.

U14

BAD TYPE FOR ORIG TRANS

This error occurs when you attempt to void a credit card transaction with the authorization code from an echeck transaction or when you attempt to void an echeck transaction with the authorization code from a credit card transaction.

U15

ALREADY VOIDEDALREADY CAPTURED

The transaction was previously voided or captured.

U18

UPDATE FAILED

The void or capture operation failed due to a malformed request. Ensure the authorization number and amount match the original transaction you wish to void or capture.

U19

INVALID TRN

The provided Bank Routing Number is invalid. Ensure you entered the correct routing number and try again.

U20

INVALID CREDIT CARD NUMBER

The provided credit card number is invalid. Re-enter it and try again.

U21

BAD START DATE

The start date of the submitted schedule is in the past or is not in MM/DD/YYYY format. Schedule start dates must be today's date or greater. If you do not specify this value, Forte uses today's date.

U22

SWIPE DATA FAILURE

The provided swipe data is malformed. This could mean it's missing characters or was not copied over correctly. Re-swipe the card and attempt the transaction again. 

U23

INVALID EXPIRATION DATE

The provided expiration date is malformed. Expiration dates must conform to MM/YYYY or MM/YY formatting and be a valid future date.

U25

INVALID AMOUNT

The authorization amount is negative.

U26

INVALID DATA

The transaction request contains invalid data. This could mean you've included fields that are not part of the objects in the request or fields that are irrelevant to the request. Double-check the request before submitting it again. 

U27

CONV FEE NOT ALLOWED

The merchant sent a convenience fee but is not configured to accept one. Only convenience fee merchants can accept convenience fees.

U28

CONV FEE INCORRECT

The merchant is configured for a convenience fee and either did not send one or sent the incorrect amount for the convenience fee. Convenience fees can be either a set amount or a percentage of the authorization amount. 

U29

CONV FEE DECLINED

The convenience fee transaction of a SplitCharge failed. The SplitCharge service model is where two transactions are processed: one amount is for the principle, and the other is for the service fee. This error triggers when the service fee transaction (i.e., the charge that goes to Forte) fails to process. 

U30

PRINCIPAL DECLINED

The principal transaction of a SplitCharge failed. The SplitCharge service model is where two transactions are processed: one amount is for the principle, and the other is for the service fee. This error triggers when the principal amount of the transaction (i.e., the charge that goes to the merchant) fails to process. 

U51

MERCHANT STATUS

This error occurs when a merchant attempts an operation that is not available in the sandbox environment (e.g., disputes can only be retrieved in Live). You may not be live because of contract or testing issues. To check your live status, call Forte's Customer Service Team at 800-337-3060 option 1.

U52

TYPE NOT ALLOWED

This error occurs when a credit-card-only merchant attempts to send an echeck transaction or when an echeck-only merchant attempts to send a credit card transaction. Check your merchant configuration in Dex to determine what services your configured to use. 

U53

PER TRANS LIMIT

The transaction amount exceeds the merchant's maximum transaction limit (echecks only). To proceed with the transaction, the merchant must complete the Over Transaction Limit Notification form and fax it to the number listed on the form. 

U54

INVALID MERCHANT CONFIG

Your merchant account's configuration requires updating. Call Forte's Customer Service Team at 800-337-3060 option 1.

U78

DISALLOWED ACH SEC CODE

Merchant accounts are configured for specific SEC codes. Most merchants are configured to support WEB, TEL, PPD, and CCD SEC codes. When a merchant attempts to send a non-configured SEC code (e.g., BOC or ATX), this error is triggered. 

U80

PREAUTH DECLINE

Transaction was declined due to a pre-authorization (Forte Verify) result. Forte Verify is a subscription service that looks up the status of an echeck account to determine if the customer account is valid and in good standing. To view the specific reason why an account was declined, see the preauth_result, preauth_desc, and preauth_neg_report fields in the response. 

U81

PREAUTH TIMEOUT

The pre-authorizer not responding (Forte Verify transactions only). This error indicates that the Forte Verify service has timed out and cannot retrieve a value for the preauth_result. Wait 5-10 minutes before retrying the transaction. 

U82

PREAUTH ERROR

Pre-authorizer error (Forte Verify transactions only). This error indicates the Forte Verify pre-authorizer is experiencing a problem. Wait 5-10 minutes before retrying the transaction. If the error persists, submit a  ticket to Forte Customer Service. 

U83

AUTH DECLINE

The transaction was declined by the authorizer. To determine the reason for the declination, contact the number on the back of the card. 

U84

AUTH TIMEOUT

The authorizer is not responding. Wait 5-10 minutes before retrying the transaction. 

U85

AUTH ERROR

Authorizer error. This error indicates that the authorizer is experiencing a problem. Wait 5-10 minutes before retrying the transaction. If the error persists, submit a  ticket to Forte Customer Service. 

U86

AVS FAILURE AUTH

The authorizer's address verification services failed. Ensure the billing address for the transaction was correctly submitted and try again. 

U87

AUTH BUSY

The authorizing vendor is busy. Wait 5-10 minutes and resubmit the transaction (credit cards only).

U88

PREAUTH BUSY

The verification vendor is busy. Wait 5-10 minutes and resubmit the transaction (Forte Verify transactions only).

U89

AUTH UNAVAIL

The authorization service is unavailable. Wait 5-10 minutes and resubmit the transaction (credit cards only).

U90

PREAUTH UNAVAIL

The verification vendor is busy. Wait 5-10 minutes and resubmit the transaction (Forte Verify transactions only).

X02

VOIDED

A batch transaction was voided


How did we do?


Powered by HelpDocs (opens in a new tab)