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

# Comece em minutos

> Da criação da conta à primeira chamada autenticada na API

Ao final deste guia você terá uma API key válida e uma resposta autenticada da API da iuzypay.

## Pré-requisitos

* Uma conta na iuzypay — [crie a sua](https://app.iuzypay.com/register) gratuitamente.
* Um terminal com `curl` (ou o cliente HTTP da sua preferência).

## Primeira chamada

<Steps>
  <Step title="Crie uma API key">
    No dashboard, acesse **Configurações → API keys** e clique em **Criar API key**. Dê um nome que identifique o uso (por exemplo, `servidor-producao`).

    <Warning>
      A chave completa (`iuzy_sk_...`) é exibida **uma única vez**, na criação. Guarde-a em um gerenciador de segredos — depois disso a iuzypay armazena apenas um hash e não consegue recuperá-la.
    </Warning>
  </Step>

  <Step title="Guarde a chave como variável de ambiente">
    Nunca coloque a chave no código. Exporte-a no ambiente do seu servidor:

    ```bash theme={null}
    export IUZYPAY_API_KEY="iuzy_sk_..."
    ```
  </Step>

  <Step title="Chame a API">
    O endpoint [`GET /v1/me`](/api/me) valida a chave e retorna a organização dona dela:

    ```bash theme={null}
    curl https://api.iuzypay.com/v1/me \
      -H "Authorization: Bearer $IUZYPAY_API_KEY"
    ```

    Resposta esperada:

    ```json theme={null}
    {
      "organization": {
        "id": "6f1c9d2e-8a4b-4c3d-9e2f-1a2b3c4d5e6f",
        "name": "Minha Empresa"
      },
      "api_key": {
        "id": "0b7e4a1c-2d3e-4f5a-8b9c-0d1e2f3a4b5c",
        "prefix": "iuzy_sk_AbCd"
      }
    }
    ```
  </Step>
</Steps>

## Próximos passos

<Columns cols={2}>
  <Card title="Convenções da API" icon="book" href="/api/convencoes">
    Entenda erros, IDs, valores em centavos e paginação antes de integrar.
  </Card>

  <Card title="Receber webhooks" icon="webhook" href="/webhooks/receber-eventos">
    Cadastre um endpoint e receba eventos assinados da sua conta.
  </Card>
</Columns>