AI resources

Why is a payment rejected?

This documentation is intended for integrators. If you are a buyer and your payment was declined when using Mercado Pago, please check this article in our Help Center for guidance on how to proceed.

Payment declines are a reality in the world of online sales and can happen for various reasons. A payment may be declined due to:

  • An error with the payment method;
  • Incorrect information entered by the customer;
  • Card with insufficient funds;
  • Violation of necessary security requirements;
  • Suspicious movements indicating fraud risk;
  • Communication issues between acquirers and sub-acquirers.

You can find information and check the status of a payment via API through the endpoint Get order by IDAPI. The status field indicates whether the payment was approved or not, while the status_detail field provides more details, including reasons for decline.

curl

...
"status": "failed",
"status_detail": "insufficient_amount",
...
You can also find more information about payments in your Mercado Pago account activity.