Contas, cartões e faturas - Despezzas API

Contas

GET /v1/accounts lista as contas com balance em centavos. Contas importadas pelo Open Finance trazem connection com o status da conexão; a API não conecta nem sincroniza bancos — isso fica no app. type é um de PERSONAL_BANK (padrão), BUSINESS_BANK, INVESTMENT ou OTHER; name e logo são obrigatórios também no PUT.

curl -u "$TOKEN:$SECRET" -H "Content-Type: application/json" \
  -d '{ "name": "Carteira", "logo": "wallet", "balance": 15000, "type": "OTHER" }' \
  https://api.despezzas.com/v1/accounts

Excluir uma conta (DELETE /v1/accounts/{id}) exclui também os lançamentos dela. Se era a última conta de uma conexão Open Finance, o consentimento é revogado no banco — exatamente como no app.

Cartões

GET /v1/credit-card lista os cartões com limit, available_limit, closing_date e expiring_date (dias do mês). Criar exige a conta de pagamento:

curl -u "$TOKEN:$SECRET" -H "Content-Type: application/json" \
  -d '{ "name": "Nubank", "logo": "nubank", "limit": 500000, "closing_date": "3", "expiring_date": "10", "account_id": "ID_DA_CONTA" }' \
  https://api.despezzas.com/v1/credit-card

Faturas

GET /v2/bills/show-by-card/{cardId}?date=2026-09-01 — a fatura do mês, com value, paid, balance e status.
GET /v2/bills/show-by-card/{cardId}/transactions?date=… — os lançamentos dela.
GET /v2/bills/current/{cardId} — a fatura em aberto agora.
POST /v1/bills/pay/{id} — registra o pagamento a partir de uma conta:

curl -u "$TOKEN:$SECRET" -H "Content-Type: application/json" \
  -H "Idempotency-Key: pagamento-2026-09" \
  -d '{ "payment_account_id": "ID_DA_CONTA", "amount": 123456, "date": "2026-09-10" }' \
  https://api.despezzas.com/v1/bills/pay/ID_DA_FATURA

O header Idempotency-Key evita pagamento duplicado em retries.