> ## Documentation Index
> Fetch the complete documentation index at: https://docs.safefypay.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Comece aqui

> Tudo o que você precisa saber para integrar com a Safefy

## 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

<CardGroup cols={2}>
  <Card title="Primeiros passos" icon="rocket" href="/quickstart">
    Crie credenciais, gere o token e realize sua primeira transação.
  </Card>

  <Card title="Referência da API" icon="code" href="/api-reference/auth/token">
    Explore todos os endpoints disponíveis.
  </Card>
</CardGroup>

***

## 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

<Info>
  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.
</Info>

***

## 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:

```bash theme={null}
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.

```json theme={null}
{
  "externalId": "pedido-123",
  "method": "pix",
  "amount": 1000,
  "currency": "BRL"
}
```

### 3. Consistente

Todas as respostas seguem o mesmo padrão, seja sucesso ou erro:

```json theme={null}
// Sucesso
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "Pending",
    "amount": 1000
  },
  "message": "Transação criada com sucesso"
}
```

```json theme={null}
// 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`

<Note>
  Para testar, crie uma credencial de **Sandbox** no painel. Para ir para produção, crie uma credencial de **Production** na mesma organização.
</Note>

***

## Dúvidas?

Estamos sempre disponíveis para ajudar na sua integração:

**[suporte@safefypay.com.br](mailto:suporte@safefypay.com.br)**

<Card title="Acessar Painel" icon="arrow-up-right-from-square" href="https://app.safefypay.com.br">
  Acesse o painel para criar suas credenciais e gerenciar pagamentos.
</Card>