Consulta de fatura por ID

stable

Este endpoint permite que o cliente do parceiro Bankly consulte os dados de uma fatura específica, independentemente do seu status, por meio do seu identificador único (id).

📘

Nota

O endpoint de Consulta de fatura por ID também está disponível na versão 2.

Pré-requisitos

Para que seja possível utilizar este endpoint, é necessário que o cliente do parceiro Bankly:

  • Tenha sido aprovado na análise de crédito;
  • Tenha pelo menos um um cartão emitido;
  • Tenha pelo menos uma fatura emitida.

Requisição (Request)

Requisição HTTP

GET 'https://api-mtls.sandbox.bankly.com.br/cards/invoices/{statementId}' \ 
--request GET \ 
--url 'https://api-mtls.sandbox.bankly.com.br/cards/invoices/{statementId}' \ 
--header 'Authorization:  Bearer {Token}' \ 
--header 'accept: application/json' \ 
--header 'api-version: 1.0' 

Autorização

Para garantir a segurança nas requisições, todos os endpoints do Bankly utilizam scopes como parte do seu fluxo de autorização.

Esta requisição requer o scope descrito a seguir:

ScopeDescrição
invoice.readConcede acesso para realizar consultas referentes à gestão de faturas.

Cabeçalhos (Headers)

NomeDescrição
api-versionObrigatório. Versão da API. Neste caso, 1.0.
AuthorizationObrigatório. Token de autorização do tipo Bearer.

Parâmetros da rota (Path)

No path desta requisição, envie o seguinte campo:

NomeTipoDescriçãoEspecificação
statementIdpathObrigatório. Identificador único da fatura, retornado na consulta de todas as faturas.Insira somente números, sem caracteres especiais.

Corpo da requisição (Body)

Não é necessário enviar campos no body desta requisição.

Resposta (Response)

O status code 200 indicará que a solicitação foi aceita com sucesso. O retorno irá trazer os seguintes campos em formato JSON:

NomeTipoDescriçãoNúmero máximo de caracteres
statementIdintegerIdentificador único da fatura.
monthintegerMês de vencimento da fatura.
yearintegerAno de vencimento da fatura.
cycleintegerIndicador do ciclo da fatura (por contrato de crédito).
cycleCloseDatestringData de fechamento da fatura, no formato ISO 8601 - UTC.25
dueDateStartstringData inicial do período da fatura, no formato ISO 8601 - UTC.25
dueDateEndstringData final do período da fatura, no formato ISO 8601 - UTC.25
dueDatestringData de vencimento da fatura, no formato ISO 8601 - UTC.25
amountMinimalnumberValor mínimo a ser pago da fatura. Somente é calculado após o fechamento da fatura.
previousBalanceobjectObjeto que contém informações referentes ao valor total da fatura anterior.
previousBalance.valuenumberValor total da fatura anterior.decimal(18,2)
previousBalance.currencystringCódigo da moeda com base na ISO-4217.3
balancenumberValor total da fatura.
cycleTypestringSituação da fatura, que pode ser “Open” (fatura aberta), “Future” (fatura futura), “Closed” (fatura fechada) e “DueDate” (fatura atrasada).
documentNumberstringNúmero do documento do titular do cartão (CPF ou CNPJ).50
paymentStatusstringSituação do pagamento da fatura, que pode ser “Pending” (pendente), “Paid” (paga) e “PartialPaid” (parcialmente paga).
currentBalanceobjectObjeto que contém informações referentes ao saldo atual da fatura.
currentBalance.valuenumberSaldo atual da fatura, considerando todos os valores creditados e/ou debitados.decimal(18,2)
currentBalance.currencystringCódigo da moeda com base na ISO - 4217.3
elegibilityCompulsorybooleanSinaliza se a fatura é elegível (true) ou não (false) ao parcelamento compulsório.
statementItens[]array of objectsLista de objetos contendo informações sobre os itens da fatura.
statementItens[].statementNumberintegerNúmero da parcela.
statementItens[].statementTotalintegerTotal de parcelas.
statementItens[].isCreditbooleanIndica se é uma operação de crédito (true) ou débito (false).
statementItens[].transactionDatestringData em que ocorreu a transação, no formato ISO 8601 - UTC.25
statementItens[].createdAtstringData em que a transação foi postada em fatura, no formato ISO 8601 - UTC.25
statementItens[].transactionTypestringTipo da transação.
statementItens[].transactionobjectObjeto que contém informações sobre a transação do item de fatura. Observação: os subcampos deste objeto somente serão retornados caso o item seja de uma transação bandeirada (compra, estorno ou outra ação realizada com o cartão). Caso se trate de encargos, pagamentos, anuidade etc., ele não será preenchido.
statementItens[].transaction.merchantstringNome do estabelecimento/comerciante que aceitou a transação.
statementItens[].transaction.mccstringCódigo MCC da transação.
statementItens[].transaction.entrymodestringCódigo do modo de entrada utilizado na transação.
statementItens[].transaction.mcgstringDescrição do tipo do MCC.—-
statementItens[].transaction.cardobjectObjeto que contém informações sobre o cartão utilizado na transação.
statementItens[].transaction.card.proxystringIdentificador do cartão utilizado na transação.30
statementItens[].transaction.card.lastFourDigitsstringQuatro últimos dígitos do cartão.
statementItens[].transaction.card.aliasstringApelido dado ao cartão.
statementItens[].transaction.card.cardTypestringTipo do cartão, que pode ser “Physical” (físico) ou “Virtual” (virtual).
statementItens[].amounts[]array of objectsLista de objetos contendo os valores de cada item de fatura.
statementItens[].amounts[].amountTypestringIndicador do item de fatura, que pode ser “NotMapper” (não informado), “Local” (valor da moeda local), “Exchange” (valor em Dólar da transação, no caso de compra internacional) ou “Billet” (valor cobrado, em Real, ao cliente).
statementItens[].amounts[].valuenumberValor do item da fatura.
statementItens[].amounts[].currencystringCódigo da moeda com base na ISO - 4217.3
statementItens[].fees[]array of objectsLista de objetos contendo informações sobre as taxas cobradas em saques e transações internacionais.
statementItens[].fees[].feeTypestringTipo da taxa, que pode ser “NotMapper” (não informado), “IOF” (Imposto de Operações Financeiras fixo da transação), “Markup” (taxa de conversão para proteção de mudanças de câmbio), “DailyIOF” (IOF diário em cima da fatura) e “Interest” (juros de transação cobrado pelo emissor).
statementItens[].fees[].valuenumberValor da taxa.
statementItens[].statementItemIdintegerIndicador do item de fatura.
statementItens[].transactionDescriptionstringDescritivo do item da fatura.
statementItens[].isAnticipationbooleanIndica se o item da fatura foi antecipado (true) ou não (false).
summaryobjectObjeto que contém informações resumidas sobre a fatura.
summary.outstandingBalanceobjectObjeto que contém informações sobre o saldo residual devedor da fatura anterior.
summary.outstandingBalance.valuenumberSaldo residual, que pode ser negativo (residual com crédito) ou positivo (residual de débito).decimal(18,2)
summary.outstandingBalance.currencystringCódigo da moeda com base na ISO - 4217.3
summary.estimatedChargesobjectObjeto que contém informações sobre o valor estimado de encargos caso a fatura seja rotativada.
summary.estimatedCharges.iofobjectObjeto que contém informações sobre o valor estimado do IOF caso a fatura seja rotativada.
summary.estimatedCharges.iof.valuenumberValor total estimado do IOF.decimal(18,2)
summary.estimatedCharges.iof.currencystringCódigo da moeda com base na ISO - 4217.3
summary.estimatedCharges.refinanceobjectObjeto que contém informações sobre o valor que será refinanciado caso a fatura seja rotativada. Observação: o valor a ser refinanciado é a diferença entre o mínimo da fatura e o valor total.
summary.estimatedCharges.refinance.valuenumberValor total a ser refinanciado.decimal(18,2)
summary.estimatedCharges.refinance.currencystringCódigo da moeda com base na ISO - 4217.3
summary.estimatedCharges.interestobjectObjeto que contém informações sobre o valor estimado do encargo de refinanciamento caso a fatura seja rotativada.
summary.estimatedCharges.interest.valuenumberValor total estimado dos encargos de refinanciamento.decimal(18,2)
summary.estimatedCharges.interest.currencystringCódigo da moeda com base na ISO - 4217.3
summary.estimatedCharges.trafficobjectObjeto que contém informações sobre o valor estimado da multa caso a fatura seja rotativada.
summary.estimatedCharges.traffic.valuenumberValor total estimado da multa.decimal(18,2)
summary.estimatedCharges.traffic.currencystringCódigo da moeda com base na ISO - 4217.3
summary.estimatedCharges.annualCetnumberPercentual anual do custo efetivo total da operação de rotativo.decimal(18,2)
summary.estimatedCharges.monthlyCetnumberPercentual mensal do custo efetivo total da operação de rotativo.decimal(18,2)
summary.installmentSummaryobjectObjeto que contém informações sobre os itens parcelados a vencer (itens de parcelamento que compõem a fatura aberta e faturas futuras).
summary.installmentSummary.interestFreeobjectObjeto que contém informações sobre a soma das parcelas sem juros a vencer.
summary.installmentSummary.interestFree.valuenumberSoma das parcelas sem juros a vencer.decimal(18,2)
summary.installmentSummary.interestFree.currencystringCódigo da moeda com base na ISO - 4217.3
summary.installmentSummary.interestobjectObjeto que contém informações sobre a soma das parcelas com juros a vencer, com desconto dos encargos que compõem a parcela.
summary.installmentSummary.interest.valuenumberSoma das parcelas com juros a vencer, com desconto dos encargos que compõem a parcela.decimal(18,2)
summary.installmentSummary.interest.currencystringCódigo da moeda com base na ISO - 4217.3
summary.installmentSummary.interestWithoutDiscountobjectObjeto que contém informações sobre a soma das parcelas com juros a vencer, sem o desconto dos encargos que compõem a parcela.
summary.installmentSummary.interestWithoutDiscount.valuenumberSoma das parcelas com juros a vencer, sem o desconto dos que compõem a parcela.decimal(18,2)
summary.installmentSummary.interestWithoutDiscount.currencystringCódigo da moeda com base na ISO - 4217.3
summary.amountMinimalCompositionobjectObjeto que contém informações sobre os valores que compõem o valor de pagamento mínimo da fatura.
summary.amountMinimalComposition.outstandingBalanceobjectObjeto que contém informações sobre o saldo residual devedor da fatura anterior.
summary.amountMinimalComposition.outstandingBalance.valuenumberSaldo residual devedor.decimal(18,2)
summary.amountMinimalComposition.outstandingBalance.currencystringCódigo da moeda com base na ISO - 4217.3
summary.amountMinimalComposition.feesobjectObjeto que contém informações sobre a soma doa encargos lançados em fatura.
summary.amountMinimalComposition.fees.valuenumberSoma dos encargos lançados em fatura.decimal(18,2)
summary.amountMinimalComposition.fees.currencystringCódigo da moeda com base na ISO - 4217.3
summary.amountMinimalComposition.refinanceobjectObjeto que contém informações sobre a soma dos itens de refinanciamento de fatura lançados em fatura.
summary.amountMinimalComposition.refinance.valuenumberSoma dos itens de refinanciamento de fatura lançados em fatura.decimal(18,2)
summary.amountMinimalComposition.refinance.currencystringCódigo da moeda com base na ISO - 4217.3
summary.amountMinimalComposition.transactionsobjectObjeto que contém informações sobre a soma dos itens de débito lançados em fatura.
summary.amountMinimalComposition.transactions.valuenumberSoma dos itens de débito lançados em fatura.decimal(18,2)
summary.amountMinimalComposition.transactions.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsSummaryobjectObjeto que contém informações sobre a soma das transações na fatura, agrupados por categoria de transação.
summary.transactionsSummary.nationalPurchasingobjectObjeto que contém informações sobre a soma das transações nacionais na fatura.
summary.transactionsSummary.nationalPurchasing.valuenumberSoma das transações nacionais na fatura.decimal(18,2)
summary.transactionsSummary.nationalPurchasing.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsSummary.internationalPurchasing[]array of objectsObjeto que contém informações sobre a soma das transações internacionais na fatura.
summary.transactionsSummary.internationalPurchasing[].valuenumberSoma das transações internacionais na fatura.decimal(18,2)
summary.transactionsSummary.internationalPurchasing[].currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsSummary.feesobjectObjeto que contém informações sobre a soma dos encargos lançados em fatura.
summary.transactionsSummary.fees.valuenumberSoma dos encargos lançados em fatura.decimal(18,2)
summary.transactionsSummary.fees.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsSummary.debtAdjustmentsobjectObjeto que contém informações sobre a soma dos ajustes a débito lançados em fatura.
summary.transactionsSummary.debtAdjustments.valuenumberSoma dos ajustes a débito lançados em fatura.decimal(18,2)
summary.transactionsSummary.debtAdjustments.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsSummary.creditAdjustmentsobjectObjeto que contém informações sobre a soma dos ajustes a crédito lançados em fatura.
summary.transactionsSummary.creditAdjustments.valuenumberSoma dos ajustes a crédito lançados em fatura.decimal(18,2)
summary.transactionsSummary.creditAdjustments.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsSummary.paymentsobjectObjeto que contém informações sobre a soma dos pagamentos realizados.
summary.transactionsSummary.payments.valuenumberSoma dos pagamentos.decimal(18,2)
summary.transactionsSummary.payments.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsSummary.insuranceobjectObjeto que contém informações sobre a soma dos itens de seguro lançados em fatura.
summary.transactionsSummary.insurance.valuenumberSoma dos itens de seguro lançados em fatura.decimal(18,2)
summary.transactionsSummary.insurance.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsSummary.annuityobjectObjeto que contém informações sobre a soma dos itens de anuidade lançados em fatura.
summary.transactionsSummary.annuity.valuenumberSoma dos itens de anuidade lançados em fatura.decimal(18,2)
summary.transactionsSummary.annuity.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsSummary.withdrawobjectObjeto que contém informações sobre a soma dos itens de saque nacionais na fatura.
summary.transactionsSummary.withdraw.valuenumberSoma dos itens de saque nacionais na fatura.decimal(18,2)
summary.transactionsSummary.withdraw.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsSummary.internationalWithdrawobjectObjeto que contém informações sobre a soma dos itens de saque internacionais na fatura.
summary.transactionsSummary.internationalWithdraw.valuenumberSoma dos itens de saque internacionais na fatura.decimal(18,2)
summary.transactionsSummary.internationalWithdraw.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsSummary.installmentobjectObjeto que contém informações sobre a soma das transações parceladas na fatura atual.
summary.transactionsSummary.installment.valuenumberSoma das transações parceladas na fatura atual.decimal(18,2)
summary.transactionsSummary.installment.currencystringCódigo da moeda com base na ISO - 4217.3
summary. transactionsCardsSummary[]array of objectsLista de objetos contendo informações sobre a soma das transações da fatura, agrupadas por cartão e divididas por categoria de transação.
summary.transactionsCardsSummary[].cardobjectObjeto que contém informações sobre o cartão atrelado à transação.
summary.transactionsCardsSummary[].card.typestringTipo do cartão, que pode ser “Virtual” ou “Physical”.10
summary.transactionsCardsSummary[].card.lastFourDigitisstringQuatro últimos dígitos do cartão.4
summary.transactionsCardsSummary[].card.namestringNome exibido no cartão.20
summary.transactionsCardsSummary[].card.proxystringIdentificador único do cartão.30
summary.transactionsCardsSummary[].totalDebitsobjectObjeto que contém informações sobre a soma dos itens de débito na fatura atual.
summary.transactionsCardsSummary[].totalDebits.valuenumberSoma dos itens de débito na fatura atual.decimal(18,2)
summary.transactionsCardsSummary[].totalDebits.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsCardsSummary[].nationalPurchasingobjectObjeto que contém informações sobre a soma das transações nacionais na fatura.
summary.transactionsCardsSummary[].nationalPurchasing.valuenumberSoma das transações nacionais na fatura.decimal(18,2)
summary.transactionsCardsSummary[].nationalPurchasing.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsCardsSummary[].internationalPurchasing[]array of objectsLista de objetos contendo informações sobre a soma das transações internacionais na fatura.
summary.transactionsCardsSummary[].internationalPurchasing[].valuenumberSoma das transações internacionais na fatura.decimal(18,2)
summary.transactionsCardsSummary[].internationalPurchasing[].currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsCardsSummary[].feesobjectObjeto que contém informações sobre a soma dos encargos lançados em fatura.
summary.transactionsCardsSummary[].fees.valuenumberSoma dos encargos lançados em fatura.decimal(18,2)
summary.transactionsCardsSummary[].fees.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsCardsSummary[].debtAdjustmentsobjectObjeto que contém informações sobre a soma dos ajustes a débito lançados em fatura.
summary.transactionsCardsSummary[].debtAdjustments.valuenumberSoma dos ajustes a débito lançados em fatura.decimal(18,2)
summary.transactionsCardsSummary[].debtAdjustments.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsCardsSummary[].creditAdjustmentsobjectObjeto que contém informações sobre a soma dos ajustes a crédito lançados em fatura.
summary.transactionsCardsSummary[].creditAdjustments.valuenumberSoma dos ajustes a crédito lançados em fatura.decimal(18,2)
summary.transactionsCardsSummary[].creditAdjustments.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsCardsSummary[].paymentsobjectObjeto que contém informações sobre a soma dos pagamentos por cartão.
summary.transactionsCardsSummary[].payments.valuenumberSoma dos pagamentos por cartão.decimal(18,2)
summary.transactionsCardsSummary[].payments.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsCardsSummary[].insuranceobjectObjeto que contém informações sobre a soma dos itens de seguro na fatura.
summary.transactionsCardsSummary[].insurance.valuenumberSoma dos itens de seguro na fatura.decimal(18,2)
summary.transactionsCardsSummary[].insurance.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsCardsSummary[].annuityobjectObjeto que contém informações sobre a soma dos itens de anuidade na fatura.
summary.transactionsCardsSummary[].annuity.valuenumberSoma dos itens de anuidade na fatura.decimal(18,2)
summary.transactionsCardsSummary[].annuity.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsCardsSummary[].withdrawobjectObjeto que contém informações sobre a soma dos itens de saque nacionais na fatura.
summary.transactionsCardsSummary[].withdraw.valuenumberSoma dos itens de saque nacionais na fatura.decimal(18,2)
summary.transactionsCardsSummary[].withdraw.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsCardsSummary[].internationalWithdrawobjectObjeto que contém informações sobre a soma dos itens de saque internacionais na fatura.
summary.transactionsCardsSummary[].internationalWithdraw.valuenumberSoma dos itens de saque internacionais na fatura.decimal(18,2)
summary.transactionsCardsSummary[].internationalWithdraw.currencystringCódigo da moeda com base na ISO - 4217.3
summary.transactionsCardsSummary[].installmentobjectObjeto que contém informações sobre a soma das transações parceladas na fatura atual.
summary.transactionsCardsSummary[].installment.valuenumberSoma das transações parceladas na fatura atual.decimal(18,2)
summary.transactionsCardsSummary[].installment.currencystringCódigo da moeda com base na ISO - 4217.3
nextStatementobjectObjeto que contém informações sobre a próxima fatura.
nextStatement.statementIdnumberIdentificador único da próxima fatura.int(72754)
nextStatement.balancenumberValor total da próxima fatura, que pode ser negativo ou positivo.decimal(74.30)
nextStatement.cycleCloseDatestringData de fechamento da próxima fatura, no formato ISO 8601 - UTC.25
{
    "statementId": 0,
    "month": 0,
    "year": 0,
    "cycle": 0,
    "cycleCloseDate": "2022-10-25T17:21:35.407Z",
    "dueDateStart": "2022-10-25T17:21:35.407Z",
    "dueDateEnd": "2022-10-25T17:21:35.407Z",
    "dueDate": "2022-10-25T17:21:35.407Z",
    "amountMinimal": 0,
    "balance": 0,
    "cycleType": "Open",
    "documentNumber": "47742663023",
    "paymentStatus": "Pending",
    "previousBalance": {
        "value": 0,
        "currency": "BRL"
    },
  	"currentBalance": {
    		"value": 0.00,
    		"currency": "BRL"
  	},
  	"elegibilityCompulsory": true,
    "statementItens": [
        {
            "statementNumber": 0,
            "statementTotal": 0,
            "isCredit": true,
            "transactionDate": "2022-10-25T17:21:35.407Z",
          	"createdAt": "2024-09-12T17:46:15:15.407Z",
            "transactionType": "REFINANCE_CHARGES",
            "transaction": {
                "merchant": "string",
                "mcc": "string",
                "entrymode": "string",
                "mcg": "string",
                "card": {
                    "proxy": "string",
                    "lastFourDigits": "4815",
                    "alias": "string",
                    "cardType": "string"
                }
            },
            "amounts": [
                {
                    "amountType": "NotMapper",
                    "value": 0,
                    "currency": "string"
                }
            ],
            "fees": [
                {
                    "feeType": "NotMapper",
                    "value": 0
                }
            ],
            "statementItemId": 0,
            "transactionDescription": "string",
          	"isAnticipation": false
        }
    ],
    "summary": {
        "outstandingBalance": {
            "value": 107.35,
            "currency": "BRL"
        },
        "estimateCharges": {
            "iof": {
                "value": 495.98,
                "currency": "BRL"
            },
            "refinance": {
                "value": 495.98,
                "currency": "BRL"
            },
            "interest": {
                "value": 495.98,
                "currency": "BRL"
            },
            "trafficValue": {
                "value": 495.98,
                "currency": "BRL"
            },
            "annualCet": 495.98,
            "monthlyCet": 495.98
        },
        "installmentSummary": {
            "interestFree": {
                "value": 114.58,
                "currency": "BRL"
            },
            "interest": {
                "value": 114.58,
                "currency": "BRL"
            },
            "interestWithoutDiscount": {
                "value": 0,
                "currency": "BRL"
            }
        },
        "amountMinimalComposition": {
            "outstandingBalance": {
                "value": 107.35,
                "currency": "BRL"
            },
            "fees": {
                "value": 27.74,
                "currency": "BRL"
            },
            "refinance": {
                "value": 26.86,
                "currency": "BRL"
            },
            "transactions": {
                "value": 152.54,
                "currency": "BRL"
            }
        },
        "transactionsSummary": {
            "nationalPurchasing": {
                "value": 152.544,
                "currency": "BRL"
            },
            "internationalPurchasing": [
                {
                    "value": 152.544,
                    "currency": "BRL"
                },
                {
                    "value": 152.544,
                    "currency": "USS"
                }
            ],
            "fees": {
                "value": 152.544,
                "currency": "BRL"
            },
            "debtAdjustments": {
                "value": 152.544,
                "currency": "BRL"
            },
            "creditAdjustments": {
                "value": 152.544,
                "currency": "BRL"
            },
            "payments": {
                "value": 152.544,
                "currency": "BRL"
            },
            "insurance": {
                "value": 152.544,
                "currency": "BRL"
            },
            "annuity": {
                "value": 152.544,
                "currency": "BRL"
            },
            "withdraw": {
                "value": 152.544,
                "currency": "BRL"
            },
            "internationalWithdraw": {
                "value": 152.544,
                "currency": "BRL"
            },
            "installment": {
                "value": 152.544,
                "currency": "BRL"
            }
        },
        "transactionsCardsSummary": [
            {
                "card": {
                    "type": "virtual",
                    "lastFourDigitis": "1234",
                    "name": "cartão virtual",
                    "proxy": "45567984651321354654"
                },
                "totalDebits": {
                    "value": 0,
                    "currency": "BRL"
                },
                "nationalPurchasing": {
                    "value": 152.544,
                    "currency": "BRL"
                },
                "internationalPurchasing": [
                    {
                        "value": 152.544,
                        "currency": "BRL"
                    },
                    {
                        "value": 152.544,
                        "currency": "USS"
                    }
                ],
                "fees": {
                    "value": 152.544,
                    "currency": "BRL"
                },
                "debtAdjustments": {
                    "value": 152.544,
                    "currency": "BRL"
                },
                "creditAdjustments": {
                    "value": 152.544,
                    "currency": "BRL"
                },
                "payments": {
                    "value": 152.544,
                    "currency": "BRL"
                },
                "insurance": {
                    "value": 152.544,
                    "currency": "BRL"
                },
                "annuity": {
                    "value": 152.544,
                    "currency": "BRL"
                },
                "withdraw": {
                    "value": 152.544,
                    "currency": "BRL"
                },
                "internationalWithdraw": {
                    "value": 152.544,
                    "currency": "BRL"
                },
                "installment": {
                    "value": 152.544,
                    "currency": "BRL"
                }
            }
        ]
    },
  	"nextStatement" : { 
      "statementId": 45263, 
      "balance": 20.63, 
      "cycleCloseDate": "2024-09-15T17:46:25:32.767Z"
    }
}

Códigos dos tipos de transação

CódigoDescrição
REFINANCE_CHARGESEncargos de refinanciamento
INTEREST_ON_ARRESTJuros de mora
TRAFFIC_TICKETMulta
PURCHASE_BY_SIGHTCompra à vista
INSTALLMENT_WITHOUT_INTERESTParcela sem juros
DEBIT_ADJUSTMENTAjuste a débito
INSTALLMENTS_WITHOUT_INTERESTParcelado sem juros
INSTALLED_WITH_INTERESTParcelado com juros
PAYMENTPagamento
CREDIT_ADJUSTMENTAjuste a crédito
PARTIAL_CANCELLATION_OF_PURCHASECancelamento parcial de compra
WITHDRAWSaque
INTERNATIONAL_PURCHASECompra internacional
INTERNATIONAL_IOFIOF internacional
IOFIOF
IOF_WITHDRAWALIOF de saque
WITHDRAWAL_CHARGESEncargos de saque
ANNUITYAnuidade
WITHDRAWAL_RATETarifa de saque
RATE_CARD_ISSUANCETarifa de emissão cartão
REFINANCE_INSTALLMENTParcela de refinanciamento
CANC_CREDIT_INSTALLMENTSCancelamento de crédito parcelado
PREPAID_CHARGECarga de pré-pago
MEMBERSHIP_PAYMENTPagamento de adesão
PURCHASE_CANCELLATIONCancelamento de compra
CANC_INSTALLMENT_WITHOUT_INTERESTCancelamento de parcela sem juros
ANNUAL_REVERSALEstorno anuidade
CREDIT_BY_INSTALLMENTCrédito por parcelamento
REFINANCE_CONTRACTContrato de refinanciamento
CANC_PARC_DE_REFCancelamento de parcela de refinanciamento
EXCHANGE_DIF_DEBITDébito de diferença cambial
DIF_EXCHANGE_CREDITCrédito de diferença cambial
REVERSAL_REFINING_CHARGESEstorno de encargos de refinanciamento
REVERSAL_INTERESTEstorno de juros de mora
FINE_REVERSALEstorno de multa
REVERSAL_IOFEstorno de IOF
CANCELLATION_AGREEMENT_REFINANCCancelamento de contrato de refinanciamento
CREDIT_BY_AGREEMENTCrédito por acordo
INSTALLMENT_OF_AGREEMENTParcela de acordo
AGREEMENT_CONTRACTContrato de acordo
CANCELLATION_OF_INSTALLMENT_AGREEMENTCancelamento da parcela de acordo
CANC_CREDIT_AGREEMENTCancelamento de crédito de acordo
CANCELLATION_CONTRACT_AGREEMENTCancelamento de contrato de acordo
CREDIT_BY_INSTALLMENT_CPCrédito por parcelamento compulsório
CP_REFINANCING_INSTALLMENTParcela de refinanciamento compulsório
CP_REFINANCE_CONTRACTContrato de refinanciamento compulsório
CANC_PARC_DE_REF_CPCancelamento de parcelamento de refinanciamento compulsório
CANC_CREDIT_INSTALLMENT_CPCancelamento de crédito de parcelamento compulsório
CANCELLATION_CONTRACT_REF_CPCancelamento de contrato de refinanciamento compulsório
DEBIT_PAYMENTPagamento com débito
CREDIT_VOUCHERVoucher de crédito
CANC_INSTALLMENTS_WITHOUT_INTERESTCancelamento de parcelado sem juros
CANC_IN_INSTALLMENTS_WITH_INTERESTCancelamento de parcelado com juros
CANC_INSTALLMENT_WITH_INTERESTCancelamento de parcela com juros
CANC_INTERNATIONAL_PURCHASECancelamento de compra internacional
CANC_IOF_INTERNATIONALCancelamento de IOF internacional
REVERSAL_INTERNATIONAL_WITHDRAWALEstorno de saque internacional
REVERSAL_DEBIT_PAYMENTEstorno de débito pagamento
REVERSED_WITHDRAWALEstorno de saque
REVERSAL_RATE_WITHOUT_WITHDRAWALEstorno de tarifa de saque internacional
INTERNATIONAL_WITHDRAWALSaque internacional
FLAG_PAYMENTPagamento da bandeira
TED_CASH_OUTTED cash-out
TEF_CASH_OUTTEF cash-out
TED_CASH_INTED cash-in
DEBIT_REVERSALReversão de débito
REVERSAL_PAYMENTEstorno de pagamento de adesão
REVERSED_WITHDRAWAL_CHARGESEstorno de encargos de saque
PRE_PAID_RECHARGE_RATETarifa de recarga de pré-pago
PREPAID_RECHARGE_PERCENTAGEPercentual de recarga de pré-pago
MDRMDR
REVERSAL_RATE_WITHDRAWALEstorno de tarifa de saque
REVERSAL_IOF_WITHDRAWALEstorno de IOF de saque
CHARGEBACK_PURCHASEContestação de compra
REVERSAL_CHARGEBACK_PURCHASEEstorno de contestação de compra
ANNUAL_REVERSALEstorno anual
REVERSAL_REFINING_CHARGESEstorno de encargos de refinanciamento
REVERSAL_IOFEstorno de IOF
REVERSAL_INTERESTEstorno de juros
REVERSAL_PAYMENTEstorno de pagamento
CREDIT_VOUCHER_INTERCrédito de voucher internacional
CANC_REVERSAL_INTERESTCancelamento de estorno de juros
PAYMENT_INCLUSIONInclusão de pagamento
CANC_ESTORNO_IOFCancelamento de estorno de IOF
CRELIQCrédito de liquidação
INSTALLMENTS_WITH_INTERESTParcelas com juros
REFUND_CHARGESReembolso de encargos
REFUND_FINEReembolso de multa
DEPOSIT_BY_BANK_SLIPDepósito via boleto bancário
PREPAID_RATETaxa pré-paga
OVERLIMIT_FEETarifa por limite excedido
CASHBACKCashback
CANC_CASHBACKCancelamento de cashback
EARLY_PAYMENT_REFUNDReembolso por pagamento antecipado
SEGUROS_CRED Seguro de crédito
SEGUROS_PERDASSeguro de perdas
SEGUROS_DEBDébito de seguro

Código do modo de entrada (entryMode)

CódigoDescrição
00Modo de entrada do PAN desconhecido.
01Entrada do PAN manual.
02Entrada automática do PAN via leitura da tarja magnética. Para transações Plus, este código também significa que o conteúdo exato da faixa 2 está incluído e a verificação de CVV é possível.
03Entrada automática via leitor de código de barras.
04Entrada automática de PAN via leitor óptico de caracteres (OCR).
05Entrada automática de PAN via chip.
06Contactless obsoleto.
07Entrada automática de PAN via M/Chip sem contato.
08Contactless MChip obsoleto.
09Entrada de PAN/Token via comércio eletrônico contendo criptograma DSRP em DE 55 (Integrated Circuit Card [ICC] System-Related Data).
10Credencial em arquivo.
79Um terminal híbrido com conexão online com o adquirente falhou no envio de uma transação de chip fallback (em que DE 22, subcampo 1 = 80) ao emissor.
80O cartão com chip não foi capaz de processar/leitura da tarja magnética padrão.
81Entrada de PAN/Token via comércio eletrônico com opcional Identity Check-AAV ou criptograma DSRP em UCAF.
82Entrada automática de PAN via servidor (sistema emissor, adquirente ou fornecedor terceirizado).
90A tarja magnética lê e extrai o conteúdo da Faixa 1 ou Faixa 2 incluída (a verificação CVV é possível).
91Entrada automática do número da conta via tarja magnética sem contato.
95Apenas Visa – Chip com CVV não confiável.

👍

Dica

Para simular uma requisição nesse endpoint, acesse o API Reference.

Erros

Este endpoint pode retornar alguns erros específicos, conforme a tabela a seguir:

Status CodeCódigoMensagemDescrição
400INVOICE_DATA_NOT_FOUNDInvoice Data not found!A fatura não foi localizada.

Recordamos que esta API também poderá retornar erros comuns entre todos os endpoints. Portanto, recomendamos a consulta da documentação de erros, onde é possível encontrar as mensagens comuns em inglês que acompanham os erros 400 (se houver).

Eventos

Este endpoint não possui eventos relacionados a ele.


Copyright © 2021 Acesso Soluções de Pagamento S.A - Todos os direitos reservados