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 transactions.payments.status field indicates whether the payment was approved or not, while the transactions.payments.status_detail field provides more details, including reasons for decline.

curl

...
"transactions": {
    "payments": [
      {
        "id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
        "amount": "24.90",
        "reference_id": "01JEVQM899NWSQC4FYWWW7KTF9",
        "status": "failed",
        "status_detail": "insufficient_amount",
...
You can also find more information about payments in your Mercado Pago account activity.