Skip to main content

​
Checklist

1

Teste o fluxo completo em sandbox

Verifique que todos os cenários funcionam com chaves pgz_test_*:
  • Criar links de pagamento (fixo, livre, mínimo)
  • Processar pagamentos PIX e cartão
  • Receber e verificar webhooks
  • Simular expiração e falha de pagamento
  • Se usa assinaturas: criar cycle, plano e simular cobrança
Use a API de simulação para testar cenários de sucesso, falha e expiração sem depender de provedores reais.
2

Complete a verificação de identidade (KYC)

Acesse Configurações → Verificação no painel e envie seus documentos. A aprovação é necessária para acessar o ambiente live.
DocumentoPessoalEmpresa
Documento com fotoObrigatórioObrigatório (representante)
SelfieObrigatórioObrigatório (representante)
Comprovante de endereçoOpcionalOpcional
Contrato social—Obrigatório
3

Configure a chave PIX

Cadastre sua chave PIX (CPF) em Configurações → Chave PIX para receber saques.
4

Gere uma API key de produção

Crie uma nova chave pgz_live_* em Configurações → Chaves de API. Selecione os scopes necessários.
A chave é exibida apenas uma vez. Guarde-a como variável de ambiente no seu servidor.
5

Configure webhooks de produção

Crie endpoints separados para o ambiente live com sua URL de produção:
curl -X POST https://api.pagozz.com/v1/webhooks \
  -H "Pagozz-Token: pgz_live_XXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://meusite.com/webhooks/pagozz",
    "events": ["payment.succeeded", "payment.failed", "payment.expired"]
  }'
Webhooks de test e live são completamente isolados. Crie endpoints separados para cada ambiente.
6

Atualize sua integração

Substitua a chave test pela chave live no seu servidor:
# De:
PAGOZZ_API_KEY=pgz_test_XXXXXXXXXXXXXXXXXXXXXXXX

# Para:
PAGOZZ_API_KEY=pgz_live_XXXXXXXXXXXXXXXXXXXXXXXX
O prefixo da chave determina o ambiente automaticamente — não é necessário alterar URLs ou código.
7

Faça um pagamento real de teste

Crie um link de R$ 1,00 e realize um pagamento PIX real para validar o fluxo end-to-end em produção.

​
Diferenças entre test e live

AspectoTestLive
PIXQR Code placeholderQR Code real via provedor
CartãoSimulação automáticaAnálise de risco real
ConfirmaçãoVia API de simulaçãoVia webhook do provedor
SaldoIndependenteReal (sacável)
WebhooksDisparados normalmenteDisparados normalmente
KYCSimuladoObrigatório
DadosCompletamente isoladosCompletamente isolados

​
Segurança em produção

HTTPS obrigatório

Todos os endpoints de webhook devem usar HTTPS.

Verifique assinaturas

Sempre valide o header X-Pagozz-Signature antes de processar webhooks.

Rotacione chaves

Rotacione suas API keys periodicamente em Configurações → Chaves de API.

Scopes mínimos

Use apenas os scopes necessários para cada integração.

​
Taxas

MétodoTaxa
PIXR$ 0,99 por transação
Cartão de crédito5,29% + R$ 0,59 por transação
Saque (PIX)R$ 2,00 por saque
Sem mensalidade, sem taxa de setup, sem mínimo de transações. Você paga apenas quando recebe.