Store Setup

Connect Mercado Pago (Pix, Boleto, Cards)

Updated on 11/3/2026

Mercado Pago accepts Pix, boleto and cards on your store's own checkout page in Brazil. You connect it with your account credentials — there's no login or OAuth authorization step.

What it's for

Connecting Mercado Pago lets your store charge Pix, boleto and credit cards, Brazil's most common payment methods, right inside your checkout, without sending the customer to another site. The money lands in your Mercado Pago account, and Horsee confirms the order automatically once the payment is approved.

Step by step

  1. In your Mercado Pago dashboard, open Your integrations → Credentials and use the Production credentials.
  2. Copy the Access Token (it starts with APP_USR-) and the Public Key.
  3. In Horsee, open Settings → Apps → Payments → Mercado Pago → Configure. The window is called Connect Mercado Pago.
  4. Under Credentials (BYO), paste the Access Token and the Public Key.
  5. Turn off Test mode if you're selling for real. It's on by default for a new connection.
  6. Copy the Webhook URL shown in the window and paste it into Mercado Pago under Your integrations → Webhooks.
  7. Mercado Pago generates a secret signature. Copy it and paste it into the Webhook Secret field in Horsee.
  8. Click Save, then Test Connection. The status changes to Account connected.
  9. In Settings → Payment Methods, choose Mercado Pago as the gateway for Pix, boleto and/or card.

Mercado Pago checkout options

Once Mercado Pago is selected in Payment Methods, extra fields appear: installments (maximum number of installments, interest-free up to, and minimum installment), Pix expiration in minutes, boleto expiration in days, and the name shown on the customer's card statement, up to 22 characters.

Test mode

To test without charging anyone, use test credentials (an Access Token and Public Key starting with TEST-) from a Mercado Pago test user and leave Test mode on. Swap in your production credentials and turn Test mode off before you sell.

Common mistakes

  • "Test mode active" on a live store: payments aren't actually charged. Turn off Test mode and save.
  • Paid order still pending: the webhook wasn't registered or the Webhook Secret is wrong. Repeat steps 6 and 7.
  • Store in another currency: Mercado Pago only works in BRL (Brazilian real). To sell in another currency, use an international gateway such as Stripe or PayPal.
  • Mercado Pago missing at checkout: make sure it's selected for the method in Payment Methods.
Tip: The Access Token is stored encrypted and never shown again after you save it. The Public Key is public by design (checkout uses it in the browser).

Was this article helpful?

Your feedback helps us improve our guides