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

​
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.
Tipo de CredencialAmbienteComportamento
SandboxTestesPagamentos simulados, saldo fictício
ProductionRealTransações PIX reais
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: 
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" }'

​
Ações disponíveis

AçãoStatus atualNovo statusDescrição
completePendingCompletedSimula pagamento confirmado
expirePendingExpiredSimula expiração
failPendingFailedSimula falha
refundCompletedRefundedSimula estorno
O endpoint de simulação só funciona com credenciais Sandbox. Em Production, os pagamentos são processados automaticamente pelo sistema PIX.

​
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: 
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" }'
AçãoDescrição
CompleteSimula saque concluído
FailSimula falha no saque
RejectSimula rejeição do saque

​
Dados de teste

Em Sandbox, você pode usar qualquer dado válido para criar transações e clientes: 
{
  "name": "João da Silva Teste",
  "email": "joao@teste.com",
  "document": "12345678901",
  "documentType": "CPF"
}

​
Indo para Production

Quando sua integração 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 transação no playground.