Pular para o conteúdo
Alfasu Pay

Sandbox

Use o ambiente sandbox da Alfasu Pay para testar integrações sem movimentar dinheiro real.

O ambiente sandbox permite testar toda a API Alfasu Pay sem transações financeiras reais. Ideal para desenvolvimento, homologação e demonstrações.

Diferenças do sandbox

| Recurso | Sandbox | Produção | |---|---|---| | Base URL | sandbox.api.alfasupay.com.br | api.alfasupay.com.br | | API Key | sk_test_* | sk_live_* | | Pagamentos | Simulados | Reais | | Webhooks | Funcionais | Funcionais | | Extrato | Dados fictícios | Dados reais |

Como começar

  1. Crie uma conta no painel (a mesma conta serve para sandbox e produção)
  2. Ative o modo sandbox no seletor de ambiente
  3. Gere uma API Key de teste (sk_test_)
  4. Use a base URL do sandbox em todas as requisições

Simulando pagamentos

No sandbox, você pode simular a confirmação de um Pix de duas formas:

  1. Painel: acesse a cobrança e clique em "Simular pagamento"
  2. API: POST /v1/pix/charges/{id}/simulate-payment

Webhooks no sandbox

Configure webhooks normalmente. Ao simular um pagamento, o evento pix.charge.paid será disparado para sua URL.

Testando webhooks localmente

Use ferramentas como ngrok para expor seu servidor local:

ngrok http 3000

Cadastre a URL gerada (ex: https://abc123.ngrok.io/webhooks/alfasu) no painel sandbox.