Error Codes

The Convergegate Gateway API may return standardized error codes to indicate the reason for a payment failure or rejection. Each code is accompanied by a short description.

ℹ Tip: Always log the code along with the accompanying message from the API response for easier troubleshooting.

1.xx – General Errors

Code	Description
1.00	Illegal Workflow State
1.01	Not Found
1.02	Communication Problem
1.03	Internal Server Error
1.04	Cancelled by Timeout
1.05	Terminal not Found
1.06	Recurring Token not Found
1.07	Payer Unaccepted
1.08	Invalid Amount
1.09	Invalid Currency
1.10	Insufficient Balance

2.xx – Customer Cancellations

Code	Description
2.00	Cancelled by Customer

3.xx – Acquirer-Related Declines

Code	Description
3.00	Declined by Acquirer
3.01	Declined by Acquirer: Anti-fraud
3.02	Declined by Acquirer: Request Validation
3.03	Acquirer Malfunction
3.04	Acquirer Timeout
3.05	Acquirer Limits Reached
3.06	Declined by Acquirer: Card Scheme
3.07	Declined by Acquirer: Card Data
3.08	Declined by Acquirer: Business Rules
3.09	Not Fully 3DS
3.10	Unknown Error Code
3.11	Payer cannot pay
3.12	Invalid ID Document
3.13	ID Document Restrictions
3.14	Declined Due to Age Requirements
3.15	ID Document Under Temporary Restrictions
3.16	Duplicate Payment
3.17	Channel not active
3.18	Cancelled or abandoned transaction
3.19	Card PAN blacklisted
3.20	Card PAN not whitelisted
3.21	Invalid mobile number
3.22	Card BIN country not allowed

4.xx – Issuer-Related Declines

Code	Description
4.00	Declined by Issuer
4.01	Insufficient Funds
4.02	Do Not Honor
4.03	Invalid Account Number
4.04	Invalid card expiration date
4.05	Issuer Limits Reached
4.06	Card not active
4.07	Invalid Security Code
4.08	Declined by Issuer: Business Rules
4.09	Declined by Issuer: Anti-fraud
4.10	Transaction not permitted to cardholder
4.11	AVS failed

5.xx – 3D Secure (3DS) Errors

Code	Description
5.00	Declined by 3DS
5.01	3DS Timeout
5.02	ACS malfunction

6.xx – Internal Anti-fraud Declines

Code	Description
6.00	Declined by Internal Anti-fraud
6.01	Card PAN Blacklisted
6.02	Customer Email Blacklisted
6.03	Card Issuing Country Restricted
6.04	IP Country Restricted
6.05	Restricted Currency
6.06	Invalid Amount
6.07	IP Country Must Be Equal to Billing Country
6.08	IP Country Must Be Equal to Card Issuing Country
6.09	Billing Country Must Be Equal to Card Issuing Country
6.10	Payment Created Within Closed Period of Day
6.11	Card PAN not Whitelisted
6.12	Cardholder name is invalid
6.13	The same card is used by different customers
6.14	Customer Phone Blacklisted
6.15	Card Brand not supported
6.21–6.46	Various limit breaches and blacklists (see API documentation for full details)

7.xx – External Anti-fraud Declines

Code	Description
7.00	Declined by External Anti-fraud
7.01	External Anti-fraud Communication Problem