MercosulPay — gateway de pagamento Pix com API e webhook assinado
API v1 Gateway de pagamento próprio, não revenda

Receba no Pix com uma integração só.

Uma API para criar a cobrança, um webhook assinado que avisa quando o dinheiro caiu, e um painel para o financeiro conciliar e sacar. Para loja virtual, sistema, criador e balcão.

Criar conta Abrir a documentação
servidor da sua loja
POST /api/public/v1/pix/charges
{ "amount": 350.00, "reference_id": "pedido-10482" }

← 201 Created
{ "status": "pending", "qr_code": "00020126…" }
pix.receivedassinatura válida · 200 OK · 142 ms
R$ 350,00
pedido-10482Pedido liberado
01 · INTEGRAÇÃO
API REST documentada e aberta
02 · CONFIRMAÇÃO
Webhook com HMAC-SHA256
03 · AMBIENTES
Chave de teste e de produção
04 · DINHEIRO
Pix de entrada e de saída
PARA QUEM

Feito para quem vende todo dia, em qualquer canal.

A mesma conta cobra no checkout, no painel e no balcão. O que muda é por onde o cliente chega.

Lojista embalando pedidos da loja virtual
API · CHECKOUT

Loja virtual

Pix no seu checkout e pedido liberado pelo webhook, sem conferir extrato.

Criador de conteúdo gravando no estúdio
PAINEL

Criadores e infoprodutos

Gere o Pix no painel e mande no direct ou no grupo. Pagou, você vê na hora.

Dona de loja de roupas com um tablet na mão
BALCÃO

Loja física

Tablet no caixa, QR na tela e um PIN para cada operador.

Profissional trabalhando no notebook
API

Sistemas e reservas

A cobrança dentro do seu sistema de reservas, agenda ou gestão.

PRODUTO

O pedido só é liberado quando o dinheiro caiu de verdade.

Print de comprovante não paga conta. Quem confirma o pagamento é o gateway, direto no seu servidor, com uma assinatura que você confere.

Um painel para o financeiro

Cobranças, pagamentos e saques numa tela só, com filtro por status.

Visão geralCobrançasSaquesIntegração PRODUÇÃO
Recebido hojeR$ 18.420,00
Cobranças pagas126
Disponível para saqueR$ 41.906,50
pedido-10482Pix · 14:32R$ 350,00Pago
pedido-10481Painel · 14:28R$ 129,90Pago
caixa1-0937Balcão · 14:21R$ 64,00Pendente
Valores ilustrativos.

O valor que você pede é o que chega

A taxa do envio é somada antes, e não descontada de quem recebe.

Valor solicitadoR$ 1.000,00
Taxa do enviosomada antes
Valor que chegaR$ 1.000,00
Simulação.

Saque quando você pedir

Pelo painel ou pela API, sem esperar a janela de repasse de ninguém.

SacarPix · Enviado

Aviso que falha é reenviado

pix.received200 · 142 ms
pix.receivedsem resposta · nova tentativa
pix.received200 · 121 ms
pix.sent200 · 98 ms

Se o seu servidor não responder, o gateway tenta de novo. Cada entrega tem um id próprio para você ignorar repetidos.

Teste sem mover dinheiro

Produção — movimenta dinheiro de verdade
Teste

Chaves separadas por ambiente. Integre e simule antes de virar a chave.

Uma integração, vários canais

CheckoutPainelBalcãoSaque

Tudo cai no mesmo saldo e no mesmo extrato, venda online ou no caixa.

TRÊS FORMAS DE COBRAR

Com código, sem código ou no balcão.

Pix dentro do seu checkout.

Seu servidor cria a cobrança, o checkout mostra o QR, e o webhook confirma. O cliente nunca sai da sua página.

  • REST com JSON, documentação aberta
  • QR Code já pronto para a tela, em imagem e copia e cola
  • Chaves separadas de teste e de produção
Notebook aberto na tela de checkout de uma loja virtual
sualoja.com.br/checkout
Total do pedidoR$ 350,00Escaneie com o app do seu banco
DESENVOLVEDORES

Quatro passos entre o carrinho e o pedido pago.

Endpoints, campos e webhooks estão na documentação pública. Dá para conferir tudo antes de ter conta.

  1. 01
    Crie a cobrança

    Uma chamada do seu servidor para POST /pix/charges, com o seu reference_id.

  2. 02
    Mostre o QR

    A cobrança nasce pending, com o copia e cola e a imagem do QR prontos para a tela.

  3. 03
    Receba o webhook

    Quando o Pix compensa, o gateway chama a sua URL com pix.received.

  4. 04
    Confira a assinatura e libere

    HMAC-SHA256 sobre o horário e o corpo. Bateu, o pedido está pago.

Ler a documentação completa →
Desenvolvedor programando num notebook
webhook.jscobranca.js
// conferir o webhook antes de liberar o pedido
const ts = req.get('x-mercosulpay-timestamp');
const esperado = 'sha256=' + crypto
  .createHmac('sha256', process.env.MP_WEBHOOK_SECRET)
  .update(`${ts}.${corpoBruto}`)
  .digest('hex');

if (!iguais(esperado, req.get('x-mercosulpay-signature')))
  return res.sendStatus(401);

res.sendStatus(200);   // responde rápido, processa depois
await liberarPedido(JSON.parse(corpoBruto));
Equipe de atendimento trabalhando com fones de ouvido
Atendimento em portuguêspelo WhatsApp, com quem opera o gateway
GATEWAY PRÓPRIO, NÃO REVENDA

Quando algo trava, quem resolve está aqui dentro.

Revenda repassa o seu chamado para outra empresa e espera. Aqui a infraestrutura é nossa: quem atende é quem tem acesso ao sistema.

Análise antes de ativar

O seu ramo entra na análise no começo, e não vira surpresa depois da primeira semana boa.

Sem janela de repasse

O saque sai quando você pede, pelo painel, pelo balcão ou pela API.

Tudo documentado

O que o gateway faz está escrito na documentação pública, e não só na promessa comercial.

SEGURANÇA

Segurança que o seu time técnico consegue testar.

Nada de selo genérico. Estas são as regras do gateway.

Webhook assinado

Cada aviso traz assinatura HMAC-SHA256 com horário. Aviso forjado ou velho não passa na conferência.

Teste separado da produção

Uma chave para cada ambiente. Chave de teste nunca vira cobrança de verdade.

Chave só no servidor

A API não aceita chamada direto do navegador. Sua chave não fica exposta no site.

Acesso por perfil

Operador de caixa entra com PIN e vê só as vendas do dia. Saldo e saque ficam com quem administra a conta.

PREÇOS

Você sabe a taxa antes de ativar.

A taxa é por transação, definida na análise da sua operação e informada antes da conta entrar em produção.

Pedir uma proposta →
PIX RECEBIDO
Taxa por transação
SAQUE
Taxa do envio somada antes
QUANDO
Informada antes de ativar
DÚVIDAS

Perguntas frequentes

Não achou a sua? contato@mercosulpay.com

Aceita cartão ou boleto?

Ainda não. Hoje a cobrança é em Pix.

Preciso de programador para usar?

Para a API, sim: ela é chamada do seu servidor. Sem programador, crie a cobrança pelo painel ou use o balcão.

Dá para testar antes de cobrar de verdade?

Sim. Com a chave de teste você integra e simula antes de usar a chave de produção.

O webhook pode chegar duas vezes?

Pode, e isso é de propósito: se a sua resposta demora, o gateway tenta de novo. Guarde o x-mercosulpay-delivery e ignore repetidos.

O que é a análise antes de ativar?

Antes da conta ir para produção, olhamos o que você vende e como vende. O risco do seu ramo entra na conta no começo, e não depois da primeira semana boa.

COMECE HOJE

Faça a primeira cobrança no ambiente de testes.

Crie a conta, pegue a chave de teste e integre antes de falar com qualquer pessoa.

Criar conta Falar com vendas WhatsApp do Paraguai · atendimento em português
Bruno, atendente da MercosulPay Tirar dúvidas