> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Razón de error del Payment intent

Los Payment Intents pueden fallar por diversas razones. La razón por la que falló un payment intent específico está disponible en el atributo `error_reason` de un [Payment Intent Object](/es/reference/payments-api/payment-intents/payment-intents-object).

A continuación se muestra una lista de todos los tipos de `error_reason` que enviamos actualmente. Podemos agregar más en cualquier momento, por lo que al desarrollar y mantener tu código, no deberías asumir que solo existen estos tipos.

## Transferencias bancarias

Los valores de `error_reason` de transferencias bancarias usan estas descripciones:

| error\_reason                               | descripción                                                                                                                                                                             | país      |
| ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| `bank_account_locked`                       | El banco bloqueó el servicio de transferencias para esta cuenta.                                                                                                                        | 🇨🇱      |
| `bank_connection_error`                     | Fintoc tuvo un problema para conectarse con el banco seleccionado.                                                                                                                      | 🇨🇱      |
| `bank_not_available`                        | El banco seleccionado no está disponible temporalmente.                                                                                                                                 | 🇨🇱      |
| `amount_limit_reached`                      | Se alcanzó el monto máximo disponible para transferir.                                                                                                                                  | 🇨🇱      |
| `insufficient_funds`                        | La cuenta no tiene saldo suficiente para ejecutar el pago.                                                                                                                              | 🇨🇱      |
| `login_credentials_locked`                  | El banco indicó que las credenciales del usuario están bloqueadas.                                                                                                                      | 🇨🇱      |
| `login_invalid_credentials`                 | El banco indicó que las credenciales del usuario son inválidas.                                                                                                                         | 🇨🇱      |
| `maximum_amount_error`                      | El monto excede el monto máximo permitido para ese banco.                                                                                                                               | 🇨🇱      |
| `mfa_authorization_timeout`                 | El usuario no autorizó la transferencia con su método multifactor.                                                                                                                      | 🇨🇱      |
| `mfa_invalid_authorization`                 | El banco indicó que la autorización multifactor fue inválida.                                                                                                                           | 🇨🇱      |
| `mfa_locked`                                | El método de autenticación multifactor está bloqueado.                                                                                                                                  | 🇨🇱      |
| `mfa_unavailable`                           | El método de autenticación multifactor no está disponible.                                                                                                                              | 🇨🇱      |
| `new_contact_amount_limit_reached`          | El monto excede el máximo permitido para nuevos contactos.                                                                                                                              | 🇨🇱      |
| `new_contact_transfer_number_limit_reached` | Se alcanzó el número máximo de transferencias para nuevos contactos.                                                                                                                    | 🇨🇱      |
| `recipient_account_not_allowed`             | El banco indicó que la cuenta destinataria no está autorizada para recibir transferencias.                                                                                              | 🇨🇱      |
| `unresolved_final_status`                   | El banco no puede dar una respuesta definitiva sobre si este pago se completó o no.<br />Esta razón solo aparecerá para pagos pendientes que no se pudieron validar después de 10 días. | 🇨🇱      |
| `widget_closed`                             | El usuario cerró el widget antes de completar el pago.                                                                                                                                  | 🇨🇱/🇲🇽 |
| `user_left`                                 | El usuario abandonó el proceso de pago antes de seleccionar una cuenta o ingresar las credenciales de su cuenta bancaria.                                                               | 🇨🇱/🇲🇽 |
| `new_payment_intent_in_progress`            | El usuario inició un nuevo payment intent antes de completar el anterior, por lo que el payment intent original fue cancelado.                                                          | 🇲🇽      |

## Pagos con tarjeta

Los valores de `error_reason` de pagos con tarjeta usan estas descripciones:

| error\_reason              | descripción                                                                               | país      |
| -------------------------- | ----------------------------------------------------------------------------------------- | --------- |
| `authentication_failed`    | Falló la autenticación 3D Secure de la tarjeta.                                           | 🇨🇱/🇲🇽 |
| `card_declined`            | El emisor de la tarjeta rechazó la transacción.                                           | 🇨🇱/🇲🇽 |
| `insufficient_funds`       | La tarjeta no tiene fondos suficientes o excede un límite de gasto.                       | 🇨🇱/🇲🇽 |
| `invalid_card`             | La tarjeta no es compatible o no se pudieron validar sus datos.                           | 🇨🇱/🇲🇽 |
| `invalid_card_credentials` | El número de la tarjeta, la fecha de expiración o el código de seguridad son incorrectos. | 🇨🇱/🇲🇽 |

## Pantallas del widget de transferencias bancarias

A continuación puedes ver la pantalla equivalente del widget que tu usuario podría encontrar. Es importante tener en cuenta que estas pantallas sirven como ejemplo para ciertos casos y no serán estas en todos los casos, ya que intentamos dar instrucciones específicas para un amplio rango de casos dentro de cada razón de error.

# bank\_account\_locked

<Frame>
  <img width="200px" src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/024a7cb-bank_account_locked.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=80f19763e32024592f666cbbbf72c2ee" data-path="images/024a7cb-bank_account_locked.png" />
</Frame>

# bank\_connection\_error

<Frame>
  <img width="200px" src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/2bbe112-bank_connection_error.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=e56d45af6e82c92ab66544de0c0a6e31" data-path="images/2bbe112-bank_connection_error.png" />
</Frame>

# bank\_not\_available

<Frame>
  <img width="200px" src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/142b7f4-bank_not_available.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=93ffb052e3ca92bf6d91e44be7e04c85" data-path="images/142b7f4-bank_not_available.png" />
</Frame>

# amount\_limit\_reached

<Frame>
  <img width="200px" src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/2f1cdc8-amount_limit_reached.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=7298b14c7370e08b0d135ed6e06e4a72" data-path="images/2f1cdc8-amount_limit_reached.png" />
</Frame>

# insufficient\_funds

<Frame>
  <img width="200px" src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/39904ac-insufficient_funds.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=dd8ddbb0d9529c20ea35371293a7cc8b" data-path="images/39904ac-insufficient_funds.png" />
</Frame>

# login\_credentials\_locked

<Frame>
  <img width="200px" src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/1389fbb-login_credentials_locked.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=e484cd3fb160c807f524f768cc53bbda" data-path="images/1389fbb-login_credentials_locked.png" />
</Frame>

# login\_invalid\_credentials

<Frame>
  <img width="200px" src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/48972a5-login_invalid_credentials.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=f97a5ae8308c2a94ec57c6ada071be9c" data-path="images/48972a5-login_invalid_credentials.png" />
</Frame>

# maximum\_amount\_error

<Frame>
  <img width="200px" src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/7d628e3-maximum_amount_error.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=42f69a75ce62307078d739aeae17565d" data-path="images/7d628e3-maximum_amount_error.png" />
</Frame>

# mfa\_authorization\_timeout

<Frame>
  <img width="200px" src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/5ac4ed2-mfa_authorization_timeout.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=e2c2e9ba9f9a01ba0e9d68811dec963a" data-path="images/5ac4ed2-mfa_authorization_timeout.png" />
</Frame>

# mfa\_invalid\_authorization

<Frame>
  <img width="200px" src="https://mintcdn.com/fintoc-49b8bee8/SkvJJ-DZ5D4yC6tQ/images/f7c811e-mfa_invalid_authorization1.png?fit=max&auto=format&n=SkvJJ-DZ5D4yC6tQ&q=85&s=9f0c3ab3aaa2ee37ce73205109508df0" data-path="images/f7c811e-mfa_invalid_authorization1.png" />
</Frame>

<Frame>
  <img width="200px" src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/0532750-mfa_invalid_authorization2.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=1481f3064f34e31f3dc38e40b78e1a73" data-path="images/0532750-mfa_invalid_authorization2.png" />
</Frame>

# mfa\_locked

<Frame>
  <img width="200px" src="https://mintcdn.com/fintoc-49b8bee8/SkvJJ-DZ5D4yC6tQ/images/d26ce2c-mfa_locked.png?fit=max&auto=format&n=SkvJJ-DZ5D4yC6tQ&q=85&s=a43007ae14605d20890b6bba0d1ee66c" data-path="images/d26ce2c-mfa_locked.png" />
</Frame>

# mfa\_unavailable

<Frame>
  <img width="200px" src="https://mintcdn.com/fintoc-49b8bee8/SkvJJ-DZ5D4yC6tQ/images/fa8270a-mfa_unavailable.png?fit=max&auto=format&n=SkvJJ-DZ5D4yC6tQ&q=85&s=1195cd48886ddb96041986b69ac753f8" data-path="images/fa8270a-mfa_unavailable.png" />
</Frame>

# new\_contact\_amount\_limit\_reached

<Frame>
  <img width="200px" src="https://mintcdn.com/fintoc-49b8bee8/SkvJJ-DZ5D4yC6tQ/images/fb26f2f-new_contact_amount_limit_reached.png?fit=max&auto=format&n=SkvJJ-DZ5D4yC6tQ&q=85&s=246f61b1a2a13c9e46fbba90eee1a7a1" data-path="images/fb26f2f-new_contact_amount_limit_reached.png" />
</Frame>

# new\_contact\_transfer\_number\_limit\_reached

<Frame>
  <img width="200px" src="https://mintcdn.com/fintoc-49b8bee8/YQmOnq8Zegydl6oL/images/aa4eb86-new_contact_transfer_number_limit_reached.png?fit=max&auto=format&n=YQmOnq8Zegydl6oL&q=85&s=bedc1f16fe67416f1ecaa674169e1a67" data-path="images/aa4eb86-new_contact_transfer_number_limit_reached.png" />
</Frame>

# recipient\_account\_not\_allowed

<Frame>
  <img width="200px" src="https://mintcdn.com/fintoc-49b8bee8/SkvJJ-DZ5D4yC6tQ/images/c2e61ca-recipient_account_not_allowed.png?fit=max&auto=format&n=SkvJJ-DZ5D4yC6tQ&q=85&s=25a344f8f1ad24767906070bc66aaff2" data-path="images/c2e61ca-recipient_account_not_allowed.png" />
</Frame>
