Consulta de fatura aberta
stable
Este endpoint permite que o cliente do parceiro Bankly consulte os dados de uma fatura em aberto (cycleType
= “Open”) por meio do proxy do cartão e do número do documento de seu titular.
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.
Requisição (Request)
Requisição HTTP
GET https://api-mtls.sandbox.bankly.com.br/cards/invoices/document/{documentNumber}/proxy/{proxy}/open \
--request GET \
--url 'https://api-mtls.sandbox.bankly.com.br/cards/invoices/document/{documentNumber}/proxy/{proxy}/open' \
--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:
Scope | Descrição |
---|---|
invoice.read | Concede acesso para realizar consultas referentes à gestão de faturas. |
Cabeçalhos (Headers)
Nome | Descrição |
---|---|
api-version | Obrigatório. Versão da API. Atualmente estamos na versão 1.0. |
Authorization | Obrigatório. Token de autorização do tipo Bearer. |
Parâmetros da rota (Path)
No path desta requisição, envie os seguintes campos:
Nome | Tipo | Descrição |
---|---|---|
documentNumber | path | Obrigatório. Número do documento do titular do cartão (CPF ou CNPJ). |
proxy | path | Obrigatório. Identificador do cartão. |
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 e retornará um objeto com os dados da fatura em aberto.
Sendo bem-sucedido, o retorno irá trazer os seguintes campos em formato JSON:
Nome | Tipo | Descrição | Número máximo de caracteres |
---|---|---|---|
statementId | integer | Identificador único da fatura. | — |
month | integer | Mês de vencimento da fatura. | — |
year | integer | Ano de vencimento da fatura. | — |
cycle | integer | Indicador do ciclo da fatura (por contrato de crédito). | — |
cycleCloseDate | string | Data de fechamento da fatura, no formato ISO 8601 - UTC. | 25 |
dueDateStart | string | Data inicial do período da fatura, no formato ISO 8601 - UTC. | 25 |
dueDateEnd | string | Data final do período da fatura, no formato ISO 8601 - UTC. | 25 |
dueDate | string | Data de vencimento da fatura, no formato ISO 8601 - UTC. | — |
amountMinimal | number | Valor mínimo a ser pago da fatura. Somente é calculado após o fechamento da fatura. | — |
balance | number | Valor total da fatura. | — |
previousBalance | object | Objeto que contém informações referentes ao valor total da fatura anterior. | — |
previousBalance.value | number | Valor total da fatura anterior. | decimal(18,2) |
previousBalance.currency | string | Código da moeda com base na ISO-4217. | 3 |
cycleType | string | Situação da fatura, a qual pode ser “Open” (fatura aberta), “Future” (fatura futura), “Closed” (fatura fechada) e “DueDate” (fatura atrasada). | — |
documentNumber | string | Número do documento de CPF ou CNPJ do titular do cartão. | — |
paymentStatus | string | Situação do pagamento da fatura, a qual pode ser “Pending” (pendente), “Paid” (paga) e “PartialPaid” (parcialmente paga) | — |
elegibilityCompulsory | boolean | Sinaliza se a fatura é elegível (true) ou não (false) ao parcelamento compulsório. | — |
statementItens[] | array of objects | Lista de objetos que contém informações sobre os itens da fatura. | — |
statementItens[].statementNumber | integer | Número da parcela. | — |
statementItens[].statementTotal | integer | Total de parcelas. | — |
statementItens[].isCredit | boolean | Indica se é uma operação de crédito (true) ou débito (false). | — |
statementItens[].transactionDate | string | Data em que ocorreu a transação, no formato ISO 8601 - UTC. | — |
statementItens[].createdAt | string | Data em que a transação foi postada em fatura, no formato ISO 8601 - UTC. | 25 |
statementItens[].transactionType | string | Tipo da transação. | — |
statementItens[].transaction | object | Objeto que contém informações sobre a transação do item de fatura. Este objeto somente será retornado 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.merchant | string | Nome do estabelecimento/comerciante que aceitou a transação. | — |
statementItens[].transaction.mcc | string | Código MCC da transação. | — |
statementItens[].transaction.entrymode | string | Código do modo de entrada utilizado na transação. | — |
statementItens[].transaction.mcg | string | Descrição do tipo do MCC. | — |
statementItens[].transaction.card | object | Objeto que contém informações sobre o cartão utilizado na transação. | — |
statementItens[].transaction.card.proxy | string | Identificador do cartão utilizado na transação. | — |
statementItens[].transaction.card.lastFourDigits | string | Quatro últimos dígitos do cartão. | — |
statementItens[].transaction.card.alias | string | Apelido dado ao cartão. | — |
statementItens[].transaction.card.cardType | string | Tipo do cartão, o qual pode ser “Physical” (físico) ou “Virtual” (virtual). | — |
statementItens[].amounts[] | array of objects | Objeto contendo os valores de cada item de fatura. | — |
statementItens[].amounts.amountType | string | Indicador do item de fatura, o qual 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.value | number | Valor do item da fatura. | — |
statementItens[].amounts.currency | string | Código da moeda, de acordo com a ISO-4217. Exemplo: BRL. | — |
statementItens[].fees[] | array of objects | Lista de objetos contendo informações sobre as taxas cobradas em saques e transações internacionais. | — |
statementItens[].fees[].feeType | string | Tipo da taxa, o qual 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[].value | number | Valor da taxa. | — |
statementItens[].statementItemId | integer | Indicador do item de fatura. | — |
statementItens[].transactionDescription | string | Descritivo do item da fatura. | — |
statementItens[].isAnticipation | boolean | Indica se o item da fatura foi antecipado (true) ou não (false). | |
summary | object | Objeto que contém informações resumidas sobre a fatura. | — |
summary.outstandingBalance | object | Objeto que contém o saldo residual devedor da fatura anterior. | — |
summary.outstandingBalance.value | number | Valor total do saldo residual. | decimal(18,2) |
summary.outstandingBalance.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.estimatedCharges | object | Objeto que contém o valor estimado de encargos caso a fatura seja rotativada. | — |
summary.estimatedCharges.iof | object | Objeto que contém o valor estimado do IOF caso a fatura seja rotativada. | — |
summary.estimatedCharges.iof.value | number | Valor total estimado do IOF. | decimal(18,2) |
summary.estimatedCharges.iof.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.estimatedCharges.refinance | object | Objeto que contém 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.value | number | Valor total a ser refinanciado. | decimal(18,2) |
summary.estimatedCharges.refinance.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.estimatedCharges.interest | object | Objeto que contém o valor estimado do encargo de refinanciamento caso a fatura seja rotativada. | — |
summary.estimatedCharges.interest.value | number | Valor total estimado dos encargos de refinanciamento. | decimal(18,2) |
summary.estimatedCharges.interest.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.estimatedCharges.traffic | object | Objeto que contém o valor estimado da multa caso a fatura seja rotativada. | — |
summary.estimatedCharges.traffic.value | number | Valor total estimado da multa. | decimal(18,2) |
summary.estimatedCharges.traffic.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.estimatedCharges.annualCet | number | Percentual anual do custo efetivo total da operação de rotativo. | — |
summary.estimatedCharges.monthlyCet | number | Percentual mensal do custo efetivo total da operação de rotativo. | — |
summary.installmentSummary | object | Objeto que contém o resumo dos itens parcelados a vencer (itens de parcelamento que compõem a fatura aberta e faturas futuras). | — |
summary.installmentSummary.interestFree | object | Objeto que contém a soma dos itens de parcela sem juros a vencer. | — |
summary.installmentSummary.interestFree.value | number | Valor total dos itens parcelados sem juros a vencer. | decimal(18,2) |
summary.installmentSummary.interestFree.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.installmentSummary.interest | object | Objeto que contém a soma dos itens de parcela com juros a vencer, com desconto dos encargos que compõem a parcela. | — |
summary.installmentSummary.interest.value | number | Valor total dos itens parcelados com juros a vencer, com desconto dos encargos que compõem a parcela. | decimal(18,2) |
summary.installmentSummary.interest.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.installmentSummary.interestWithoutDiscount | object | Objeto que contém a soma dos itens de parcela com juros a vencer, sem o desconto dos encargos que compõem a parcela. | — |
summary.installmentSummary.interestWithoutDiscount.value | number | Valor total dos itens parcelados com juros a vencer, sem o desconto dos que compõem a parcela. | decimal(18,2) |
summary.installmentSummary.interestWithoutDiscount.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.amountMinimalComposition | object | Objeto que contém os valores que compõem o valor de pagamento mínimo da fatura. | — |
summary.amountMinimalComposition.outstandingBalance | object | Objeto que contém o saldo residual devedor da fatura anterior. | — |
summary.amountMinimalComposition.outstandingBalance.value | number | Valor total do saldo residual. | decimal(18,2) |
summary.amountMinimalComposition.outstandingBalance.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.amountMinimalComposition.fees | object | Objeto que contém a soma dos valores de transações de encargos lançadas na fatura. | — |
summary.amountMinimalComposition.fees.value | number | Valor total dos itens de encargos lançados na fatura. | decimal(18,2) |
summary.amountMinimalComposition.fees.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.amountMinimalComposition.refinance | object | Objeto que contém a soma dos valores de transações de refinanciamento de fatura lançados na fatura. | — |
summary.amountMinimalComposition.refinance.value | number | Valor total dos itens de refinanciamento de fatura lançados em fatura. | decimal(18,2) |
summary.amountMinimalComposition.refinance.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.amountMinimalComposition.transactions | object | Objeto que contém a soma dos valores das transações de débito lançadas em fatura. | |
summary.amountMinimalComposition.transactions.value | number | Valor total das transações de débitos lançadas em fatura. | decimal(18,2) |
summary.amountMinimalComposition.transactions.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsSummary | object | Objeto que contém os valores totais das transações na fatura, agrupados por categoria de transação. | — |
summary.transactionsSummary.nationalPurchasing | object | Objeto que contém a soma dos valores das transações nacionais na fatura. | — |
summary.transactionsSummary.nationalPurchasing.value | number | Valor total das transações nacionais da fatura. | decimal(18,2) |
summary.transactionsSummary.nationalPurchasing.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsSummary.internationalPurchasing[] | array of objects | Objeto que contém a soma dos valores das transações internacionais na fatura. | — |
summary.transactionsSummary.internationalPurchasing[].value | number | Soma dos valores das transações internacionais na fatura. | decimal(18,2) |
summary.transactionsSummary.internationalPurchasing[].currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsSummary.fees | object | Objeto que contém a soma dos valores dos encargos lançados na fatura. | — |
summary.transactionsSummary.fees.value | number | Soma dos valores das transações de encargos lançadas na fatura. | decimal(18,2) |
summary.transactionsSummary.fees.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsSummary.debitAdjustments | object | Objeto que contém a soma dos valores dos ajustes a débito na fatura. | — |
summary.transactionsSummary.debitAdjustments.value | number | Soma dos valores das transações de ajustes a débito na fatura. | decimal(18,2) |
summary.transactionsSummary.debitAdjustments.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsSummary.creditAdjustments | object | Objeto que contém a soma dos valores das transações de ajustes a crédito na fatura. | — |
summary.transactionsSummary.creditAdjustments.value | number | Soma dos valores das transações de ajustes a crédito na fatura. | decimal(18,2) |
summary.transactionsSummary.creditAdjustments.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsSummary.payments | object | Objeto que contém os valores totalizadores de pagamentos. | — |
summary.transactionsSummary.payments.value | number | Soma dos valores das transações de pagamentos. | decimal(18,2) |
summary.transactionsSummary.payments.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsSummary.insurance | object | Objeto que contém a soma dos valores de transações de seguro na fatura. | — |
summary.transactionsSummary.insurance.value | number | Soma dos valores das transações de seguro na fatura. | decimal(18,2) |
summary.transactionsSummary.insurance.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsSummary.annuity | object | Objeto que contém a soma dos valores de transações de anuidade na fatura. | — |
summary.transactionsSummary.annuity.value | number | Soma dos valores das transações da anuidade na fatura. | decimal(18,2) |
summary.transactionsSummary.annuity.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsSummary.withdraw | object | Objeto que contém a soma dos valores de transações de saque na fatura. | — |
summary.transactionsSummary.withdraw.value | number | Soma dos valores das transações de saque na fatura. | decimal(18,2) |
summary.transactionsSummary.withdraw.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsSummary.internationalWithdraw | object | Objeto que contém a soma dos valores de transações de saques internacionais na fatura. | — |
summary.transactionsSummary.internationalWithdraw.value | number | Soma dos valores de transações de saque internacional na fatura. | decimal(18,2) |
summary.transactionsSummary.internationalWithdraw.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsSummary.installment | object | Objeto que contém a soma dos valores das transações parceladas na fatura atual. | — |
summary.transactionsSummary.installment.value | number | Soma dos valores das transações parceladas na fatura atual. | decimal(18,2) |
summary.transactionsSummary.installment.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsCardsSummary[] | array of objects | Lista de objetos que contém os valores totais das transações da fatura, agrupados por cartão e divididos por categoria de transação. | — |
summary.transactionsCardsSummary[].card | object | Objeto que contém as informações do cartão atrelado à transação. | — |
summary.transactionsCardsSummary[].card.type | string | Tipo do cartão, o qual pode ser “Virtual” ou “Physical”. | — |
summary.transactionsCardsSummary[].card.lastFourDigitis | string | Últimos quatro dígitos do cartão. | — |
summary.transactionsCardsSummary[].card.name | string | Nome exibido no cartão. | — |
summary.transactionsCardsSummary[].card.proxy | string | Identificador único do cartão. | — |
summary.transactionsCardsSummary[].totalDebits | object | Objeto que contém a soma dos valores de transações dos itens de débito na fatura atual. | — |
summary.transactionsCardsSummary[].totalDebits.value | number | Soma dos valores das transações dos itens de débito na fatura atual. | decimal(18,2) |
summary.transactionsCardsSummary[].totalDebits.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsCardsSummary[].nationalPurchasing | object | Objeto que contém a soma dos valores de transações nacionais na fatura. | — |
summary.transactionsCardsSummary[].nationalPurchasing.value | number | Soma dos valores das transações nacionais na fatura. | decimal(18,2) |
summary.transactionsCardsSummary[].nationalPurchasing.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsCardsSummary[].internationalPurchasing[] | array of objects | Lista de objetos que contém a soma dos valores de transações internacionais na fatura. | — |
summary.transactionsCardsSummary[].internationalPurchasing[].value | number | Soma dos valores das transações internacionais na fatura. | decimal(18,2) |
summary.transactionsCardsSummary[].internationalPurchasing[].currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsCardsSummary[].fees | object | Objeto que contém a soma dos valores de transações dos encargos na fatura. | — |
summary.transactionsCardsSummary[].fees.value | number | Soma dos valores das transações de encargos na fatura. | decimal(18,2) |
summary.transactionsCardsSummary[].fees.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsCardsSummary[].debtAdjustments | object | Objeto que contém a soma dos valores de transações de ajustes a débito na fatura. | — |
summary.transactionsCardsSummary[].debtAdjustments.value | number | Valor total das transações de ajustes a débito na fatura. | decimal(18,2) |
summary.transactionsCardsSummary[].debtAdjustments.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsCardsSummary[].creditAdjustments | object | Objeto que contém a soma dos valores de transações de ajustes a crédito na fatura. | — |
summary.transactionsCardsSummary[].creditAdjustments.value | number | Soma dos valores das transações de ajustes a crédito na fatura. | decimal(18,2) |
summary.transactionsCardsSummary[].creditAdjustments.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsCardsSummary[].payments | object | Objeto que contém a soma dos valores de transações de pagamentos por cartão. | — |
summary.transactionsCardsSummary[].payments.value | number | Soma dos valores das transações de pagamentos por cartão. | decimal(18,2) |
summary.transactionsCardsSummary[].payments.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsCardsSummary[].insurance | object | Objeto que contém a soma dos valores de transações de seguro na fatura. | — |
summary.transactionsCardsSummary[].insurance.value | number | Soma dos valores das transações de seguro na fatura. | decimal(18,2) |
summary.transactionsCardsSummary[].insurance.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsCardsSummary[].annuity | object | Objeto que contém a soma dos valores de transações de anuidade na fatura. | — |
summary.transactionsCardsSummary[].annuity.value | number | Soma dos valores das transações da anuidade na fatura. | decimal(18,2) |
summary.transactionsCardsSummary[].annuity.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsCardsSummary[].withdraw | object | Objeto que contém a soma dos valores de transações de saque na fatura. | — |
summary.transactionsCardsSummary[].withdraw.value | number | Soma dos valores das transações de saque na fatura. | decimal(18,2) |
summary.transactionsCardsSummary[].withdraw.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsCardsSummary[].internationalWithdraw | object | Objeto que contém a soma dos valores de transações de saques internacionais na fatura. | — |
summary.transactionsCardsSummary[].internationalWithdraw.value | number | Soma dos valores das transações de saques internacionais na fatura. | decimal(18,2) |
summary.transactionsCardsSummary[].internationalWithdraw.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.transactionsCardsSummary[].installment | object | Objeto que contém a soma dos valores de transações parceladas na fatura atual. | — |
summary.transactionsCardsSummary[].installment.value | number | Soma dos valores das transações parceladas na fatura atual. | decimal(18,2) |
summary.transactionsCardsSummary[].installment.currency | string | Código da moeda com base na ISO-4217. | 3 |
summary.nextStatement | object | Objeto que contém informações sobre a próxima fatura. | — |
summary.nextStatement.statementId | integer | Identificador único da próxima fatura. | — |
summary.nextStatement.balance | number | Valor total da próxima fatura, o qual pode ser negativo ou positivo. | decimal(18,2) |
summary.nextStatement.cycleCloseDate | string | Data de fechamento da próxima fatura, no formato ISO 8601 - UTC. | 25 |
{
"statementId": 0,
"month": 0,
"year": 0,
"cycle": 0,
"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",
"elegibilityCompulsory": true,
"previousBalance": {
"value": 0,
"currency": "BRL"
},
"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"
},
"estimatedCharges": {
"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"
},
"debitAdjustments": {
"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"
},
"international_withdraw": {
"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"
},
"debitAdjustments": {
"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": "",
"balance": 100.0,
"cycleCloseDate": ""
}
}
}
Códigos dos tipos de transação
Código | Descrição |
---|---|
REFINANCE_CHARGES | Encargos de refinanciamento |
INTEREST_ON_ARREST | Juros de mora |
TRAFFIC_TICKET | Multa |
PURCHASE_BY_SIGHT | Compra à vista |
INSTALLMENT_WITHOUT_INTEREST | Parcela sem juros |
DEBIT_ADJUSTMENT | Ajuste a débito |
INSTALLMENTS_WITHOUT_INTEREST | Parcelado sem juros |
INSTALLED_WITH_INTEREST | Parcelado com juros |
PAYMENT | Pagamento |
CREDIT_ADJUSTMENT | Ajuste a crédito |
PARTIAL_CANCELLATION_OF_PURCHASE | Cancelamento parcial de compra |
WITHDRAW | Saque |
INTERNATIONAL_PURCHASE | Compra internacional |
INTERNATIONAL_IOF | IOF internacional |
IOF | Imposto sobre Operações Financeiras |
IOF_WITHDRAWAL | IOF sobre o saque |
WITHDRAWAL_CHARGES | Encargos de saque |
ANNUITY | Anuidade |
WITHDRAWAL_RATE | Tarifa de saque |
RATE_CARD_ISSUANCE | Tarifa de emissão de cartão |
REFINANCE_INSTALLMENT | Parcela de refinanciamento |
CANC_CREDIT_INSTALLMENTS | Cancelamento de crédito parcelamento |
PREPAID_CHARGE | Carga de pré-pago |
MEMBERSHIP_PAYMENT | Pagamento de adesão |
PURCHASE_CANCELLATION | Cancelamento de compra |
CANC_INSTALLMENT_WITHOUT_INTEREST | Cancelamento de parcela sem juros |
ANNUAL_REVERSAL | Estorno da anuidade |
CREDIT_BY_INSTALLMENT | Crédito por parcelamento |
REFINANCE_CONTRACT | Contrato de refinanciamento |
CANC_PARC_DE_REF | Cancelamento de parcela de refinanciamento |
EXCHANGE_DIF_DEBIT | Débito de DIF cambial |
DIF_EXCHANGE_CREDIT | Crédito de DIF cambial |
REVERSAL_REFINING_CHARGES | Estorno de encargos de refinanciamento |
REVERSAL_INTEREST | Estorno de juros de mora |
FINE_REVERSAL | Estorno de multa |
REVERSAL_IOF | Estorno de IOF |
CANCELLATION_AGREEMENT_REFINANC | Cancelamento do contrato de refinanciamento |
CREDIT_BY_AGREEMENT | Crédito por acordo |
INSTALLMENT_OF_AGREEMENT | Parcela de acordo |
AGREEMENT_CONTRACT | Contrato de acordo |
CANCELLATION_OF_INSTALLMENT_AGREEMENT | Cancelamento de parcela de acordo |
CANC_CREDIT_AGREEMENT | Cancelamento de crédito de acordo |
CANCELLATION_CONTRACT_AGREEMENT | Cancelamento de contrato de acordo |
CREDIT_BY_INSTALLMENT_CP | Crédito por parcelamento compulsório |
CP_REFINANCING_INSTALLMENT | Parcela de refinanciamento compulsório |
CP_REFINANCE_CONTRACT | Contrato de refinanciamento compulsório |
CANC_PARC_DE_REF_CP | Cancelamento do parcelamento de refinanciamento compulsório |
CANC_CREDIT_INSTALLMENT_CP | Cancelamento de crédito do parcelamento compulsório |
CANCELLATION_CONTRACT_REF_CP | Cancelamento do contrato de refinanciamento compulsório |
DEBIT_PAYMENT | Pagamento com débito |
CREDIT_VOUCHER | Voucher de crédito |
CANC_INSTALLMENTS_WITHOUT_INTEREST | Cancelamento de parcelas sem juros |
CANC_IN_INSTALLMENTS_WITH_INTEREST | Cancelamento de parcelado com juros |
CANC_INSTALLMENT_WITH_INTEREST | Cancelamento de parcelamento com juros |
CANC_INTERNATIONAL_PURCHASE | Cancelamento de compra internacional |
CANC_IOF_INTERNATIONAL | Cancelamento de IOF internacional |
REVERSAL_INTERNATIONAL_WITHDRAWAL | Estorno de saque internacional |
REVERSAL_DEBIT_PAYMENT | Estorno de pagamento com débito |
REVERSED_WITHDRAWAL | Estorno de saque |
REVERSAL_RATE_WITHOUT_WITHDRAWAL | Estorno de tarifa de saque internacional |
INTERNATIONAL_WITHDRAWAL | Saque internacional |
FLAG_PAYMENT | Pagamento da bandeira |
TED_CASH_OUT | TED cash-out |
TEF_CASH_OUT | TEF cash-out |
TED_CASH_IN | TED cash-in |
DEBIT_REVERSAL | Reversão de débito |
REVERSAL_PAYMENT | Estorno de pagamento de adesão |
REVERSED_WITHDRAWAL_CHARGES | Estorno de encargos de saque |
PRE_PAID_RECHARGE_RATE | Tarifa de recarga de pré-pago |
PREPAID_RECHARGE_PERCENTAGE | Percentual de recarga de pré-pago |
MDR | Merchant Discount Rate ou taxa de desconto do comerciante |
REVERSAL_RATE_WITHDRAWAL | Estorno de tarifa de saque |
REVERSAL_IOF_WITHDRAWAL | Estorno de IOF de saque |
CREDIT_VOUCHER_INTER | Voucher de Crédito para transações Internacionais |
Código do modo de entrada (entryMode
)
entryMode
)Código | Descrição |
---|---|
00 | Modo de entrada do PAN desconhecido. |
01 | Entrada do PAN manual. |
02 | Entrada 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. |
03 | Entrada automática via leitor de código de barras. |
04 | Entrada automática de PAN via leitor óptico de caracteres (OCR). |
05 | Entrada automática de PAN via chip. |
06 | Contactless obsoleto. |
07 | Entrada automática de PAN via M/Chip sem contato. |
08 | Contactless MChip obsoleto. |
09 | Entrada de PAN/Token via comércio eletrônico contendo criptograma DSRP em DE 55 (Integrated Circuit Card [ICC] System-Related Data). |
10 | Credencial em arquivo. |
79 | Um 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. |
80 | O cartão com chip não foi capaz de processar/leitura da tarja magnética padrão. |
81 | Entrada de PAN/Token via comércio eletrônico com opcional Identity Check-AAV ou criptograma DSRP em UCAF. |
82 | Entrada automática de PAN via servidor (sistema emissor, adquirente ou fornecedor terceirizado). |
90 | A tarja magnética lê e extrai o conteúdo da Faixa 1 ou Faixa 2 incluída (a verificação CVV é possível). |
91 | Entrada automática do número da conta via tarja magnética sem contato. |
95 | Apenas Visa – Chip com CVV não confiável. |
Dica
Para simular uma requisição nesse endpoint, acesse o API Reference.
Erros
Este endpoint não retorna erros específicos. Porém, ele poderá retornar alguns erros comuns entre todos os endpoints.
Eventos
Este endpoint não possui eventos relacionados a ele.
Updated about 1 month ago