Transaction Error Codes

Various errors can occur during transaction processing. To clearly indicate where a failure occurred and who is responsible for resolving it, a structured set of error codes is used. These codes are included in the status detail of any failed transaction.

A separate consumer message is available for display to end users. This message can be localized and is designed to avoid exposing internal error codes or sensitive system details.

Validation

Validation errors, identified by codes starting with “V”, indicate an issue with the submitted data or the state of related entities such as the merchant account, store, or existing transactions. These errors can typically be resolved by correcting the input data or ensuring that all related entities are in the required state.

Processor

For processor errors (starting with P) the payment processor returned an error code indicating the transaction could not be completed. This could be caused by for example outages at the processor or because of the consumer not correctly completing the transaction.

Sometimes the processor can also return a status detail code, when present this can also be found on the transaction in the status processor code.

General

General errors (starting with E) indicate there is an issue at Buckaroo. We will investigate what is going wrong and fix where needed. This could be an internal error, or an unexpected communication failure with a payment processor.