Pular para o conteúdo principal
O Z2Pay é uma plataforma de pagamentos (PSP). Com uma única integração você aceita cartão de crédito, PIX e boleto, cria assinaturas recorrentes, divide valores entre recebedores (split) e acompanha tudo por webhooks em tempo real. 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 pelo 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.

Roteamento entre adquirentes

Você cadastra o gateway uma vez; nós escolhemos a melhor rota e fazemos failover.

Página de pagamento

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

Dois jeitos de integrar

Checkout hospedado (mais simples)

Você cria um link/sessão e o comprador paga numa página servida pelo 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.