Desenvolvedores
Primeira cobrança em 10 minutos.
API REST com JSON, contrato OpenAPI 3.1, sandbox com pagamentos simulados e webhooks assinados. Feita para quem integra ERP.
- Sem mensalidade
- Sem fidelidade
- Sem meta para bater
Início rápido
1. Crie uma cobrança Pix
curl -X POST https://api.mcpfpay.com.br/v1/charges \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: PED-4521" \
-d '{
"method": "pix",
"amount": 15000,
"external_reference": "PED-4521",
"payer": { "name": "Maria Souza", "document": "12345678909" }
}'A resposta traz pix.emv (copia e cola) e pix.expires_at. Valores sempre em centavos.
Webhooks
2. Receba o aviso de pagamento
POST https://seu-erp.com.br/webhooks/mcpfpay
McpfPay-Signature: t=1761000000,v1=5257a869e7ec...
{
"type": "charge.paid",
"data": { "object": { "id": "ch_...", "status": "paid",
"external_reference": "PED-4521" } }
}Confira a assinatura com HMAC-SHA256 de t + "." + corpo usando o segredo do endpoint. Sem resposta 2xx, tentamos de novo por até 72 horas. Use o id do evento para ignorar repetições.
ERPs parceiros
3. Cobre em nome dos seus clientes
# Convite: o cliente autoriza o seu ERP com um código
POST /v1/connections { "document": "11222333000181",
"scopes": ["charges:write", "payment_links:write"] }
# Depois, toda chamada indica a conta do cliente
POST /v1/charges
McpfPay-Account: acc_...Recursos
O que a API oferece
Cobranças Pix e boleto
QR dinâmico com renovação automática; boleto com QR Pix, multa, juros e desconto.
Links de pagamento
Cartão em até 12x, Pix, boleto, Google Pay e Apple Pay numa página hospedada.
Idempotência
Repita um POST com a mesma Idempotency-Key sem risco de cobrança duplicada.
Eventos e reenvio
Histórico de eventos por 30 dias e reenvio sob demanda.
Estorno e cancelamento
Estorno total de cartão e cancelamento de cobranças pendentes.
Sandbox completo
Simule pagamentos de cobranças e links, contas sem cadastro e recusas.