Processing Error Codes

Everything you need to know about error codes and how to resolve them.

These are some processing error codes that you may encounter during your payments journey with Tilled. In the event that you encounter any of these error codes, the error code library is available to provide more information. The initial description of each error code includes information about that error code as well as a solution. However, you can contact [email protected] if you have any additional questions.

Card Declines

Cards can be declined due to a variety of reasons such as insufficient funds, expired card, or suspicious activity that could indicate fraud. When a card is declined, it means the card issuer was unable or unwilling to provide an authorization for the requested transaction. The card issuer typically provides a response with more details on the reason for the decline.

Error Code	Error Message	Solution
`INSUFFICIENT_FUNDS`	There are insufficient funds on the card to complete the transaction.	A different payment method must be used by the customer.
`AVS_CHECK_FAILED`	Due to a failed AVS (Address Verification System) check, the card was declined.	The address you enter during the checkout process must match the billing address on your credit card.
`GENERIC_DECLINE`	The card was declined for an unidentified reason.	For more information, the customer should contact their bank.
`CALL_ISSUER`	See `GENERIC_DECLINE`.	For more information, the customer should contact their bank.
`EXPIRED_CARD`	The expiration date has passed.	The customer must use a different card.
`PICKUP_CARD`	This card may have been reported lost or stolen. The customer cannot use it to make a purchase.	The customer needs to contact their card issuer for more information.
`INVALID_NUMBER`	The card number is invalid.	The customer must try again using the correct card number.
`LIMIT_EXCEEDED`	The customer's balance or available credit limit on their card has been exceeded.	The customer needs to contact their card issuer for more information.
`NOT_PERMITTED`	The payment is not allowed.	The customer needs to contact their card issuer for more information.
`INCORRECT_CVC`	The CVC number is incorrect.	The customer must try again using the correct CVC.
`SERVICE_NOT_ALLOWED`	See `GENERIC_DECLINE`.	The customer needs to contact their card issuer for more information.
`INVALID_EXPIRY`	The expiration date is invalid.	The customer must try again using the correct expiration date.
`CARD_NOT_SUPPORTED`	This type of purchase is not permitted with the card.	To confirm that their card can be used for this type of purchase, the customer needs to contact their card issuer.
`RESTRICTED_CARD`	See `PICKUP_CARD`.	The customer needs to contact their card issuer for more information.
`FRAUDULENT`	Tilled declined the payment because they believed it to be fraudulent.	Avoid providing your customer with more specific details. Instead, advise the customer to get in touch with the card issuer for more information
`PROCESSING_ERROR`	An error occurred while processing the card.	Retry the payment. Try again later if it is still unable to be processed.

ACH Debit Returns

ACH returns occur when an ACH transaction is unable to be processed. This could happen for a variety of reasons, including incorrect account information, insufficient funds in the account, or a closed account. When an ACH return occurs, the funds are returned to the original account, and the transaction is canceled.

Error Code	Error Message	Solution
`INSUFFICIENT_FUNDS`	There are insufficient funds on the account to complete the transaction.	Contact the account holder to discuss other payment options, or attempt the transaction again once sufficient funds are available.
`ACCOUNT_CLOSED`	The account has been closed.	Verify the account information and attempt the transaction again with the correct account information, or contact the account holder to obtain updated account information.
`NO_ACCOUNT`	The account cannot be located based on the provided account number.	Verify the account information and attempt the transaction again with the correct account information, or contact the account holder to obtain updated account information.
`ACCOUNT_NUMBER_INVALID`	The account number is invalid.	Verify the account information and attempt the transaction again with the correct account information, or contact the account holder to obtain updated account information.
`AUTHORIZATION_REVOKED`	Account holder revoked authorization of the payment.	Contact the account holder to determine the reason for revoking authorization and take appropriate action to resolve the issue.
`STOP_PAYMENT`	The account holder has placed a stop payment order on this payment.	Contact the account holder to determine the reason for stopping payment and take appropriate action to resolve the issue.
`NOT_RECOGNIZED`	Account holder has notified their bank that they do not recognize the entity attempting to debit their account.	Verify that the account holder has authorized the transaction, and if not, contact the account holder to resolve the issue.
`ACCOUNT_FROZEN`	The account has been frozen.	Contact the account holder to determine the reason for the freeze and take appropriate action to resolve the issue. If the account is frozen due to legal action, consult with legal counsel to determine the next steps.
`NOT_PERMITTED`	Transactions are prohibited or limited against this account.	Verify the account information and ensure that the account is a valid transaction account. If the account is not a transaction account, contact the account holder to obtain the correct account information.
`INVALID_FIELD`	Mandatory fields have either incorrect or missing data.	Review the transaction information and ensure that all required fields are completed correctly. Resubmit the transaction with the correct information.
`NOT_AUTHORIZED`	Account holder has notified their bank that the payment was not authorized.	Verify that the transaction was authorized by the corporate account holder. If not, contact the corporate account holder to resolve the issue. If the transaction was authorized, contact the receiving bank to determine the reason for the return and take appropriate action.