Seus projetos se comunicam apenas com a API da Mpay. Validamos a chave, roteamos a cobrança para o provedor configurado, acompanhamos o ciclo de vida da transação e devolvemos o status completo via webhook.
Chama POST /v1/checkout com a API key
Valida a chave, identifica o projeto e roteia
Processa o pagamento do cliente final
Recebe a confirmação e calcula a comissão
Notifica seu projeto com status e metadata
Integre uma vez com a API Mpay. Troque de provedor por projeto sem alterar uma linha de código. Stripe hoje, Asaas amanhã — a arquitetura adapter cuida da transição.
Cada projeto recebe sua chave secreta. Gere, revogue, monitore o uso e controle o acesso de forma independente. A chave completa aparece uma única vez — depois, só o prefixo.
mpay_live_••••Defina uma comissão percentual para cada projeto de cliente. Em cada transação, a Mpay calcula o valor bruto, sua comissão e o líquido do vendedor. Projetos próprios ficam em 0%.
Devolutiva automática com payload completo. Se o endpoint retornar erro, a Mpay tenta de novo em 30 segundos, 5 minutos e 30 minutos. Tudo registrado no log.
retry: 30s · 5min · 30minVolume total transacionado, comissões acumuladas, transações filtradas por status e projeto, gráfico dos últimos 30 dias. Tudo em um painel admin centralizado e direto ao ponto.
Chaves em hash SHA-256 (nunca em texto), idempotência no processamento de webhooks (eventos duplicados são ignorados) e validação de assinatura Stripe em todo webhook recebido.
As taxas da Mpay são as taxas públicas dos gateways integrados. Não cobramos taxa própria sobre transações. Sua comissão em lojas de clientes é definida por você como markup por projeto — não é uma taxa da plataforma.
As taxas listadas são do Stripe Brasil (taxas públicas vigentes). A Mpay não adiciona spread sobre as taxas do gateway. Para lojas de clientes no modo Connect, você define livremente seu markup como application_fee — é a sua receita de serviço, configurada por projeto.
Cada projeto cadastrado na Mpay opera em um de dois modos. Você define no momento do cadastro. Os dois coexistem na mesma plataforma.
Para seus SaaS, sites e produtos digitais. O dinheiro cai direto na sua conta Stripe, sem intermediário. Ideal para quem tem dezenas de projetos e precisa de uma única API key mãe.
Para lojas virtuais que você constrói para terceiros. O dinheiro cai na conta Stripe do cliente, e sua comissão é separada automaticamente como application_fee. Fiscalmente correto — cada um recebe o que é seu.
Se você cria sites, lojas e SaaS com frequência e está cansado de integrar pagamentos do zero a cada novo projeto, a Mpay é sua camada padrão. Integre uma vez, reutilize para sempre.
Se você entrega lojas virtuais para clientes e quer monetizar o meio de pagamento com comissão automática e transparente, sem virar banco, a Mpay resolve com Stripe Connect e application_fee.
Se você precisa de cobrança recorrente mensal ou anual em múltiplos produtos, a Mpay centraliza todas as subscriptions em um dashboard único com controle por projeto.
Acesse o painel admin da Mpay, crie o projeto, defina o markup (se houver) e o webhook_url para receber devolutivas.
A chave secreta é exibida uma única vez na criação. Salve-a como variável de ambiente MPAY_API_KEY.
Um POST /v1/checkout com valor, descrição e URLs de retorno. A Mpay devolve o checkout_url para redirecionar o cliente. Pronto.
const res = await fetch('https://pay.muca.com.br/api/v1/checkout', {
method: 'POST',
headers: {
'Authorization': `Bearer ${MPAY_API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
valor: 199.90,
descricao: 'Plano Premium',
customer_email: 'cliente@email.com',
success_url: 'https://site.com/obrigado',
cancel_url: 'https://site.com/cancelado'
})
});
// resposta: { transaction_id, checkout_url, status }
const { checkout_url } = await res.json();
redirect(checkout_url); // prontoCadastre seu primeiro projeto no painel admin e faça uma transação de teste em minutos. Sem contrato, sem mensalidade, sem taxa de setup.
Acessar o painel Mpay