Contas de Cartão de Crédito

A entidade Bill é recuperada de instituições que suportam este produto. Ela representa uma fatura associada a uma conta do tipo Crédito, especificamente o subtipo CARTÃO_DE_CRÉDITO.

A entidade Bill é recuperada de instituições que suportam este produto. Ela representa uma fatura (fatura) associada a uma conta do tipo "Crédito", especificamente o subtipo CREDIT_CARD. A fatura representa cada fatura que o provedor do cartão envia ao usuário no final do mês com os detalhes da dívida, os impostos envolvidos no período e quando vence.

Apenas suportado em conexões Reguladas

Esta entidade é retornada obrigatoriamente para todas as instituições FI em conexões Open Finance Reguladas. Para conexões Open Finance Diretas, ela é retornada apenas em Inter PF & Itau Cartoes.

{
  "id": "76edd0fa-57b4-4391-be8d-e8b6249d04b1",
  "dueDate": "2023-09-15T00:00:00.000Z",
  "totalAmount": 10000.76,
  "totalAmountCurrencyCode": "BRL",
  "minimumPaymentAmount": 3000,
  "allowsInstallments": true,
  "payments": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "valueType": "FULL_PAYMENT",
      "paymentDate": "2023-09-15T00:00:00.000Z",
      "paymentMode": "PIX",
      "amount": 10000.76,
      "currencyCode": "BRL"
    }
  ],
  "financeCharges": [
    {
      "id": "6119c3e0-706c-4a7a-a734-0fc7a0a94bdb",
      "type": "IOF",
      "amount": 7.01,
      "currencyCode": "BRL",
      "additionalInfo": "NA"
    },
    {
      "id": "3cd450a1-79d1-43fd-a5ea-f77b3fca960d",
      "type": "OTHER",
      "amount": 0,
      "currencyCode": "BRL",
      "additionalInfo": "NA"
    }
  ]
}
PropriedadeTipoOpcionalDescrição
idstringNãoIdentificador primário
dueDatestringNãoData de vencimento da fatura, exibida para pagamento pelo cliente
totalAmountnumberNãoValor total da fatura
totalAmountCurrencyCodestringNãoCódigo que referencia a moeda da fatura
minimumPaymentAmountnumberSimValor mínimo de pagamento da fatura
allowsInstallmentsbooleanSimIndica se a fatura permite pagamentos parcelados (true) ou não (false)
financeChargesarrayNãoLista de encargos associados à fatura (CreditCardBillFinanceCharge)
paymentsarrayNãoLista de pagamentos associados à fatura (CreditCardBillPayment)

Encargo Financeiro da Fatura do Cartão de Crédito#

PropriedadeTipoOpcionalDescrição
idstringNãoIdentificador primário
typestringNãoDenominação dos encargos que se aplicam à fatura da conta de pagamento pós-pago: LATE_PAYMENT_REMUNERATIVE_INTEREST, LATE_PAYMENT_FEE, LATE_PAYMENT_INTEREST, IOF, OTHER
amountnumberNãoValor cobrado pelo encargo/taxa
currencyCodestringNãoCódigo que referencia a moeda do encargo
additionalInfostringSimCampo livre, obrigatório preencher se o tipo de encargo 'OTHER' for selecionado

Pagamento da Fatura do Cartão de Crédito#

PropriedadeTipoOpcionalDescrição
idstringNãoIdentificador primário
valueTypestringNãoTipo de pagamento feito contra a fatura (por exemplo, FULL_PAYMENT, MINIMUM_PAYMENT, OTHER)
paymentDatestringNãoData em que o pagamento foi feito
paymentModestringNãoModo usado para fazer o pagamento (por exemplo, PIX, débito em conta, boleto bancário)
amountnumberNãoValor pago
currencyCodestringNãoCódigo que referencia a moeda do pagamento

Como verificar se uma fatura anterior está quitada#

O saldo de uma fatura é considerado quitado quando os pagamentos registrados no ciclo de faturamento seguinte cobrem o valor total da fatura anterior mais quaisquer encargos financeiros (juros, taxas, etc.) que se acumularam durante esse próximo ciclo:

totalAmount(Bill N) + sum(financeCharges(Bill N+1)) = sum(payments(Bill N+1))

Onde N é a fatura que você deseja verificar e N+1 é a fatura imediatamente seguinte.

Exemplo: verificando a quitação da fatura de janeiro#

Suponha que um cliente tenha duas faturas consecutivas: Janeiro (Bill N) e Fevereiro (Bill N+1).

Para confirmar que o saldo de janeiro foi totalmente pago, a seguinte condição deve ser atendida:

totalAmount(Janeiro) + sum(financeCharges(Fevereiro)) = sum(payments(Fevereiro))
CampoFonteValor
totalAmountFatura de janeiroR$ 500,00
sum(financeCharges)Fatura de fevereiroR$ 12,50
sum(payments)Fatura de fevereiroR$ 512,50

Como 500,00 + 12,50 = 512,50, a fatura de janeiro é considerada quitada.