Set up Mercado Pago, Pagar.me, PagBank, or Wompi

Open **Payments → Payment Gateways → Add Gateway**, select the provider, and choose **Continue**. Enter **Name**, select **Processing Currency**, and complete that provider's required fields below. Use credentials from the same live merchant account and keep secret values private. After reviewing optional settings and **Limits**, choose **Save Gateway**.

Leave provider sandbox or try-environment switches off. Leave optional custom endpoint and SDK URL fields blank to use the built-in integration. The currency and methods must also be enabled by the provider on your merchant account. Common optional fees, **Custom Exchange Rate (1 USD)**, **Mask Description** where present, and **Disable** are described in the gateway setup guides.

Mercado Pago

**Required provider fields:** **Country**, **Access Token**.

**Optional provider fields:** **Webhook Secret**.

Use **Country** and its local currency together: AR/ARS, BR/BRL, CL/CLP, CO/COP, MX/MXN, PE/PEN, or UY/UYU. Enter the live application **Access Token** for that account. **Webhook Secret** enables signature validation for Mercado Pago webhook notifications. Changing a country does not transfer your provider account to a new market.

Pagar.me

**Required provider fields:** **Secret Key**.

**Optional provider fields:** **Payment Methods**, **Link Expiry Minutes**, **Pix Expiry Seconds**, **Boleto Due Days**, **Max Card Installments**, **Statement Descriptor**, **Default Customer Email**.

This is Pagar.me Checkout V5 for Brazil in BRL. **Payment Methods** offers credit_card, pix, and boleto; leaving it empty enables those options. Optional settings control payment-link expiry, Pix expiry, boleto due days, card installments, and the statement descriptor. **Max Card Installments** is 1–12. **Statement Descriptor** has a 13-character provider limit. Configure the provider callback using the merchant-specific URL shown in the gateway description.

PagBank / PagSeguro

**Required provider fields:** **Access Token**.

**Optional provider fields:** **Payment Methods**, **Checkout Expiry Minutes**, **Max Card Installments**, **Interest Free Installments**, **Soft Descriptor**.

This is PagBank Checkout for Brazil in BRL. **Payment Methods** offers CREDIT_CARD, DEBIT_CARD, PIX, and BOLETO; an empty selection enables those options. Optional **Max Card Installments** is 1–12. **Interest Free Installments** specifies installments whose interest the seller pays. **Soft Descriptor** has a 17-character provider limit. PayerOne sends payment notification URLs when creating the hosted checkout.

Wompi

**Required provider fields:** **Country**, **Public Key**, **Integrity Secret**, **Event Secret**.

Match **Country** and **Processing Currency**: CO uses COP and PA uses USD. Use **Public Key**, **Integrity Secret**, and **Event Secret** for that same country and live account. The integrity secret signs checkout requests and the event secret validates payment events; do not swap them. Register the Events URL shown in gateway setup in the Wompi dashboard.

Check a new connection

Use a fresh checkout to confirm the expected provider name, processing currency, and total. If saving fails, recheck the required fields, live-account credentials, and currency selection. If the provider records a payment but the order does not update, keep the provider reference and order reference and ask support to review them before asking the customer to pay again. Never include secret values in that request.