# KyvoPay — contexto para IAs e LLMs

A KyvoPay é um gateway de pagamentos brasileiro (Pix, cartão tokenizado e boleto).
API REST versionada em https://api.kyvopay.com.br/v1 — OpenAPI completo em https://api.kyvopay.com.br/openapi.json.

## Autenticação
Header: Authorization: Bearer sk_test_... (sandbox) ou sk_live_... (produção).
Operações financeiras aceitam o header Idempotency-Key (recomendado).

## Rotas principais
POST https://api.kyvopay.com.br/v1/payments            — criar cobrança { method: "pix"|"card"|"boleto", amount_centavos, customer }
GET  https://api.kyvopay.com.br/v1/payments/{id}       — consultar cobrança
POST https://api.kyvopay.com.br/v1/payments/{id}/cancel
POST https://api.kyvopay.com.br/v1/payments/{id}/refunds
GET  https://api.kyvopay.com.br/v1/balance             — saldo (disponível / pendente / reservado)
POST https://api.kyvopay.com.br/v1/payouts             — solicitar saque (exige 2FA do usuário)
GET/POST/PATCH/DELETE https://api.kyvopay.com.br/v1/developers/webhook-endpoints — gerenciar webhooks

## Convenções
- Dinheiro sempre em centavos inteiros (amount_centavos).
- Respostas no envelope { data, error: { code, message }, request_id }.
- Um pagamento só fica "paid" após confirmação por webhook autenticado.
- Webhooks de saída assinados: header Kyvo-Signature: t=<unix>,v1=<hmac-sha256(secret, t.payload)>.

Documentação para humanos: /docs no site.