Connect a Payment Portal with Mercado Pago

Summary Accept online payments on your captive portal — Pix, credit/debit card, and boleto — using your own Mercado Pago account. Guests pay you directly; MKController orchestrates the checkout and releases internet access once Mercado Pago confirms the payment. You need your two production credentials: the Public Key and the Access Token (both start with APP_USR-).

When you connect Mercado Pago, MKController asks for two production credentials:

Field in MKController	What it is	Format
Publishable key	Public Key of your application	APP_USR-…
Access token	Private token that creates charges	APP_USR-…

Use your Production credentials (both begin with APP_USR-). Test credentials (TEST-…) will not take real payments.

1. Sign in at mercadopago.com.br (use your country’s Mercado Pago / Mercado Livre site).
2. Open the Developers panel: mercadopago.com.br/developers → Your integrations (Suas integrações).
3. Create an application (or open an existing one) — it represents your MKController integration.
4. Inside the application, open Production credentials (Credenciais de produção). If they are locked, complete the short activation Mercado Pago requests (industry, site, etc.) to unlock production.
5. Copy the two values — Public Key (APP_USR-…) and Access Token (APP_USR-…).

Pix: to receive by Pix, your account needs at least one Pix key registered (Mercado Pago app → your profile / Pix). Card and boleto do not require it.

1. Open Integrations → Payments.
2. Select the Payment gateways tab.
3. Find Mercado Pago and click Configure.
4. Paste your credentials — Publishable key (Public Key, APP_USR-…) and Access token (APP_USR-…).
5. Click Validate and connect.

MKController validates the credentials and loads the methods your account supports (Pix, credit card, debit card, boleto), shown as chips on the Mercado Pago card. It tells Mercado Pago where to send payment confirmations automatically — no webhook setup on your side.

1. Under Integrations → Payments, open the Payment methods tab.
2. Turn on the methods to accept — Pix, Credit card, Debit card (and Boleto if you use it).
3. If a method can be processed by more than one connected gateway, use the Processed by dropdown to select Mercado Pago.

1. Open the voucher → Integrations tab.
2. Under Online payment, switch on the methods this voucher should offer (e.g. Pix, Credit card).
3. Save.

On the captive portal for that voucher:

• Pix shows a copy‑and‑paste code the guest pays in their bank app.
• Card hands the guest off to Mercado Pago’s secure checkout, then returns them to the portal.

Once Mercado Pago confirms the payment, the guest’s access is upgraded to the plan they bought.

• Make a real, low‑value purchase from a device on the hotspot to confirm the full flow.
• Track payments in the voucher’s Real time screen — gateway and paid/pending status show per session.
• Review every transaction in your Mercado Pago → Activities / Sales.

MKController field	Where to get it in Mercado Pago
Publishable key (APP_USR-…)	Developers → Your integrations → [your app] → Production credentials → Public Key
Access token (APP_USR-…)	Developers → Your integrations → [your app] → Production credentials → Access Token

• Only TEST-… credentials appear. Switch to Production credentials and complete the activation Mercado Pago requests.
• Card payment fails to create. Card checkout is priced in Brazilian Reais — make sure the voucher plan’s price is set in BRL.
• Pix code isn’t generated. Confirm the account has an active Pix key registered in Mercado Pago.
• Payment stays “pending” after the guest paid. Confirmations arrive automatically; if a specific payment stays pending, re‑send the notification from Mercado Pago (Your integrations → your app → Webhooks / Notifications → resend).
• Rotate a token? Reset the Access Token in Mercado Pago, then click Reconnect on the Mercado Pago card and paste the new value.

---

Explore next: Configure Payment Gateways · Receive Pix Payments · How Guests Connect & Pay

Need a hand? Talk to our team on WhatsApp or start your free MKController account.