> ## 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.

# Payment intent error reason

Payment Intents can fail for a variety of reasons. The reason a given payment intent failed is available in a [Payment Intent Object](/api/payments-api/payment-intents/payment-intents-object)'s `error_reason` attribute.

Below is a list of all the types of `error_reason` Fintoc currently sends. Fintoc may add more at any time, so when developing and maintaining your code, don't assume that only these types exist.

## Bank transfers

Bank transfer `error_reason` values use these descriptions:

| Error reason                                | Description                                                                                                                                                                                    | Country   |
| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| `bank_account_locked`                       | The bank blocked the transfers service for this account.                                                                                                                                       | 🇨🇱      |
| `bank_connection_error`                     | Fintoc had a problem connecting with the selected bank.                                                                                                                                        | 🇨🇱      |
| `bank_not_available`                        | The selected bank is temporarily unavailable.                                                                                                                                                  | 🇨🇱      |
| `amount_limit_reached`                      | The maximum amount available to transfer was reached.                                                                                                                                          | 🇨🇱      |
| `insufficient_funds`                        | The account doesn’t have enough money to execute the payment.                                                                                                                                  | 🇨🇱      |
| `login_credentials_locked`                  | The bank indicated that the user's credentials are locked.                                                                                                                                     | 🇨🇱      |
| `login_invalid_credentials`                 | The bank indicated that the user's credentials are invalid.                                                                                                                                    | 🇨🇱      |
| `maximum_amount_error`                      | The amount exceeds the maximum amount allowed for that bank.                                                                                                                                   | 🇨🇱      |
| `mfa_authorization_timeout`                 | The user did not authorize the transfer with their multifactor method.                                                                                                                         | 🇨🇱      |
| `mfa_invalid_authorization`                 | The bank indicated that the multifactor authorization was invalid.                                                                                                                             | 🇨🇱      |
| `mfa_locked`                                | The multifactor authentication method is locked.                                                                                                                                               | 🇨🇱      |
| `mfa_unavailable`                           | The multifactor authentication method is unavailable.                                                                                                                                          | 🇨🇱      |
| `new_contact_amount_limit_reached`          | The amount exceeds the maximum amount permitted for new contacts.                                                                                                                              | 🇨🇱      |
| `new_contact_transfer_number_limit_reached` | The maximum number of transfers for new contacts was reached.                                                                                                                                  | 🇨🇱      |
| `recipient_account_not_allowed`             | The bank indicated that the recipient account is not allowed to receive transfers.                                                                                                             | 🇨🇱      |
| `unresolved_final_status`                   | The bank can’t provide a definite answer on whether this payment was completed or not.<br /><br />This reason will only appear for pending payments that could not be validated after 10 days. | 🇨🇱      |
| `widget_closed`                             | The user closed the widget before completing the payment.                                                                                                                                      | 🇨🇱/🇲🇽 |
| `user_left`                                 | The user abandoned the payment process before selecting an account or entering their bank account's credentials.                                                                               | 🇨🇱/🇲🇽 |
| `new_payment_intent_in_progress`            | The user started a new payment intent before completing the previous one, so the original payment intent was cancelled.                                                                        | 🇲🇽      |

## Card payments

Card payment `error_reason` values use these descriptions:

| Error reason               | Description                                                      | Country   |
| -------------------------- | ---------------------------------------------------------------- | --------- |
| `authentication_failed`    | 3D Secure card authentication failed.                            | 🇨🇱/🇲🇽 |
| `card_declined`            | The card issuer declined the transaction.                        | 🇨🇱/🇲🇽 |
| `insufficient_funds`       | The card has insufficient funds or exceeds a spending limit.     | 🇨🇱/🇲🇽 |
| `invalid_card`             | The card is not supported or its data could not be validated.    | 🇨🇱/🇲🇽 |
| `invalid_card_credentials` | The card number, expiration date, or security code is incorrect. | 🇨🇱/🇲🇽 |

## Bank transfer widget screens

The following widget screens are examples for specific cases. Fintoc shows a different screen depending on the error reason, so the actual screen your customer sees might differ from these examples.

### `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>
