Comece aqui

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 Real	Valor na API
R$ 1,00	100
R$ 10,50	1050
R$ 100,00	10000

Ambientes

O ambiente (Sandbox ou Production) é determinado pela credencial de API utilizada. Não existe URL separada para cada ambiente.

Ambiente	Descrição
Sandbox	Credenciais de sandbox permitem testes e simulações. Nenhum dinheiro real é movimentado.
Production	Credenciais 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.

Introdução

Conceitos

Status da API

Ambiente de testes

O que é a Safefy?

Primeiros passos

Referência da API

Estrutura de Organizações

API descomplicada

1. Baseada em intenção

2. Idempotente

3. Consistente

Valores monetarios

Ambientes

Dúvidas?

Acessar Painel

​O que é a Safefy?

Primeiros passos

Referência da API

​Estrutura de Organizações

​API descomplicada

​1. Baseada em intenção

​2. Idempotente

​3. Consistente

​Valores monetarios

​Ambientes

​Dúvidas?

Acessar Painel

O que é a Safefy?

Estrutura de Organizações

API descomplicada

1. Baseada em intenção

2. Idempotente

3. Consistente

Valores monetarios

Ambientes

Dúvidas?