Payments
Failure causes
Whenever a payment fails internally, the failure cause is added to the
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 :
payment object returned by the HUB2 API.
Important
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 HUB2 API reference documentation.
| 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. |