← Voltar ao blog

Como testar pagamento PIX em ambiente de desenvolvimento

·6 min de leitura

O PIX se tornou o principal meio de pagamento no Brasil. Se você está integrando PIX no seu app — seja com Mercado Pago, PagSeguro, OpenPix, Pagar.me ou outro PSP — precisa testar o fluxo completo. Mas testar pagamentos sem gastar dinheiro real e sem usar dados reais exige entender a diferença entre duas camadas: dados de teste e sandbox de gateway.

Duas camadas de teste

1. Dados de teste (formulário e validação)

Antes de chegar ao gateway, seu formulário precisa aceitar e validar os dados do pagador: CPF, chave PIX, dados bancários. Para isso, você precisa de dados fictícios que passem na validação do seu frontend e backend — mas que não pertençam a ninguém real.

É aqui que entra o FakeForge. Gere chaves PIX nos 4 formatos do BACEN (CPF, email, telefone, EVP), CPFs válidos, e dados bancários com códigos de banco reais.

2. Sandbox do gateway (transação real simulada)

Para testar a transação em si — gerar QR Code, receber webhook de confirmação, atualizar status do pedido — você precisa do ambiente de sandbox do seu PSP. Cada gateway tem suas próprias regras e dados de teste específicos.

Sandbox por gateway

Mercado Pago

O Mercado Pago tem um ambiente de sandbox com credenciais de teste (Access Token de teste). Use a API de pagamentos com as credenciais de sandbox para criar cobranças PIX simuladas. O QR Code gerado pode ser “pago” usando o app de testes do Mercado Pago.

OpenPix

A OpenPix oferece uma conta bancária de teste que permite criar cobranças PIX sem custos. É possível simular o pagamento e receber o webhook de confirmação em tempo real.

Pagar.me

O Pagar.me disponibiliza chaves transacionais de teste e um simulador de PIX no dashboard. Você cria a cobrança via API e simula o pagamento pelo painel.

Gerando dados de teste para PIX

Para a camada de dados (formulários, validação, seed de banco), gere chaves PIX fictícias:

Chaves nos 4 formatos BACEN

Clique em Gerar para começar

Via API para automação

# Gerar 20 chaves PIX para seed
curl "https://fakeforge.com.br/api/generate?type=pixKey&quantity=20"
# Gerar pedido completo com dados de pagamento
curl -X POST "https://fakeforge.com.br/api/generate" \
-H "Content-Type: application/json" \
-d '{"preset":"ecommerce_order","quantity":10}'

Checklist de teste PIX

  • Validação de CPF no formulário — use CPFs fictícios
  • Validação de chave PIX (formato) — use chaves PIX fictícias
  • Geração de QR Code — use sandbox do gateway
  • Webhook de confirmação — use sandbox do gateway
  • Atualização de status do pedido — teste end-to-end no sandbox
  • Seed do banco de staging — use a API com preset ecommerce_order

Resumo

Testar PIX exige duas camadas: dados fictícios para formulários e validação (FakeForge), e sandbox do gateway para transações simuladas (Mercado Pago, OpenPix, Pagar.me). Não misture — cada camada tem seu propósito. E nunca use dados reais em desenvolvimento.