# Códigos de error

Ejemplo de una respuesta con error:

```
{
    "errorCode": 901,
    "errorMessage": "Invalid API key"
}
```

## Checkout Creation

### Generales

| Código de error | Mensaje                        | Descripción                                            |
| --------------- | ------------------------------ | ------------------------------------------------------ |
| 806             | Authorization rejected by bank | El cobro fue rechazado por el banco                    |
| 105             | Generic error                  | Error genérico. Puede ser causado por reglas de fraude |

#### Errores con la cuenta del comerciante

| Código de error | Mensaje                                                          | Descripción                                                                                                                         |
| --------------- | ---------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| 304             | Merchant maximum amount exceeded                                 | El monto del cobro excede el máximo total permitido por el nivel del merchant                                                       |
| 305             | Merchant maximum amount per transaction exceeded                 | El monto del cobro excede el máximo por cobro permitido por el nivel del merchant                                                   |
| 306             | Merchant minimum amount per transaction not reached              | El monto del cobro no alcanza el mínimo por cobro requerido                                                                         |
| 307             | Merchant is not operative                                        | El merchant no ha completado los pasos para estar operativo, o su cuenta ha sido deshabilitada                                      |
| 308             | Merchant doesn't have any active payment methods for the country | El merchant no tiene ningún método de pago asociado a su cuenta para el país seleccionado                                           |
| 316             | Merchant only has CC payment methods                             | El merchant excede el monto permitido para pagar con tarjeta, y no tienen ningún método de pago asociado que no sea de tipo tarjeta |
| 901             | Invalid API key                                                  | La API key no es correcta                                                                                                           |
| 1400            | Merchant is in fraud review                                      | El merchant se encuentra en revisión                                                                                                |

#### Errores con información del checkout

| Código de error | Mensaje                                 | Descripción                                                                                                     |
| --------------- | --------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| 200             | The document type cannot be empty       | En caso de enviar un documento, el tipo de documento no puede ser vacío                                         |
| 201             | Invalid document                        | El formato del documento no es válido ([ver validaciones](/integraciones/checkout-api/referencia-de-paises.md)) |
| 903             | Invalid currency for country            | La moneda no está soportada por el país seleccionado                                                            |
| 904             | Duplicated invoice id                   | Ya existe un cobro con el invoice id seleccionado                                                               |
| 912             | Currency must be USD if country not set | Si se intenta crear un checkout sin país, la moneda seleccionada solamente puede ser USD                        |
| 1600            | Client not found                        | No existe el cliente seleccionado                                                                               |
| 1601            | Client is not from checkout's country   | El cliente seleccionado no es del país seleccionado en el checkout                                              |

### Específicos de cobros con cardId (tokenización)

#### Errores con la cuenta del comerciante

| Código de error | Mensaje                                             | Descripción                                                                                             |
| --------------- | --------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| 317             | Payment method is not added in the merchant account | Se intentó realizar un cobro utilizando un método de pago que no está asociado a la cuenta del merchant |

#### Errores con la tarjeta

| Código de error | Mensaje            | Descripción                            |
| --------------- | ------------------ | -------------------------------------- |
| 1700            | Card not found     | No se encontró la tarjeta seleccionada |
| 1701            | Card is not active | La tarjeta seleccionada no está activa |

#### Errores al intentar realizar el pago

| Código de error | Mensaje                      | Descripción                                    |
| --------------- | ---------------------------- | ---------------------------------------------- |
| 803             | Error collecting with card   | Ocurrió un error al intentar realizar el cobro |
| 804             | Error generating new payment | Ocurrió un error al intentar realizar el cobro |

## Consulta de estado

| Código de error | Mensaje               | Descripción                                |
| --------------- | --------------------- | ------------------------------------------ |
| 901             | Invalid API key       | La API key no es correcta                  |
| 500             | Transaction not found | No se encontró la transacción referenciada |

## Tokenización

### Guardado de tarjetas

| Código de error | Mensaje                           | Descripción                                                                                                     |
| --------------- | --------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| 901             | Invalid API key                   | La API key no es correcta                                                                                       |
| 200             | The document type cannot be empty | En caso de enviar un documento, el tipo de documento no puede ser vacío                                         |
| 201             | Invalid document                  | El formato del documento no es válido ([ver validaciones](/integraciones/checkout-api/referencia-de-paises.md)) |
| 800             | Error saving card                 | Ocurrió un error al intentar guardar la tarjeta                                                                 |

### Eliminado de tarjetas

| Código de error | Mensaje             | Descripción                                      |
| --------------- | ------------------- | ------------------------------------------------ |
| 901             | Invalid API key     | La API key no es correcta                        |
| 801             | Error deleting card | Ocurrió un error al intentar eliminar la tarjeta |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.directopago.com/integraciones/checkout-api/codigos-de-error.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
