Como funciona
Na Safefy, não existe URL separada para Sandbox e Production. O ambiente é determinado pelo tipo de credencial de API que você utiliza.
URL da API:
https://api-payment.safefypay.com.br
A mesma URL é usada para ambos os ambientes. O que muda é a credencial utilizada na autenticação.
Criando credenciais
No painel da Safefy, você pode criar credenciais para cada ambiente:1
Acesse o painel
Entre em app.safefypay.com.br e selecione sua organização.
2
Vá até Credenciais
No menu lateral, acesse a seção de credenciais de API.
3
Crie a credencial
Escolha o tipo Sandbox para testes ou Production para transações reais.
4
Guarde o Client Secret
O Client Secret é exibido apenas uma vez. Guarde-o em local seguro.
Simulando pagamentos
Em Sandbox, você pode simular diferentes status de transação usando o endpoint de simulação:Ações disponíveis
Fluxo de teste completo
1
Crie uma transação
Use credenciais Sandbox para criar uma transação PIX.
2
Exiba o QR Code
Mostre o qrCode ou copyAndPaste na sua interface.
3
Simule o pagamento
Use o endpoint /simulate com action: complete.
4
Receba o webhook
Sua callbackUrl receberá o evento transaction.completed.
5
Valide o fluxo
Verifique se sua aplicação liberou o produto/serviço corretamente.
Simulando saques
Você também pode simular o processamento de saques:Dados de teste
Em Sandbox, você pode usar qualquer dado válido para criar transações e clientes:Indo para Production
Quando sua integração estiver pronta:- Crie uma credencial de Production no painel
- Substitua o Client ID e Client Secret no seu sistema
- Remova chamadas ao endpoint /simulate
- Teste com transacoes de baixo valor primeiro
Criar transacao de teste
Experimente criar uma transação no playground.