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

# Guia de Início Rápido

> Comece com a API KillB em menos de 10 minutos

## Visão Geral

Este guia irá orientá-lo na criação de sua primeira transação de on-ramp cripto usando a API KillB. Você aprenderá como:

* Configurar autenticação
* Criar um usuário
* Criar uma conta de carteira cripto
* Obter uma cotação
* Executar uma transação ramp

<Note>
  Este início rápido usa o **ambiente Sandbox** para testes. Nenhum dinheiro real será transferido.
</Note>

## Pré-requisitos

Antes de começar, certifique-se de ter:

<AccordionGroup>
  <Accordion title="Credenciais da API" icon="key">
    Cadastre-se na KillB e obtenha:

    * Email e senha para autenticação

    Você pode obtê-los no seu [Dashboard KillB](https://otc.killb.com).
  </Accordion>

  <Accordion title="Ambiente de Desenvolvimento" icon="laptop-code">
    * Um terminal ou interface de linha de comando
    * cURL, Postman, ou seu cliente API preferido
    * Conhecimento básico de APIs REST e JSON
  </Accordion>
</AccordionGroup>

## Passo 1: Autenticação

Primeiro, obtenha um token de acesso fazendo login com suas credenciais:

```bash theme={null}
curl --request POST \
  --url https://sandbox.killb.app/api/v2/auth/login \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "seu-email@exemplo.com",
    "password": "sua-senha"
  }'
```

**Resposta:**

```json theme={null}
{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiresIn": 3600000,
  "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
```

<Tip>
  Salve o `accessToken` - você precisará dele para todas as requisições subsequentes. O token expira após 1 hora (3600000 ms).
</Tip>

## Passo 2: Criar um Usuário

Crie um perfil de usuário com informações KYC:

```bash theme={null}
curl --request POST \
  --url https://sandbox.killb.app/api/v2/users \
  --header 'Authorization: Bearer SEU_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "PERSON",
    "externalId": "usuario-12345",
    "data": {
      "firstName": "João",
      "lastName": "Silva",
      "email": "joao.silva@exemplo.com",
      "phone": "+5511987654321",
      "dateOfBirth": "1990-01-01",
      "address": {
        "street1": "Rua Principal 123",
        "city": "São Paulo",
        "state": "SP",
        "zipCode": "01310-100",
        "countryCode": "BR"
      },
      "document": {
        "type": "CPF",
        "number": "12345678901",
        "issuedCountryCode": "BR"
      }
    }
  }'
```

## Passo 3: Criar uma Conta de Carteira

Adicione uma carteira de destino onde a cripto será enviada:

```bash theme={null}
curl --request POST \
  --url https://sandbox.killb.app/api/v2/accounts \
  --header 'Authorization: Bearer SEU_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "WALLET",
    "userId": "4d23aa52-1b40-4584-a8ea-58aba6099c5c",
    "externalId": "carteira-12345",
    "data": {
      "firstName": "João",
      "lastName": "Silva",
      "email": "joao.silva@exemplo.com",
      "phone": "+5511987654321",
      "currency": "USDC",
      "network": "POLYGON",
      "address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
      "countryCode": "BR",
      "document": {
        "type": "CPF",
        "number": "12345678901",
        "issuedCountryCode": "BR"
      }
    }
  }'
```

## Passo 4: Obter uma Cotação

Solicite uma cotação de preço para sua conversão:

```bash theme={null}
curl --request POST \
  --url https://sandbox.killb.app/api/v2/quotations \
  --header 'Authorization: Bearer SEU_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "fromCurrency": "COP",
    "toCurrency": "USDC",
    "amount": 100000,
    "amountIsToCurrency": false,
    "cashInMethod": "PSE",
    "cashOutMethod": "POLYGON"
  }'
```

<Warning>
  As cotações expiram após 30 segundos. Você deve criar o ramp antes da expiração.
</Warning>

## Passo 5: Criar um Ramp

Execute a transação usando a cotação:

```bash theme={null}
curl --request POST \
  --url https://sandbox.killb.app/api/v2/ramps \
  --header 'Authorization: Bearer SEU_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "quotationId": "quot-9f8e7d6c-5b4a-3c2d-1e0f",
    "userId": "4d23aa52-1b40-4584-a8ea-58aba6099c5c",
    "accountId": "7c8b9a3d-2f1e-4b5c-9d8e-1a2b3c4d5e6f"
  }'
```

<Check>
  **Sucesso!** Seu primeiro ramp está criado. O usuário agora pode pagar via a URL de pagamento PSE.
</Check>

## Próximos Passos

<CardGroup cols={2}>
  <Card title="Configurar Webhooks" icon="bell" href="/pt/guides/webhooks/setup">
    Receba notificações em tempo real de atualizações de transações
  </Card>

  <Card title="Implementar Off-Ramps" icon="arrow-down" href="/pt/guides/ramps/off-ramp">
    Aprenda como converter cripto de volta para fiat
  </Card>

  <Card title="Gerenciar Usuários" icon="users" href="/pt/guides/users/manage-users">
    Gerencie níveis KYC e verificação de usuários
  </Card>

  <Card title="Tratamento de Erros" icon="triangle-exclamation" href="/pt/resources/error-handling">
    Aprenda melhores práticas para lidar com erros da API
  </Card>
</CardGroup>

<Info>
  **Precisa de Ajuda?** Entre em contato com o suporte em [tech@killb.com](mailto:tech@killb.com)
</Info>