# Connect your Mercado Pago account

> Take cards, Pix, boleto, OXXO and cash payments in Latin America with your own Mercado Pago account. In Settings > Payments, click Set up Mercado Pago, paste your Access Token and Public Key, switch it on and click Save settings.

Help Centre / Payments - Updated 19 November 2026

Mercado Pago is the most used way to pay online in Argentina, Brazil, Chile, Colombia, Mexico, Peru and Uruguay. When you connect your Mercado Pago account, your customers can pay by card, with Pix, with a boleto, at an OXXO store, or with the other cash payment methods Mercado Pago offers in your country. Payments go straight to your Mercado Pago account, and Shoprocket takes 0%.

Your customers pay inside your checkout. They choose how to pay and type their card details into Mercado Pago's own payment form, which appears in the checkout like any other part of the page. Card details go straight to Mercado Pago and never pass through Shoprocket.

## Before you start

You need a Mercado Pago account in one of the seven countries above. Your Access Token and Public Key come from an application in your Mercado Pago account:

1. Sign in at Mercado Pago's developer site and open **Your integrations**.
2. Create an application, or open the one you already have.
3. Open **Production credentials**. Your **Public Key** and **Access Token** are both there.

To receive Pix payments in Brazil, register a Pix key in your Mercado Pago account first. Without one, Pix doesn't appear at your checkout.

## Connect Mercado Pago

1. In your dashboard, go to **Settings > Payments**.
2. On the Mercado Pago card in **Payment gateways**, click **Set up Mercado Pago**.
3. Paste your **Access Token** and your **Public Key** into the fields with the same names.
4. Turn Mercado Pago's switch to **On**.
5. Click **Save settings**.

![The Mercado Pago card in Settings > Payments: Connected, with test credentials, saying the account takes payments in BRL only](https://shoprocket.io/img/help/connect-mercado-pago/mercado-pago-card.webp)

When you save, Shoprocket checks your credentials with Mercado Pago. If Mercado Pago rejects them, nothing is saved and a message at the top of the screen says why. The most common mistake is pasting the Public Key into the Access Token field. The Access Token is the longer of the two.

The card then says **Connected**, and Mercado Pago appears at your checkout.

## The currency your account takes

Each Mercado Pago account takes payments in the currency of its own country only. A Brazilian account takes Brazilian reais, a Mexican account takes Mexican pesos, and so on. When you save your credentials, Shoprocket reads which country your account is in, and the card shows the currency it takes.

If your shop is priced in a different currency, the card warns you. Mercado Pago can't be your main card gateway then, but you can still offer it to customers paying in its currency. To do that, add the currency under **Card gateway by currency**, as [Choose a payment gateway](https://shoprocket.io/help/choose-a-payment-gateway.md) explains.

## Try it with test credentials

Mercado Pago gives every application a set of test credentials as well. They start with `TEST-`. Paste the test Access Token and test Public Key to try your checkout without moving real money. The card then shows **Test credentials: no real money moves**. Mercado Pago's developer site lists the test card numbers to use.

When you are ready to sell, click **Edit Mercado Pago credentials**, paste your production Access Token and Public Key, and click **Save settings**.

## How customers pay

- **By card**: the customer types their card into Mercado Pago's form in your checkout, and can choose to pay in installments where their card allows it. If their bank needs to check the payment, that check opens in the checkout too.
- **With Pix**: after the customer clicks **Pay now**, the checkout shows a Pix QR code and a code to copy. The customer pays from their banking app, and the order is confirmed as soon as the payment arrives.
- **With a boleto, at OXXO or another cash payment point**: the checkout shows the payment slip or reference to pay. The order waits as **Processing** until the customer pays it, and the items stay reserved until the slip expires.

You don't need to do anything for any of these. Shoprocket marks the order paid when Mercado Pago confirms the payment, and sends your usual order emails.

## Refunds

When you refund an order paid with Mercado Pago, the money goes back to the customer automatically, in full or in part. See [Refund an order](https://shoprocket.io/help/refund-an-order.md). A refund you make in your Mercado Pago account also appears on the order in Shoprocket.

## Subscriptions

Mercado Pago can't renew subscriptions on Shoprocket yet. If you sell subscriptions, keep another card gateway that renews them, such as Stripe or Square, for those products.

## Changing your credentials or turning it off

Once Mercado Pago is connected, its button reads **Edit Mercado Pago credentials**. Your saved credentials are stored encrypted and never shown again. To keep them, leave the fields blank. To replace them, fill in both fields and click **Save settings**.

To stop offering Mercado Pago, turn its switch to **Off** and click **Save settings**. Your credentials stay saved, so you can switch it back on at any time.

## Related

- [Choose a payment gateway](https://shoprocket.io/help/choose-a-payment-gateway.md)
- [Connect Mollie, Authorize.net, Razorpay, eWAY or NOWPayments](https://shoprocket.io/help/connect-with-api-keys.md)
- [Refund an order](https://shoprocket.io/help/refund-an-order.md)
- [Take a test order](https://shoprocket.io/help/take-a-test-order.md)

[Open Payments in your dashboard](https://app.shoprocket.io/go/settings/payments)

---

- HTML version: https://shoprocket.io/help/connect-mercado-pago
- Language: English (en)
- Also in: [العربية](https://shoprocket.io/ar/help/connect-mercado-pago.md), [Deutsch](https://shoprocket.io/de/hilfe/mercado-pago-konto-verbinden.md), [Ελληνικά](https://shoprocket.io/el/help/connect-mercado-pago.md), [Español](https://shoprocket.io/es/ayuda/conectar-mercado-pago.md), [Français](https://shoprocket.io/fr/aide/connecter-mercado-pago.md), [עברית](https://shoprocket.io/he/help/connect-mercado-pago.md), [हिन्दी](https://shoprocket.io/hi/help/connect-mercado-pago.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/hubungkan-akun-mercado-pago.md), [Italiano](https://shoprocket.io/it/aiuto/collega-mercado-pago.md), [日本語](https://shoprocket.io/ja/help/connect-mercado-pago.md), [Lietuvių](https://shoprocket.io/lt/pagalba/prijunkite-mercado-pago-paskyra.md), [Norsk](https://shoprocket.io/nb/hjelp/koble-til-mercado-pago-kontoen-din.md), [Nederlands](https://shoprocket.io/nl/hulp/mercado-pago-account-koppelen.md), [Polski](https://shoprocket.io/pl/pomoc/polacz-konto-mercado-pago.md), [Português](https://shoprocket.io/pt/ajuda/conectar-mercado-pago.md), [Română](https://shoprocket.io/ro/ajutor/conecteaza-contul-mercado-pago.md), [Русский](https://shoprocket.io/ru/help/connect-mercado-pago.md), [ไทย](https://shoprocket.io/th/help/connect-mercado-pago.md), [Türkçe](https://shoprocket.io/tr/yardim/mercado-pago-hesabi-baglama.md), [中文](https://shoprocket.io/zh/help/connect-mercado-pago.md)
