Documentação

Integre o checkout PIX da GrandePay

Crie uma cobrança PIX no servidor, apresente o código ao pagador e confirme o pedido por postback assinado.

#Como funciona

Envie POST /v1/checkout com as chaves da empresa e receba o código PIX. A confirmação chega no postbackUrl ou no webhook da conta, assinada com HMAC-SHA256.

Valores monetários entram e saem em centavos inteiros.

#O que você precisa

Empresa ativa e com KYC aprovado.
X-Public-Key e X-Secret-Key no servidor.
Endpoint HTTPS público para postbacks.

#Próximos passos

Primeira chamada

Crie uma cobrança no servidor e leia o código PIX.

Autenticação

Envie as chaves da empresa e trate 401 e 403.

Criar checkout

Referência de POST /v1/checkout, body e respostas.

Postbacks

Receba eventos assinados e responda 2xx.

Checkout PIX ponta a ponta

Da criação à confirmação do pedido.

Assinatura HMAC

Valide o corpo bruto com HMAC-SHA256.

Retries e idempotência

Deduplicação local dos eventos.

Checklist de go-live

Conta, checkout, receptor e recuperação.

Esta página foi útil?