Pular para o conteúdo principal

​
O que é a Safefy?

Integrar com pagamentos pode ser complicado: documentações confusas, SDKs pesados, respostas inconsistentes. A Safefy nasceu para resolver isso. Somos uma plataforma de pagamentos focada em PIX que oferece:
  • PIX como método de pagamento rápido, seguro e em conformidade com as melhores práticas
  • Interface completa e intuitiva para gestao financeira
  • Suporte exclusivo e eficiente

Primeiros passos

Crie credenciais, gere o token e realize sua primeira transação.

Referência da API

Explore todos os endpoints disponíveis.

​
Estrutura de Organizações

Na Safefy, um usuário pode criar e gerenciar múltiplas organizações. Cada organização representa um CNPJ ou negócio diferente. Como funciona:
  • Cada organização possui seu próprio saldo, transações, clientes e credenciais de API
  • Os dados são completamente isolados entre organizações
  • Um usuário pode alternar entre organizações no painel
  • As credenciais de API são vinculadas a uma organização específica
Ao criar uma credencial de API, ela pertence à organização selecionada no momento. Todas as transações realizadas com essa credencial serão registradas naquela organização.

​
API descomplicada

Nossa API foi construída seguindo três princípios:

​
1. Baseada em intenção

Você diz o que quer fazer, e nós cuidamos do resto. Para criar uma cobrança PIX: 
curl -X POST https://api-payment.safefypay.com.br/v1/transactions \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "pix",
    "amount": 1000,
    "currency": "BRL",
    "description": "Assinatura mensal"
  }'

​
2. Idempotente

Use o campo externalId para garantir que uma requisição duplicada não crie recursos duplicados. Se você enviar duas vezes com o mesmo externalId, a segunda será ignorada. 
{
  "externalId": "pedido-123",
  "method": "pix",
  "amount": 1000,
  "currency": "BRL"
}

​
3. Consistente

Todas as respostas seguem o mesmo padrão, seja sucesso ou erro: 
// Sucesso
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "Pending",
    "amount": 1000
  },
  "message": "Transação criada com sucesso"
}

// Erro
{
  "data": null,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "O campo 'amount' é obrigatório"
  }
}

​
Valores monetarios

Todos os valores são enviados em centavos (menor unidade da moeda).
Valor RealValor na API
R$ 1,00100
R$ 10,501050
R$ 100,0010000

​
Ambientes

O ambiente (Sandbox ou Production) é determinado pela credencial de API utilizada. Não existe URL separada para cada ambiente.
AmbienteDescrição
SandboxCredenciais de sandbox permitem testes e simulações. Nenhum dinheiro real é movimentado.
ProductionCredenciais de produção processam transações reais via PIX.
URL da API: https://api-payment.safefypay.com.br
Para testar, crie uma credencial de Sandbox no painel. Para ir para produção, crie uma credencial de Production na mesma organização.

​
Dúvidas?

Estamos sempre disponíveis para ajudar na sua integração: suporte@safefypay.com.br

Acessar Painel

Acesse o painel para criar suas credenciais e gerenciar pagamentos.