Claude Code

npm install -g @anthropic-ai/claude-code

# Integração API Owem

## Contexto do Projeto

Este projeto integra com a API Owem para pagamentos PIX no Brasil.

- **Documentação**: https://docs.owem.com.br
- **LLMs.txt**: https://docs.owem.com.br/llms.txt
- **Base URL**: https://api.owem.com.br
- **Autenticação**: Basic Auth (API_KEY:API_SECRET em Base64)

## Endpoints da API Owem

### Autenticação

- `GET /v4/i/ping` - Testa conectividade

### PIX IN (Recebimentos)

- `POST /v4/i/pix/in/dynamic-qrcode` - Gerar QR Code
- `GET /v4/i/pix/in/dynamic-qrcode/{txId}` - Consultar QR Code
- `POST /v4/i/pix/in/refund/{e2e}` - Estornar
- `GET /v4/i/pix/in/refund/{e2e}` - Consultar estorno

### PIX OUT (Pagamentos)

- `POST /v4/i/bank-accounts/{id}/transfer/external` - Transferir
- `GET /v4/i/bank-accounts/{id}/transfer/external/{e2e}` - Consultar

### Ledger

- `GET /v4/i/ledger` - Listar movimentações
- `GET /v4/i/ledger/external-id/{id}` - Por ID externo
- `GET /v4/i/ledger/end-to-end/{e2e}` - Por E2E
- `GET /v4/i/ledger/entry-id/{id}` - Por Entry ID

### Conta

- `GET /v4/i/bank-accounts/{id}/balance` - Consultar saldo

## Padrões Obrigatórios

1. Credenciais em variáveis de ambiente
2. Basic Auth com Base64
3. Tratamento de erros da API
4. Validação de webhooks por IP
5. Idempotência com externalId

## Eventos de Webhook

- `pix_in:qrcode_paid` - QR pago
- `pix_out:succeeded` - Transferência OK
- `pix_out:failed` - Transferência falhou
- `med:created` - Nova disputa

## NÃO FAZER

- Expor credenciais no código
- Ignorar erros da API
- Confiar em webhooks sem validar IP
- Usar HTTP (sempre HTTPS)

claude