Skip to main content
Boas-vindas à API da Z2Pay, a sua plataforma de pagamentos. Uma integração para aceitar cartão de crédito, PIX e boleto, criar assinaturas recorrentes e dividir valores entre recebedores. Esta documentação foi escrita para quem nunca tocou a API conseguir integrar do zero — cada parâmetro, cada formato e cada cenário de teste está descrito aqui.

Comece em 5 minutos

Do zero ao primeiro pagamento aprovado no sandbox.

Teste sem medo

Ambiente de sandbox com cartões que passam e que falham — e um gerador pronto.

Autenticação

Como obter e usar sua API key.

Webhooks

Receba notificações de cada mudança de status.

O que você NÃO precisa construir

A parte difícil e regulada é nossa:

Conformidade PCI

Os dados do cartão são tokenizados pela Z2Pay — eles nunca passam pelo seu servidor.

PIX, boleto e parcelamento

Geração de QR Code, linha digitável e cálculo de parcelas é por nossa conta.

Página de pagamento

Use o Checkout hospedado e nem precisa montar tela de pagamento.

Cobrança recorrente

Ciclos, geração de faturas e retentativa de cobrança são nossos — você cria o plano e a assinatura.

Dois jeitos de integrar

Checkout hospedado (mais simples)

Você cria um link/sessão e o comprador paga numa página servida pela Z2Pay. Sem lidar com dados de cartão. Ideal para começar rápido.

API direta (transparente)

Você controla a experiência e envia o pagamento via API, usando um token de cartão gerado pelo nosso tokenizer. Mais controle, exige cuidado com o fluxo de tokenização.
Todos os valores monetários são inteiros em centavos (R$ 49,90 = 4990) e as datas seguem ISO 8601 com timezone. Veja Convenções.