Skip to main content
POST
Cadastra um cartão de crédito, opcionalmente com dívida legada.

Authorizations

Authorization
string
header
required

Token da sessão no cabeçalho Authorization, no formato Bearer (mesmo esquema ApiKeyAuth do contrato).

Headers

x-company-id
string
required

company uuid

Body

application/json

Credit card data

alias
string
required
closing_day
integer
required
due_day
integer
required
active
boolean
credit_limit
number
issuer
string
last4
string
legacy_debt
object
legacy_debt_declared
boolean

LegacyDebtDeclared é a resposta EXPLÍCITA à pergunta "este cartão já tem dívida anterior?" quando a resposta é "não" (legacy_debt ausente).

Sem este campo, um cartão novo sem nenhum item em legacy_debt fica indistinguível de um cadastro que simplesmente não respondeu à pergunta — a lacuna que CreditCardAccount.LegacyDebtDeclaredAt fecha (spec.md § "Como dívida legada informada é determinada", complemento de 2026-09-02). Quando legacy_debt tem qualquer item, a declaração já é IMPLÍCITA (creditcardrepo.AccountRepository.Create trata len(LegacyDebt) > 0 como resposta dada) — enviar este campo true nesse caso não é erro, só redundante.

Response

Created

active
boolean
alias
string
closing_day
integer
created_at
string
credit_limit
number
due_day
integer
id
string
issuer
string
last4
string
legacy_debt_declared
boolean

LegacyDebtDeclared espelha CreditCardAccount.LegacyDebtDeclaredAt != nil — é a RESPOSTA à pergunta sobre dívida anterior, não "existe dívida" (spec.md § "Como dívida legada informada é determinada"). Usada pelo front para decidir se available_limit nulo, na listagem, significa "cadastro incompleto" ou "sem dívida legada, cadastro completo".

legacy_purchases_count
integer

LegacyPurchasesCount é quantos itens de dívida legada (RN4) entraram no cadastro — 0 quando nenhuma dívida foi informada.

updated_at
string