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

# Failure causes

Whenever a payment fails internally, the failure cause is added to the `payment` object returned by the HUB2 API.

<Card title="Important" icon="lightbulb" iconType="duotone" color="#ca8b04">
  **These are "application errors" and not related to the HTTP protocol.**

  The HTTP status codes returned by each HUB2 API endpoint are given in the <u>[HUB2 API reference documentation](/api-reference)</u>.
</Card>

The failure causes shown on this page only concern errors encountered during the processing of a transaction.

List of different failure causes with their associated code and descriptions :

| Code                          | Description                                                                         |
| :---------------------------- | :---------------------------------------------------------------------------------- |
| `internal_error`              | Payment failed. Internal error. Our technical team has been notified.               |
| `service_unavailable`         | Payment failed. Provider is currently unavailable.                                  |
| `unknown_reason`              | Payment failed. No reason was provided by the provider.                             |
| `unknown_reason_orange`       | Payment failed. No reason was given by Orange.                                      |
| `customer_account_locked`     | Payment failed. The customer account is locked by provider.                         |
| `customer_insufficient_funds` | Payment failed. The customer doesn't have enough funds.                             |
| `authentication_failed`       | Payment failed. The customer failed to authenticate the payment.                    |
| `authentication_timeout`      | Payment failed. The customer did not authenticate the payment in time.              |
| `timeout`                     | Payment failed. The waiting period for payment execution has expired.               |
| `bad_parameters`              | Payment failed. Bad parameters.                                                     |
| `forbidden_by_provider`       | Payment failed. The payment was forbidden by the provider.                          |
| `too_many_request`            | Payment failed. Provider is overloaded. Please try again later.                     |
| `duplicate_request`           | Payment failed. A similar operation has just been recorded. Please try again later. |
| `canceled_by_customer`        | Payment failed. Canceled by the customer.                                           |
| `canceled`                    | Payment failed. Canceled by the provider.                                           |
| `fraud_suspicion`             | Payment failed. Fraud suspicion detected by the provider.                           |
| `unsupported_currency`        | Payment failed. This currency is not supported.                                     |
| `payer_quota_exceeded`        | Payment failed. Customer quota exceeded.                                            |
| `invalid_payment_processor`   | Payment failed. The selected provider does not allow to perform this operation.     |
| `invalid_msisdn`              | Payment failed. Incorrect phone number (MSISDN).                                    |
| `wave_payment_expired`        | Payment expired. Do not use the corresponding Wave's payment link anymore.          |
| `blacklisted_msisdn`          | The MSISDN is temporarily banned.                                                   |
| `card_expired`                | Payment failed. The card's expiry date has passed.                                  |
| `card_declined`               | Payment failed. The card has been declined.                                         |
| `card_stolen`                 | Payment failed. The card is reported as stolen.                                     |
| `card_refused`                | Payment failed. The card has been declined.                                         |
| `card_invalid`                | Payment failed. Invalid Credit Card.                                                |
| `card_cvn_invalid`            | Payment failed. The card security key is invalid.                                   |
| `address_verification_failed` | Payment failed. Address does not match credit card.                                 |
| `card_limit_reached`          | Payment failed. The card limit has been reached.                                    |