Transaction error codes
A transaction’s error_code
value can be null (for successful transactions) or one
of the following for failed and declined transactions.
Core failures
Our system can decline or fail a transaction, in contrast to a connector or payment service rejecting the transaction. When this happens,
one of the following error codes can be set as the error_code
value.
error_code | Description |
---|---|
incomplete_buyer_approval | Occurs when a buyer approval redirection times out, this normally means the buyer has closed the redirect page/popup without authenticating |
failed_buyer_approval | Occurs when a buyer fails to authenticate through 3DS. |
missing_redirect_url | Occurs when a transaction requires a redirect but was created without payment_method.redirect_url |
flow_decline | Occurs when a transaction is declined by a Flow rule. |
Connector declines
When a payment service rejects or fails the transaction the following error_code
values can be set based on the response received
from the payment service. The original values received from the payment service will be available in the raw_response_*
fields of
a transaction record.
The amount column in the tables below specifies the amount
that can be used
to simulate the error_code
when using the Card simulator connector.
error_code | Description | Simulator amount |
---|---|---|
canceled_payment_method | The payment method reported lost, stolen, or otherwise canceled. | 200001 |
disputed_transaction | The transaction cannot be refunded due to chargeback. | 200002 |
duplicate_transaction | The transaction is a duplicate of a previous transaction. | 200003 |
expired_authorization | The authorization has expired. | 200004 |
expired_payment_method | The payment method has expired. | 200005 |
incorrect_billing_address | The billing address does not match the account. | 200006 |
incorrect_country | The country code was rejected by the service or issuer. | 200007 |
incorrect_currency | The currency code was rejected by the service or issuer. | 200008 |
incorrect_cvv | The CVV was incorrect. | 200009 |
incorrect_expiry_date | The expiry date is incorrect or the payment method has expired. | 200010 |
insufficient_funds | The amount exceeds the available balance on the payment method. | 200011 |
issuer_decline | The payment was declined by the issuer. | 200012 |
other_decline | The transaction failed for an unknown reason but may succeed if retried. | 200013 |
requires_buyer_authentication | Additional credentials were requested by the issuer, for example, the security code (CVV). | 200014 |
refused_transaction | The transaction was refused due to legal reasons (e.g. watch list, embargo, sanctions). | 200015 |
service_decline | The payment was declined by service. | 200016 |
suspected_fraud | The service flagged the transaction as suspected fraud. | 200017 |
unavailable_payment_method | The payment method is temporarily frozen or otherwise unavailable. | 200018 |
unknown_payment_method | The account is unknown. | 200019 |
unsupported_transaction | The payment method does not support this type of purchase (e.g. gambling is restricted). | 200020 |
unsupported_payment_method | The payment method is not supported by the service (e.g. card scheme is not supported) | 200021 |
Connector failures
error_code | Description | Simulator amount |
---|---|---|
insufficient_service_permissions | The service credentials lack permission to perform the requested action. | 300001 |
invalid_amount | The amount not supported by service. | 300002 |
invalid_payment_method | The payment method is not supported by the service (e.g. card scheme is not supported). | 300003 |
invalid_service_configuration | The service is incorrectly configured. | 300004 |
invalid_service_credentials | The service credentials are not valid. | 300005 |
invalid_service_response | The service response could not be parsed. | 300006 |
invalid_tax_identifier | The tax identifier is invalid (e.g. GB VAT number is in an invalid format, or is of the wrong kind). | 300007 |
missing_billing_address | The billing address is required. | 300008 |
missing_cvv | The CVV is required. | 300009 |
missing_shipping_address | The shipping address is required. | 300010 |
missing_tax_identifier | The tax identifier is required. | 300011 |
refund_period_expired | The refund can not be performed due to the refund period expiring. | 300012 |
service_error | The service reported an internal server error or upstream processing error. | 300013 |
service_network_error | The service was unreachable or experienced a timeout. | 300014 |
service_rate_limit | The service responded with a rate-limiting error. | 300015 |
internal_error | An internal error has occurred. | 400001 |
invalid_billing_address | The billing address is invalid. | 400002 |
invalid_operation | The service/method is not implemented, and operation is not supported for this request. | 400003 |
invalid_request_parameters | The one or more request parameters are invalid. | 400004 |
invalid_service_request | The service request could not be parsed. | 400005 |
invalid_shipping_address | The shipping address is invalid. | 400006 |
service_resource_conflict | The service could not create a resource due to a conflict. | 400007 |
unexpected_state | The service is configured in an unexpected state. | 400008 |
unknown_error | An unknown error occurred. | 400009 |
unknown_service_resource | The resource could not be found by the service. | 400010 |
unsupported_country | The country is not supported by the service. | 400011 |
unsupported_currency | The currency is not supported by the service. | 400012 |
Was this page helpful?