# Aruba — API de pagamentos

> API REST da Aruba para criar cobranças PIX (Brasil, BRL), consultar o status e receber webhooks. Valores e saldo em reais.

Documentação para integrar a API da Aruba: cobranças PIX, consulta de status e webhooks. Antes de gerar código, leia as regras para assistentes no início de `llms-full.txt`.

## Documentação completa

- [Documentação completa em Markdown](https://docs.arubabr.com/llms-full.txt): todas as páginas num arquivo só, com as regras para assistentes de código.

## Começar

- [Visão geral](https://docs.arubabr.com/llms/visao-geral.md): Crie cobranças PIX a partir do seu sistema e receba a confirmação por webhook. REST, JSON e autenticação por API Key.
- [Início rápido](https://docs.arubabr.com/llms/inicio-rapido.md): Sua primeira cobrança PIX em quatro passos. Esse é o fluxo inteiro de uma integração.
- [Autenticação](https://docs.arubabr.com/llms/autenticacao.md): A criação de cobranças é autenticada por API Key, enviada no header `X-API-Key`. Cada chave pertence a uma conta: as cobranças criadas com ela entram nessa conta.

## Cobranças

- [Criar cobrança](https://docs.arubabr.com/llms/criar-cobranca.md): Cria uma cobrança PIX para um comprador, sem produto cadastrado na Aruba. A resposta traz o código copia-e-cola em `payment_data`.
- [PIX](https://docs.arubabr.com/llms/pix.md): Cobrança em reais paga com copia-e-cola ou QR Code no app do banco.

## Depois do pagamento

- [Consultar status](https://docs.arubabr.com/llms/consultar-status.md): Devolve o status atual da transação e os dados de pagamento gravados na criação. Não exige API Key: pode ser chamada pelo seu servidor, para confirmar um webhook, e pelo navegador, para atualizar a tela do comprador.
- [Webhooks](https://docs.arubabr.com/llms/webhooks.md): A Aruba avisa o seu servidor com um `POST` em JSON quando uma transação sua é atualizada. Use o aviso como gatilho e confirme o status na consulta antes de liberar o pedido.
- [Status da transação](https://docs.arubabr.com/llms/status.md): O campo `status` da consulta e do webhook diz em que ponto a transação está. A venda está paga só com `AUTHORIZED`.

## Referência

- [Erros](https://docs.arubabr.com/llms/erros.md): Erros respondem com `hasError: true`, o código HTTP em `statusCode` e a mensagem em `error`. Erros de validação listam cada problema em `errorFields`.
- [Valores e limites](https://docs.arubabr.com/llms/limites.md): Unidades de valor, mínimo, formatos de dados e limites da conta.
- [Checklist de produção](https://docs.arubabr.com/llms/checklist.md): Confira estes pontos antes de colocar a integração no ar.