Get paid with MercadoPago from WHMCS
MercadoPago Checkout Pro for WHMCS
- Version 1.0.0
- WHMCS 8.13 – 9.0
- PHP 8.1 – 8.3
- Updated Nov 22, 2026
Your clients pay their invoices in MercadoPago Checkout Pro, and WHMCS marks them as paid only when the signed notice arrives. A panel inside WHMCS shows payments, notices, reconciliation and refunds.
- Payments verified by signature
- Refunds without duplicates
- Reconciliation on demand
Payment gateway and admin panel for WHMCS 8.x and 9.x · In English and Spanish
What it solves
So you can stop checking by hand whether a MercadoPago payment has reached the invoice.
- A payment counts only if it is authentic
- MercadoPago signs every notice, and the module checks the signature before it touches the invoice. Coming back from checkout on an "approved payment" URL does not mark anything as paid.
- Refunds are never duplicated
- A double click or a retry after an outage does not send two refunds: before sending, the module checks what MercadoPago already has on record. If something does not add up, it stops and tells you why.
- What you do in MercadoPago reaches WHMCS
- Refunds made from the MercadoPago dashboard, partial ones included, are recorded on the invoice automatically. Chargebacks and cancellations are logged without deleting the original payment.
- You know which payment did not arrive
- Reconciliation compares the payments approved in MercadoPago with what is recorded in WHMCS and flags the ones that are missing, so you can fix them before the client complains.
What MercadoPago looks like inside
Real screens from the module, captured with demo data. The admin panel is also available in English.
Everything it includes
Payments
- Checkout Pro: the client pays in the MercadoPago environment with the methods enabled on your account (cards, cash at stores, bank transfer)
- You can exclude payment methods and limit installments, from 1 to 24
- If a payment comes in incomplete, the invoice is not marked as paid
- A repeated notice from MercadoPago does not record the payment twice
- The MercadoPago fee is recorded on each payment, so you can see the net amount in your reports
- If the invoice currency is not supported, it reports the error instead of charging the wrong amount
- Test mode with MercadoPago test credentials
Panel inside WHMCS
- Collected today and this month, fees, recent payments and connection status
- Payment explorer with filters by status, method, dates and invoice
- A log of every notice received: its result, the invoice and whether the signature was valid
- Reconciliation for the last 24 hours, 7 days or 30 days
- Refunds and chargebacks, each linked to its original payment
- The payer's email is partially masked
- The notice log cleans itself: it keeps 90 days (adjustable)
Panel sections inside WHMCS
- Dashboard
- Payments
- Notices
- Reconciliation
- Refunds
- Info
Getting started
-
Connect your account
Enable the gateway in WHMCS and paste your MercadoPago Access Token and webhook secret key. You can start in test mode.
-
Your client pays
From the invoice they go to Checkout Pro and pay with the method they prefer. MercadoPago then notifies your WHMCS with a signed message.
-
WHMCS applies the payment
The invoice is marked as paid, the fee is recorded and everything is visible in the panel.
Delivered installed and configured
MercadoPago is delivered as a custom integration: we install it, connect it to your account and test it with you. Write to us for a quote.
- Gateway with signature-verified payments
- Panel for payments, notices, reconciliation and refunds
- Help with the go-live
MercadoPago changelog
Current version: 1.0.0. Last updated: Nov 22, 2026.
-
v1.0.0
- Fixed: duplicate notices, payments in the wrong currency and underpayments are now recorded in the panel's notice log.
- Improved: underpayments now show up as something that needs your attention.
- Improved: the panel is written in plain Spanish, with payment statuses and methods translated.
-
v1.0.0
- New: refunds made from the MercadoPago panel, full or partial, are now recorded on the invoice automatically.
- Fixed: a refund issued from WHMCS can no longer go out twice because of a double click or a retry after a connection drop.
- Improved: before refunding, the module checks MercadoPago's own list of refunds, and when in doubt it stops the refund rather than risk paying twice.
- Fixed: if a refund cannot be recorded in time, MercadoPago notifies again until it is saved.
-
v1.0.0
- Fixed: when two notices for the same payment arrived at once, the invoice could be credited twice; they are now handled one at a time.
- Fixed: the errors-in-the-last-24-hours card no longer stays lit because of unsigned notices that are rejected on purpose.
- Fixed: refunds made in WHMCS are now counted correctly in the indicators and in the refunds tab.
- Improved: the panel's headers, tabs and names are in Spanish.
See the full history (8 more entries)
-
v1.0.0
- Fixed: MercadoPago payment notices were being rejected because of an error reading their send time, so some paid invoices stayed as unpaid.
- These notices are now accepted and the invoice is marked as paid automatically.
-
v1.0.0
- Improved: the payment description on MercadoPago is now in Spanish and carries the invoice number your customer sees, for example "Payment of invoice #1234567".
- The same description appears at checkout, on the receipt and in the customer's history.
-
v1.0.0
- Improved: the admin panel received accessibility fixes, with headings in the right order and better screen reader support.
- Improved: the invoice page your customer sees reaches the top accessibility score.
- Improved: the module's interactive elements use the brand colors consistently.
-
v1.0.0
- Fixed: a refund made from the admin area was counted twice when calculating how much was left to return.
- Fixed: the underpayment protection now adds up what was paid through every gateway and subtracts account credit.
- Fixed: the panel's indicators come from real WHMCS transactions, use Mexico time and respect the currency filter.
-
v1.0.0
- New: MercadoPago admin panel with an overview, a live payment explorer, a notice log, reconciliation against WHMCS and a refunds list.
- New: an information tab with documentation, requirements and license.
- New: the panel is available in Spanish and English.
- Fixed: the panel showed "Disconnected" with a 403 error even when the connection was fine.
-
v1.0.0
- New: the pay button carries the MercadoPago brand and reads "Pagar con MercadoPago".
- Improved: when a card is declined, the customer sees a clear message in Spanish instead of an internal code.
- Improved: the MercadoPago fee is recorded with the right amount and matches your account statement.
- Security hardening: a fake "payment received" screen can no longer be shown by tampering with the address, and the notice signature is no longer stored in full in the logs.
-
v1.0.0
- New: a widget on the WHMCS dashboard shows connection status, today's approved payments, this month's total and the last payment.
- Fixed: charges respect the invoice currency instead of defaulting to pesos.
- Fixed: if a notice fails to process, MercadoPago retries it instead of treating it as received.
- Fixed: a case where the invoice number was lost when coming back from payment.
-
v1.0.0
- First release: payments through MercadoPago Checkout Pro, with a secure redirect and automatic invoice confirmation.
- Includes signed payment notices, refunds from the admin area, a test mode and support for pesos and dollars.
Frequently asked questions
Which payment methods will my clients see?
The ones enabled on your MercadoPago account: the module uses Checkout Pro and does not decide the methods. In the settings you can exclude some and limit installments.
What if the client pays but does not come back to my site?
Nothing is lost. The payment is applied from the notice MercadoPago sends to your server, not from the browser returning. If your server does not respond, MercadoPago retries.
Can I refund from WHMCS?
Yes, in full or in part, from the invoice. The module prevents the same refund from being sent twice and also records the ones you make directly in MercadoPago.
Which currencies does it charge in?
It recognizes MXN, ARS, BRL, CLP, COP, PEN, UYU and USD; which ones you can use depends on the country of your MercadoPago account. With a Mexican account it charges in pesos.
Another question? Write to us and we will reply in English or Spanish.
Works better together with
Payment Gateway Charges
Pass the MercadoPago fee on to the client and show it to them before they pay.
Manual payments with proof of payment
Add SPEI (Mexican bank transfers), deposits and OXXO (cash payments at convenience stores) with proof of payment, for clients who do not pay by card.
Telegram Notifications
Get every payment in Telegram as soon as it is confirmed.
Get paid with MercadoPago without chasing payments
Payments that apply themselves, refunds without duplicates, and a panel that shows what is left to reconcile.