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

# Primeiros passos

> Configure seus ambientes, obtenha suas credenciais e faça sua primeira requisição

Para começar a integrar com a Delfinance, você precisa configurar seus ambientes de desenvolvimento e obter suas credenciais de acesso. Oferecemos dois ambientes distintos para garantir a segurança e estabilidade da sua integração.

***

## 1. Ambientes: Sandbox vs Produção

| Recurso      | Sandbox (Testes)                            | Produção (Real)                        |
| :----------- | :------------------------------------------ | :------------------------------------- |
| **Objetivo** | Simular cenários de teste sem dinheiro real | Processar transações financeiras reais |
| **URL Base** | `https://apisandbox.delbank.com.br`         | `https://api.delbank.com.br`           |
| **Limites**  | Rate limit reduzido, dados fictícios        | Rate limit comercial, dados reais      |
| **Dinheiro** | Moeda fictícia                              | Dinheiro real (BRL)                    |

***

## 2. Configurando seu Ambiente de Sandbox

O ambiente de Sandbox é o ponto de entrada para testar a integração sem impacto financeiro. O fluxo atual no portal do desenvolvedor é o seguinte:

<Steps>
  <Step title="Acesse o portal do desenvolvedor">
    Entre no [Portal do Desenvolvedor Delfinance Sandbox](https://portal-dev.delfinance.com.br). Na tela de login, você pode entrar com Google, GitHub ou realizar um cadastro tradicional.

    <img src="https://mintcdn.com/delfinance/piCrSxqQRCpOoP1B/assets/tela-login-portal-dev.jpg?fit=max&auto=format&n=piCrSxqQRCpOoP1B&q=85&s=2162a1b261f1163b793f894e8d8fa1cd" alt="Tela de login do portal do desenvolvedor" width="1371" height="786" data-path="assets/tela-login-portal-dev.jpg" />
  </Step>

  <Step title="Acesse a área logada">
    Após entrar, você será direcionado para a home do portal. Ali você encontra o ponto de início para solicitar o acesso ao ambiente de Sandbox.

    <img src="https://mintcdn.com/delfinance/piCrSxqQRCpOoP1B/assets/portal-dev-home.jpg?fit=max&auto=format&n=piCrSxqQRCpOoP1B&q=85&s=8289290c9b913ed3f809a8f9e7907b94" alt="Home do portal do desenvolvedor" width="1843" height="820" data-path="assets/portal-dev-home.jpg" />
  </Step>

  <Step title="Informe seu CNPJ para o Sandbox">
    Na solicitação de credenciais de Sandbox, informe o CNPJ que deseja usar para o ambiente de testes. Preferencialmente, esse CNPJ deve ser o da sua empresa.

    <img src="https://mintcdn.com/delfinance/piCrSxqQRCpOoP1B/assets/portal-dev-solicitacao-crendecial-sandbox.jpg?fit=max&auto=format&n=piCrSxqQRCpOoP1B&q=85&s=7eda2f6611453073ecb8d55fbeae2d65" alt="Solicitação de credencial de sandbox no portal" width="1760" height="887" data-path="assets/portal-dev-solicitacao-crendecial-sandbox.jpg" />

    Se ainda não tiver um CNPJ corporativo disponível, você pode usar um CNPJ temporário para obter as credenciais de Sandbox. Essa necessidade é temporária e, na migração para Produção, você poderá informar o CNPJ real da empresa.
  </Step>

  <Step title="Receba sua chave de API exclusiva">
    Após a solicitação, a plataforma gera uma chave de API exclusiva para a sua integração e disponibiliza essa credencial na home do portal.

    <img src="https://mintcdn.com/delfinance/piCrSxqQRCpOoP1B/assets/portal-dev-credencial-sandbox-disponivel.jpg?fit=max&auto=format&n=piCrSxqQRCpOoP1B&q=85&s=fdf512b0aab83ca1597f1041855444b7" alt="Credencial de sandbox disponível na home" width="1843" height="835" data-path="assets/portal-dev-credencial-sandbox-disponivel.jpg" />

    Você pode copiar a chave quando necessário.

    <img src="https://mintcdn.com/delfinance/piCrSxqQRCpOoP1B/assets/portal-dev-credencial-sandbox-copiada.jpg?fit=max&auto=format&n=piCrSxqQRCpOoP1B&q=85&s=e0f0bed7b2a7903502c8d8f270983389" alt="Credencial de sandbox copiada" width="1847" height="852" data-path="assets/portal-dev-credencial-sandbox-copiada.jpg" />
  </Step>

  <Step title="Use a chave na integração">
    Com a chave em mãos, você já pode autenticar suas requisições no Sandbox. Para Produção, o processo é semelhante, mas com as regras de segurança adicionais aplicadas.
  </Step>
</Steps>

<Warning>
  Nunca compartilhe sua API Key, Account ID ou chave privada do certificado em repositórios públicos.
</Warning>

***

## 3. URLs base e headers padrão

Antes de fazer a primeira chamada, vale conhecer os endpoints e os headers que a API espera.

### URLs base

| Ambiente | URL base                            |
| -------- | ----------------------------------- |
| Sandbox  | `https://apisandbox.delbank.com.br` |
| Produção | `https://api.delbank.com.br`        |

### Headers padrão

Os headers abaixo são parte do modelo atual de integração:

| Cabeçalho                 | Obrigatório             | Descrição                   |
| ------------------------- | ----------------------- | --------------------------- |
| `x-delbank-api-key`       | Sim                     | Chave de API da integração  |
| `x-delfinance-account-id` | Sim                     | Identificador da conta      |
| `Content-Type`            | Sim                     | `application/json`          |
| `IdempotencyKey`          | Em operações de cashout | Chave única de idempotência |

### Próximo passo

Após validar sua integração no Sandbox, o próximo passo é preparar a operação em Produção. Para entender melhor esse processo e o que muda na transição, consulte a página [Ida para Produção](/iniciacao/ida-producao).

***

## 4. Fazendo a primeira requisição

Com a sua API Key e o Account ID em mãos, você já consegue chamar a API no ambiente de Sandbox.

### Passo A: Envie as credenciais da API

Use os headers abaixo para autenticar a requisição:

```bash theme={null}
curl https://apisandbox.delbank.com.br/v1/accounts \
  -H "x-delbank-api-key: SUA_API_KEY" \
  -H "x-delfinance-account-id: SUA_ACCOUNT_ID"
```

### Passo B: Revise as regras de segurança antes de avançar

Antes de migrar para Produção, revise as boas práticas e os componentes de segurança da integração na página [Autenticação e segurança](/iniciacao/autenticacao).