Pular para o conteúdo principal
O ambiente Sandbox permite testar todo o fluxo de pagamentos sem precisar fazer transacoes reais.

​
Como funciona

Na Safefy, nao existe URL separada para Sandbox e Production. O ambiente e determinado pelo tipo de credencial de API que voce utiliza.
Tipo de CredencialAmbienteComportamento
SandboxTestesPagamentos simulados, saldo ficticio
ProductionRealTransacoes PIX reais
URL da API: https://api-payment.safefypay.com.br
A mesma URL e usada para ambos os ambientes. O que muda e a credencial utilizada na autenticacao.

​
Criando credenciais

No painel da Safefy, voce pode criar credenciais para cada ambiente:
1

Acesse o painel

Entre em app.safefypay.com.br e selecione sua organizacao.
2

Va ate Credenciais

No menu lateral, acesse a secao de credenciais de API.
3

Crie a credencial

Escolha o tipo Sandbox para testes ou Production para transacoes reais.
4

Guarde o Client Secret

O Client Secret e exibido apenas uma vez. Guarde-o em local seguro.

​
Simulando pagamentos

Em Sandbox, voce pode simular diferentes status de transacao usando o endpoint de simulacao: 
curl -X POST https://api-payment.safefypay.com.br/v1/transactions/{id}/simulate \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{ "action": "complete" }'

​
Acoes disponiveis

AcaoStatus atualNovo statusDescricao
completePendingCompletedSimula pagamento confirmado
expirePendingExpiredSimula expiracao
failPendingFailedSimula falha
refundCompletedRefundedSimula estorno
O endpoint de simulacao so funciona com credenciais Sandbox. Em Production, os pagamentos sao processados automaticamente pelo sistema PIX.

​
Fluxo de teste completo

1

Crie uma transacao

Use credenciais Sandbox para criar uma transacao 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 recebera o evento transaction.completed.
5

Valide o fluxo

Verifique se sua aplicacao liberou o produto/servico corretamente.

​
Simulando saques

Voce tambem pode simular o processamento de saques: 
curl -X POST https://api-payment.safefypay.com.br/v1/cashouts/{id}/simulate \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{ "action": "Complete" }'
AcaoDescricao
CompleteSimula saque concluido
FailSimula falha no saque
RejectSimula rejeicao do saque

​
Dados de teste

Em Sandbox, voce pode usar qualquer dado valido para criar transacoes e clientes: 
{
  "name": "Joao da Silva Teste",
  "email": "[email protected]",
  "document": "12345678901",
  "documentType": "CPF"
}

​
Indo para Production

Quando sua integracao estiver pronta:
  1. Crie uma credencial de Production no painel
  2. Substitua o Client ID e Client Secret no seu sistema
  3. Remova chamadas ao endpoint /simulate
  4. Teste com transacoes de baixo valor primeiro

Criar transacao de teste

Experimente criar uma transacao no playground.