“Test connection” fails with invalid access token (401) |
The Access token is wrong, from another application, or a test token in Live mode. Copy it again from Your integrations > your application > Credentials. |
| The method is not shown at checkout |
The add-on is disabled or unlicensed, the Connection is not saved, or the store lacks the currency of the account’s country (for example MXN for a Mexican account). Add the currency in Administration > Currencies. |
| “This payment method cannot charge the order currency” |
Same as above: set the country on the Connection page and add its currency to the store. |
| Mercado Pago shows “Something went wrong” after paying |
The store address is http:// or localhost. Mercado Pago only returns to and notifies https addresses on a real domain. |
collector_does_not_comply_with_current_regulation |
Your Mercado Pago account has open identity or regulatory checks. Finish them in your Mercado Pago account. |
| Orders stay “Open” |
The customer has not paid the voucher yet, or notifications do not reach the store. Check the cron job; “Check status now” on the order tab reads the payment at once. |
| Log: “x-signature does not match” |
The secret signature on the Connection page is not the one of this application, or it was reset in Your integrations. Copy it again. |
| Refund error 2063 / 4293 |
The payment is not in a refundable state (not approved yet, or already refunded). |
| Refund error 3024 “Partial refund unsupported” |
That payment method only allows a full refund: leave the amount empty. |
| Refund error 2024 / 15016 “too old” |
Mercado Pago accepts refunds within 180 days of approval; refund the customer another way. |
| Refund rejected for balance |
Your Mercado Pago account needs available balance for the refund. |
| A refund shows “unknown” |
The answer from Mercado Pago was lost. The job repeats it with the same idempotency key, so it is booked once; or click Refund again with the same amount. |
| A note “Paid amount differs …” on the order tab |
Money arrived that does not match the order (two payments, edited order, different amount). The order is not marked paid: refund the payment or adjust the order. |
