# Bunne API

Documentação API-first de gateway de pagamentos REST para devs e agentes de IA.

Base URL: https://bunne.com.br/api/v1
OpenAPI 3.1: /openapi.json
Docs humanas: /docs
Referência da API: /docs/api-reference
Docs en-US: /docs?lang=en-US
LLMs en-US: /llms-en.txt

Autenticação:
- Use Authorization: Bearer sk_test_xxx ou sk_live_xxx.
- Nunca exponha sk_live_ em código de browser.

Regras centrais:
- Valores monetários trafegam em centavos inteiros.
- Respostas incluem request_id.
- Endpoints de escrita suportam Idempotency-Key.
- Dados brutos de cartão só são aceitos em POST /payment-methods/tokenize.
- Charges usam card_token, nunca PAN/CVV.
- Rotas públicas de PaymentIntent não fazem parte da API pre-GA.

Endpoints:
- GET /health: Healthcheck. Auth: none. Permissão: nenhuma.
- POST /payment-methods/tokenize: Tokenizar método de pagamento. Auth: bearer. Permissão: payment_methods:tokenize.
- POST /charges: Criar charge. Auth: bearer. Permissão: charges:create.
- GET /charges/{id}: Consultar charge. Auth: bearer. Permissão: charges:read.
- POST /charges/{id}/capture: Capturar charge. Auth: bearer. Permissão: charges:create.
- POST /charges/{id}/refund: Estornar charge. Auth: bearer. Permissão: refunds:create.

Eventos de webhook:
- charge.created
- charge.authorized
- charge.paid
- charge.refused
- charge.failed
- charge.refunded
- refund.created
- refund.succeeded
- refund.failed
- chargeback.created
- settlement.created
- settlement.paid
- seller.created
- seller.updated