Fluxo

Como funciona

Da criação da cobrança até o dinheiro na sua conta, a Z.PAY cuida de tudo em milissegundos. Veja o fluxo completo passo a passo.

1

Crie sua conta e gere a chave

Cadastre-se, acesse o painel e gere sua chave de API. Use sk_test_ para o sandbox e sk_live_ quando estiver pronto para produção.

2

Gere a cobrança Pix

Faça um POST com o valor e os dados do pedido. Você recebe o QR Code e o link de pagamento na hora.

POST /v2/payments/create

{
  "amount": 9900,
  "method": "pix",
  "description": "Pedido #1234"
}
3

O cliente paga

Ele escaneia o QR Code ou abre o link. O pagamento Pix cai em segundos, a qualquer hora do dia.

4

Aprovação automática com antifraude

Assim que o Pix é recebido, a Z.PAY valida, passa pelo antifraude e concilia tudo no mesmo fluxo — sem você fazer nada.

5

Receba o evento via webhook

Disparamos um POST na sua URL com o status final. Com retry automático e backoff exponencial caso sua aplicação esteja fora do ar.

{
  "event": "payment.paid",
  "data": {
    "id": "60f8a...",
    "status": "paid",
    "amount": 10.00,
    "paymentMethod": "pix",
    "origin": "api"
  }
}

Pronto para começar?

Crie sua conta, gere uma chave e aprove seu primeiro pagamento ainda hoje.

Criar conta grátis