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

# Início rápido

> Crie uma chave, valide a autenticação e gere seu primeiro PIX.

Comece criando uma chave em **Integrações** no painel AgitaPay. Cada chave pertence a uma loja e tem permissões próprias.

<Steps>
  <Step title="Teste a chave">
    O endpoint `GET /account` valida a autenticação sem criar cobranças nem movimentar saldo.

    ```bash theme={null}
    curl -X GET "https://agitapay.johndev.shop/v1/account" \
      -H "Authorization: Bearer agp_li...xxxx"
    ```
  </Step>

  <Step title="Crie uma cobrança PIX">
    E-mail, nome, documento (CPF ou CNPJ) e `notification_url` são obrigatórios.

    ```bash theme={null}
    curl -X POST "https://agitapay.johndev.shop/v1/payments/pix" \
      -H "Authorization: Bearer agp_li...xxxx" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: pedido-1001" \
      -d '{"customer":{"email":"cliente@loja.com","name":"Ana Silva","document":"39053344705"},"amount":19.9,"currency":"BRL","notification_url":"https://loja.com/webhooks/agitapay"}'
    ```
  </Step>

  <Step title="Confirme antes de liberar produto">
    O webhook é um aviso. Ao receber `payment.paid`, confirme no servidor com `GET /payments/{id}` antes de liberar qualquer produto.
  </Step>
</Steps>

<Note>
  Em operação real, envie `Idempotency-Key` em toda criação de PIX ou saque. Sem a chave, um retry após timeout pode cobrar duas vezes.
</Note>

## Próximos passos

* [Autenticação](/api-v1/authentication) — regras da chave e permissões
* [Criar cobrança PIX](/api-v1/pix/create-pix-payment) — QR Code e copia-e-cola
* [Webhooks](/api-v1/webhooks) — receba e confirme eventos de pagamento