Gateways de pagamento
Conecte o seu próprio gateway para receber Pix, boleto e cartão direto na sua conta.
A MinePag não processa pagamentos em nome da loja. Você conecta a conta que já tem em um gateway, e as vendas são cobradas por ele, com as tarifas e os prazos de repasse do seu contrato.
O dinheiro é seu desde o primeiro minuto
O valor de cada venda cai direto na conta do gateway conectado. A MinePag não recebe, não retém e não repassa o dinheiro das vendas. O que você paga à MinePag é a cobrança por uso, numa fatura separada.
Gateways compatíveis
| Gateway | Pix | Boleto | Cartão | Reembolso pela MinePag | Importação de histórico | Webhook |
|---|---|---|---|---|---|---|
| Efí | Sim | Com a API de Cobranças | Com a API de Cobranças e o identificador de conta | Pix e cartão, total ou parcial | Sim | Registrado automaticamente |
| Mercado Pago | Sim | Sim | Sim | Pix, boleto e cartão, total ou parcial | Sim | Automático com login pelo Mercado Pago; manual com credenciais |
| PagBank | Sim | Sim | Sim | Pix e cartão, total ou parcial | Só com o Extrato EDI | Enviado em cada pedido, sem configuração |
| Stripe | Sim | Sim | Sim | Pix e cartão, total ou parcial | Sim | Registrado automaticamente |
Cada loja tem os próprios gateways conectados. Você pode conectar mais de um e escolher qual atende cada forma de pagamento nas rotas de pagamento.
Onde fica no painel
Abra a loja e vá em Configurações › Gateways. A página tem três seções:
- Checkout: o que os clientes conseguem pagar e as rotas de pagamento de Produção e do Sandbox.
- Conectados: as contas conectadas, com as que pedem atenção primeiro.
- Conectar outro gateway: os gateways disponíveis, filtráveis pelas formas de pagamento que você quer aceitar.
Só o Proprietário e os Administradores da loja veem essa página. Editores e Leitores não têm acesso às credenciais.
Sandbox e Produção
Toda conexão é feita em um ambiente, e cada gateway aceita uma conexão por ambiente na mesma loja:
- Sandbox: usa as credenciais de teste do gateway. Os pedidos não envolvem dinheiro real e não contam para a sua fatura da MinePag.
- Produção: usa as credenciais reais. Os pedidos aprovados contam como uso.
Comece em Sandbox, faça uma compra de teste completa e só então conecte as credenciais de Produção. O passo a passo está em Sandbox e Produção.
O que acontece ao conectar
Validação. A MinePag confere as credenciais com uma chamada real ao gateway. Se o gateway recusar, nada é salvo e o painel mostra o motivo.
Cifragem. As credenciais ficam cifradas no banco e nunca voltam a ser exibidas. Para trocar uma chave, você cola a nova no painel.
Webhook. Quando a API do gateway permite, a MinePag registra sozinha o endereço que recebe os avisos de pagamento. Nos demais casos, a página do gateway mostra o endereço e o passo a passo. Veja Webhooks dos gateways.
Rotas. As formas de pagamento que ainda não tinham gateway passam a usar a conexão nova. As que já tinham continuam como estavam.
Histórico. Começa a importação de histórico: as vendas do período escolhido (90 dias por padrão) aparecem em Vendas › Transações, sem virar pedido e sem entrar na sua fatura.
Estados da conexão
| Estado | O que significa | O que fazer |
|---|---|---|
| Validando | A MinePag está conferindo as credenciais e registrando o webhook. Dura poucos segundos. | Aguarde. |
| Conectado | A conexão está pronta para receber pagamentos. | Nada. |
| Webhook pendente | A conexão aceita pagamentos, mas o gateway ainda não avisa a MinePag. Os pagamentos são confirmados pela consulta periódica, com alguns minutos de atraso. | No Mercado Pago, cadastre o webhook e cole a assinatura secreta. Na Stripe e na Efí, use Registrar webhook de novo. Veja Webhooks dos gateways. |
| Credenciais inválidas | O gateway recusou as credenciais guardadas (chave revogada, token vencido, acesso removido). | Gere novas credenciais no gateway e use Atualizar credenciais. |
| Com erro | O gateway não respondeu na última verificação. | Use Testar conexão de novo em alguns minutos. |
| Desativado | A conexão foi desconectada. Ela só aparece no filtro de Vendas › Transações, marcada como desconectada. Pix e boletos emitidos antes da desconexão continuam sendo confirmados até o fim do prazo de conferência. | Conecte de novo, se quiser voltar a usar a conta. |
Uma conexão que não está Conectado nem Webhook pendente sai do checkout: a forma de pagamento que usava essa conexão deixa de aparecer para o cliente até você resolver o problema ou escolher outro gateway.
Guias
Efí
Client ID, Client Secret, certificado .p12 e chave Pix.
Mercado Pago
Login pelo Mercado Pago ou Access Token e Public Key.
PagBank
Token da conta e, se quiser histórico, o Extrato EDI.
Stripe
Chave restrita com as permissões certas e chave publicável.
Rotas de pagamento
Qual gateway atende Pix, boleto e cartão.
Reembolsos e contestações
Devolver o valor ao cliente e o que acontece com os acessos.
Problemas comuns
Mensagens de erro e como resolver.