Transactions
Transaction error codes
Transactions
Transaction error codes
A list of all error codes for transactions.
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. |
all_attempts_skipped | Occurs when a transaction fails because no outcome in the matched Flow rule could be used to process the transaction reliably. To avoid this, make sure to define at least one outcome for each possible transaction scenario. |
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 |