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(enMAYÚSCULAS) ystatus_reason_message. La tabla a continuación enumera todos los posibles códigos enMAYÚSCULASpara esta versión. - Intenciones de Pago y Cargos (V1): Utiliza
failure_code(enminúsculas) yfailure_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:
|
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:
|
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. |