# Introducción

Códigos de Error V1 vs V2
Nuestra API de Pagos proporciona detalles de error en diferentes parámetros dependiendo de la versión que uses:

- **Autorizaciones de Pago y Cargos (V2):** Utiliza `status_reason_code` (en `MAYÚSCULAS`) y `status_reason_message`. La tabla a continuación enumera todos los posibles códigos en `MAYÚSCULAS` para esta versión.
- **Intenciones de Pago y Cargos (V1):** Utiliza `failure_code` (en `minúsculas`) y `failure_message`. Por ejemplo, `beneficiary_bank_revoked_authorization`.


Cuando una Autorización de Pago o un Cargo asociado (V2) encuentra un error, Belvo actualiza el `status` del recurso dado. Además, Belvo proporciona información detallada sobre el cambio de estado en los parámetros `status_reason_code` y `status_reason_message` para ayudarte a entender qué salió mal.

A continuación se muestra una tabla completa de todos los posibles valores de `status_reason_code` y sus mensajes correspondientes:

| Código  | Mensaje (Solo EN) |
|  --- | --- |
| `ACCOUNT_NOT_ALLOWED` | The payer account does not allow payments. |
| `AMOUNT_OVER_LIMIT` | La cantidad excede el límite máximo para la cuenta. |
| `AUTHORIZATION_EXPIRED` | La Autorización de Pago no se completó dentro del período permitido. |
| `BANK_USER_MISMATCH` | El usuario bancario autenticado difiere del usuario pagador. |
| `BENEFICIARY_ACCOUNT_BLOCKED` | La cuenta bancaria del beneficiario está bloqueada. |
| `BENEFICIARY_ACCOUNT_CLOSED` | La cuenta bancaria del beneficiario está cerrada. |
| `BENEFICIARY_ACCOUNT_ERROR` | El Cargo no pudo completarse debido a un error inesperado en la cuenta del beneficiario. |
| `BENEFICIARY_ACCOUNT_NUMBER_INVALID` | El número de cuenta bancaria del beneficiario es inválido o inexistente. |
| `BENEFICIARY_ACCOUNT_TYPE_INVALID` | El tipo de cuenta bancaria del beneficiario no permite este tipo de acción. |
| `BENEFICIARY_ACCOUNT_TYPE_NOT_SUPPORTED` | El tipo de transacción no es compatible o autorizado por la cuenta del beneficiario. |
| `BENEFICIARY_BANK_REJECTED_CHARGE` | El Cargo fue rechazado por la institución del beneficiario. |
| `BENEFICIARY_CANCELLED_RECURRING_PAYMENT` | El beneficiario canceló el programa de pago recurrente. |
| `BENEFICIARY_IDENTIFIER_INVALID` | El CPF o CNPJ del beneficiario es incorrecto. |
| `BENEFICIARY_IDENTIFIER_MISMATCH` | El CPF o CNPJ del beneficiario no coincide con el titular de la cuenta. |
| `BENEFICIARY_REVOKED_AUTHORIZATION` | El beneficiario revocó la Autorización de Pago. |
| `CANCELLATION_NOT_ALLOWED_CHARGE` | El Cargo está en un estado que no permite cancelación. |
| `CANCELLATION_NOT_ALLOWED_PAYMENT_AUTHORIZATION` | La Autorización de Pago está en un estado que no permite cancelación. |
| `CANCELLED_WHILE_PENDING` | El Cargo fue cancelado mientras estaba en estado PENDIENTE. |
| `CANCELLED_WHILE_SCHEDULED` | El Cargo fue cancelado mientras estaba en estado PROGRAMADO. |
| `CHARGE_EXCEEDS_AUTHORIZED_AMOUNT` | El monto del Cargo excedió los límites definidos en la Autorización de Pago. |
| `CHARGE_PERIOD_LIMIT_REACHED` | El número de Cargos excedió el total permitido para el período, según lo definido en la Autorización de Pago. |
| `CHARGE_SETTLEMENT_FAILED` | Ocurrió un error al procesar la liquidación del Cargo. |
| `CHARGE_SETTLEMENT_TIMEOUT` | El Cargo no pudo completarse debido a un tiempo de espera agotado. |
| `DUPLICATE_BENEFICIARY_CHARGE` | Se detectó un Cargo duplicado para el mismo beneficiario. |
| `FRAUD_SUSPECTED` | El Cargo fue rechazado debido a sospecha de fraude. |
| `IDENTIFIER_MISMATCH` | El Identificador de Cliente de la Autorización de Pago no coincide con el identificador del propietario de la cuenta en la institución. |
| `INSUFFICIENT_FUNDS` | Fondos insuficientes en la cuenta bancaria del pagador. |
| `INSUFFICIENT_PERMISSION` | El pagador asociado con la Autorización de Pago no tiene permisos suficientes para realizar acciones para la cuenta. |
| `INVALID_AMOUNT_QRCODE` | El valor enviado no es válido para el Código QR ingresado, o el Código QR utilizado para iniciar el pago no es válido. |
| `INVALID_CHARGE` | Este Cargo no puede procesarse porque el Cargo ha expirado, ha pasado su fecha de vencimiento o tiene un estado inválido. |
| `INVALID_PAYMENT_AUTHORIZATION` | La Autorización de Pago está en un estado final y no puede usarse para más Cargos. |
| `NO_REASON_PROVIDED` | La institución no proporcionó una razón de error. |
| `OPEN_FINANCE_NETWORK_FAILURE` | Uno de los siguientes:- El pago fue rechazado por el sistema SPI.
- Hubo una falla en la infraestructura del SPI.
- Hubo una falla en la infraestructura del DICT.
- Hubo una falla en la infraestructura del PKI.
- Hubo una falla en la infraestructura del PSP receptor.
- Hubo una falla en la infraestructura del titular de la cuenta.

 |
| `OUTSIDE_ALLOWED_TIMEFRAME` | El intento de programación se realizó fuera del período permitido y no fue aceptado por la institución. |
| `PARTIALLY_ACCEPTED_PAYMENT_AUTHORIZATION` | La Autorización de Pago debe ser aceptada por todos los propietarios de la cuenta. |
| `PAYER_ACCOUNT_TIMEOUT_ERROR` | La liquidación del Cargo falló debido a un tiempo de espera agotado en la cuenta del pagador. |
| `PAYER_BLOCKED_BY_REGULATORY_REASON` | El Cargo fue rechazado porque el pagador está bloqueado por razones regulatorias. |
| `PAYER_REVOKED_AUTHORIZATION` | El pagador revocó la Autorización de Pago. |
| `PAYMENT_CONSENT_MISMATCH` | La información proporcionada para este Cargo difiere de la Autorización de Pago asociada. |
| `PAYMENT_NOT_COMPLETED_CONSENT_EXPIRED` | El Cargo no se completó dentro del tiempo autorizado. |
| `PAYMENT_REFUSED_BY_HOLDER` | El pagador rechazó el Cargo. |
| `PAYMENT_SCHEDULING_FAILURE` | La institución no pudo programar el pago. |
| `REJECTED_UNKNOWN` | La Autorización de Pago fue rechazada por razones desconocidas. |
| `REVOKED_PAYMENT_AUTHORIZATION` | El Cargo está asociado con una Autorización de Pago que fue revocada. |
| `REVOKED_UNKNOWN` | La Autorización de Pago fue revocada por razones desconocidas. |
| `SAME_ORIGIN_DESTINATION_ACCOUNTS` | Las cuentas del beneficiario y del pagador son las mismas. |
| `SETTLEMENT_LIMIT_REACHED` | Se alcanzó el número máximo de intentos para liquidar el Cargo en la institución. |
| `SYSTEM_ERROR` | La solicitud no pudo completarse debido a un error del sistema. |
| `UNEXPECTED_ERROR` | Uno de los siguientes:- Ocurrió un error inesperado al procesar el Cargo.
- Ocurrió un error inesperado al procesar la Autorización de Pago.

 |
| `USER_DAILY_LIMIT_REACHED` | Se alcanzó el límite diario máximo del usuario para la cuenta. |
| `USER_PERIOD_LIMIT_REACHED` | Se alcanzó el límite máximo del usuario para la cuenta y para el período. |
| `USER_REJECTED` | El pagador rechazó la Autorización de Pago. |