# 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](https://docs.directopago.com/integraciones/checkout-api/referencia-de-paises)) |
| 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](https://docs.directopago.com/integraciones/checkout-api/referencia-de-paises)) |
| 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 |
