Autorização e confirmação (Authorization)
stable
O processo de autorização consiste numa série de análises internas realizadas pelo Bankly para autorizar o processamento de uma transação com um cartão.
Após a autorização, ocorre o processo de confirmação, no qual o valor é de fato liquidado e o dinheiro é depositado na conta do recebedor.
Todos os eventos relacionados à autorização e à confirmação de transações com o cartão serão comunicados ao destinatário através de mensagens.
Pré-requisitos
Para receber esses eventos, o parceiro deverá:
- Configurar previamente o recebedor de eventos do webhook.
- Conhecer a estrutura básica dos eventos que acompanha o objeto
data.
Informações sobre os eventos
Contexto e nome do evento
Os campos context e name poderão variar de acordo com a tabela a seguir:
context | name | Descrição |
|---|---|---|
Authorization | TRANSACTION_WAS_PROCESSED | A transação foi processada, podendo ser aprovada ou não. Este evento pode ser disparado individualmente caso a transação não seja autorizada ou quando é enviado um voucher por meio de uma autorização (sem uma compra efetuada). |
Authorization | NETWORK_VALIDATION_WAS_PROCESSED | O resultado da validação acatado pela rede de cartões foi processado, indicando a aprovação ou reprovação da transação de débito pela bandeira. |
Authorization | TRANSACTION_WAS_REVERTED | A transação foi revertida parcial ou totalmente. |
Authorization | TRANSACTION_WAS_EXPIRED | O tempo de reserva de saldo da transação expirou e a transação foi revertida. Esse fluxo ocorre em transações pré-pagas. |
Authorization | CONFIRMATION_WAS_PROCESSED | A transação foi confirmada parcial ou totalmente. |
Authorization | CANCELATION_WAS_PROCESSED | A transação foi cancelada. |
Authorization | VOUCHER_WAS_PROCESSED | O voucher (crédito) foi lançado na conta do cliente. |
Fluxo dos eventos
Os fluxogramas a seguir descrevem a sequência em que os eventos ocorrem. Clique na imagem para ampliá-la:
Importante
É possível que os eventos TRANSACTION_WAS_PROCESSED e VOUCHER_WAS_PROCESSED sejam disparados isoladamente. Verifique o tipo de transação e o seu resultado para maior esclarecimento.
Identificador (entityId)
entityId)O campo entityId é o identificador da entidade emissora do evento e seu valor depende do contexto de sua emissão.
No contexto de autorização, o entityId é o identificador único da transação (authorizationTransactionId).
Dados dos eventos
TRANSACTION_WAS_PROCESSED
Este evento sinaliza que a transação foi processada, podendo ser aprovada ou não. Ele pode ser disparado individualmente caso a transação não seja autorizada ou quando é enviado um voucher por meio de uma autorização (sem uma compra efetuada).
Descrição do objeto data do evento
data do eventoO objeto data traz detalhes específicos do contexto em que o evento ocorre. Neste caso, o objeto trará os campos de acordo com a tabela:
| Nome | Tipo | Descrição |
|---|---|---|
account | object | Objeto que contém informações sobre a conta bancária. |
account.branch | string | Número da agência bancária. |
account.number | string | Número da conta. |
account.bank | object | Objeto que contém informações sobre o banco ao qual a conta pertence. |
account.bank.ispb | string | ISPB (Identificador de Sistema de Pagamentos Brasileiro) do banco. |
account.bank.code | string | Código do banco. |
account.bank.name | string | Nome do banco. |
amount | object | Objeto que contém informações sobre o valor da transação. |
amount.value | number | Valor da transação. |
amount.currency | string | Código da moeda com base na ISO-4217. |
withoutFeeAmount | object | Objeto que contém informações sobre o valor da transação sem taxas. |
withoutFeeAmount.value | number | Valor da transação sem taxas. |
withoutFeeAmount.currency | string | Código da moeda com base na ISO-4217. |
iofAmount | object | Objeto que contém informações sobre o valor calculado do IOF da transação. |
iofAmount.value | number | Valor calculado do IOF da transação. |
iofAmount.currency | string | Código da moeda com base na ISO-4217. |
markupAmount | object | Objeto que contém informações sobre o valor calculado do markup da transação. |
markupAmount.value | number | Valor calculado do markup. |
markupAmount.currency | string | Código da moeda com base na ISO-4217. |
withdrawalFeeAmount | object | Objeto que contém informações sobre o valor da tarifa de saque (somente para transações de saque). |
withdrawalFeeAmount.value | number | Valor da tarifa de saque. |
withdrawalFeeAmount.currency | string | Código da moeda com base na ISO-4217. |
fees | object | Objeto que contém informações sobre as taxas aplicadas na transação. |
fees.markup | number | Percentual do markup. |
fees.iof | number | Percentual do IOF. |
fees.dollarExchangeRate | object | Objeto que contém informações sobre a cotação atual do dólar, em reais. |
fees.dollarExchangeRate.value | number | Cotação atual do dólar, em reais. |
fees.dollarExchangeRate.currency | string | Código da moeda local com base na ISO-4217. |
deniedRules | array of strings | Motivos pelos quais a transação foi negada. Confira a lista dos possíveis motivos de negação no final da página. |
status | string | Situação da transação, a qual pode ser “SUCCESS” ou “DENIED”. |
transactionTimeStamp | string | Data e a hora em que ocorreu a transação, no formato ISO 8601 - UTC. |
channel | object | Objeto que contém informações sobre o canal por onde passam os dados recebidos da rede de cartões. |
channel.settlement | object | Objeto que contém informações sobre o valor da transação sem taxas. |
channel.settlement.value | number | Valor da transação sem taxas. |
channel.settlement.currency | string | Código da moeda com base na ISO-4217. |
channel.localAmount | object | Objeto que contém informações sobre o valor da transação sem taxas. |
channel.localAmount.value | number | Valor da transação sem taxas. |
channel.localAmount.currency | string | Código da moeda local com base na ISO-4217. |
channel.entryMode | object | Objeto que contém informações sobre o modo de entrada do cartão. |
channel.entryMode.code | string | Código do modo de entrada de acordo com a ISO-8583. |
channel.entryMode.description | string | Descrição do modo de entrada. |
channel.entryMode.cardPresent | boolean | Indica se este modo de entrada está presente no cartão. |
channel.authorizationCode | string | Identificador da transação da rede do cartão. |
channel.transactionType | object | Objeto que contém informações sobre o tipo da transação de acordo com a ISO-8583. |
channel.transactionType.code | string | Código da transação, o qual pode ser: “00”, “01”, ou “20”. |
channel.transactionType.description | string | Descrição do código, a qual pode ser “purchase” para “00”, “withdraw” para “01” ou “voucher” para “20”. |
channel.wallet | object | Objeto que contém informações sobre a carteira utilizada na transação. Confira a lista com as possíveis carteiras na tabela ao final da página. |
channel.wallet.code | string | Código da carteira. |
channel.wallet.name | string | Nome da carteira. |
channel.retrievalReferenceNumber | string | Identificador de transação da rede do cartão. |
channel.merchant | object | Objeto que contém informações referentes ao estabelecimento/comerciante que aceitou a transação. Seus campos são baseados na ISO-8583. |
channel.merchant.mcc | string | Código mcc da transação. |
channel.merchant.mcg | string | Descrição do tipo do mcc. |
channel.merchant.city | string | Cidade do merchant para identificar parte de sua localização. |
channel.merchant.stateOrCountryCode | string | Código do estado ou do país do merchant para identificar parte da sua localização. |
channel.merchant.state | string | Estado do merchant para identificar parte de sua localização |
channel.merchant.name | string | Nome do merchant. |
channel.merchant.zipCode | string | Código postal do merchant. |
channel.merchant.terminalId | string | Identificador do terminal do merchant. |
channel.merchant.acquirerCode | string | Código do credenciador. |
channel.numberOfInstallments | number | Quantidade de parcelas da transação. |
channel.mti | string | MTI (Message Type Indicator), código que identifica o tipo da transação. |
channel.processingCode | string | Identificador que indica o tipo de transação, o tipo de conta remetente e tipo de conta destinatária. |
channel.passwordPresent | boolean | Indica se a senha do cartão foi informada na autorização. |
channel.preAuthorization | boolean | Em caso de pré-autorização, esse campo retornará TRUE. Caso contrário, FALSE. |
authorizationId | number | Identificador da autorização da processadora. |
channel.name | string | Nome do canal que iniciou a transação no banco. No contexto do autorizador, o canal será sempre “CARD_NETWORK”. |
authorizationTransactionId | string | Identificador da transação gerado pela plataforma de autorização do Bankly. |
card | object | Objeto que contém informações sobre o cartão utilizado na transação. |
card.proxy | string | Código identificador do cartão. |
card.alias | string | Apelido definido pelo proprietário do cartão. |
card.function | string | Função do cartão, a qual pode ser: “Pre”, “Pos”, “Debit”. |
card.type | string | Tipo do cartão, o qual pode ser: “Physical” ou “Virtual”. |
card.programId | string | Identificador do programa ao qual o cartão pertence. |
card.fourLastDigits | string | Quatro últimos dígitos do cartão. |
antiFraudValidationResults[] | array of objects | Lista de objetos com informações sobre a validação antifraude da transação negada. Importante: essa lista será preenchida apenas se a transação for negada e o campo DeniedRules contiver os valores “ANTI_FRAUD_VALIDATION” e/ou “BLOCKED_BY_RISK_ANALYSIS”. |
antiFraudValidationResults[].groupCode | string | Código do grupo de regra em que a transação negada foi classificada. |
antiFraudValidationResults[].processRecommendationCode | string | Orientações sobre como atender ao cliente em caso de contato, incluindo uma estimativa do tempo necessário para a liberação do uso da solução de bypass. |
Payload do evento
O payload abaixo exemplifica a estrutura do evento que deverá ser recebido pelo parceiro. Clique na seta para expandi-lo:
Exemplos de payloads
{
"entityId": "3af1dddc-3b71-4261-8707-81162b412e6a",
"companyKey": "COMPANY_KEY",
"name": "TRANSACTION_WAS_PROCESSED",
"timestamp": "2024-01-22T17:16:30.5847204Z",
"correlationId": "53c7ee96-e15d-497d-930a-22dc7b82f029",
"context": "Authorization",
"idempotencyKey": "53c7ee96-e15d-497d-930a-22dc7b82f029",
"data": {
"account": {
"branch": "0001",
"number": "15164",
"bank": {
"ispb": "13140088",
"code": "332",
"name": "Acesso Soluções De Pagamento S.A."
}
},
"amount": {
"value": 11,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 11,
"currency": "BRL"
},
"deniedRules": [
"BLOCKED_BY_RISK_ANALYSIS",
"ANTI_FRAUD_VALIDATION"
],
"status": "SUCCESS",
"transactionTimeStamp": "2022-11-09T21:42:02",
"channel": {
"settlement": {
"value": 11,
"currency": "USD"
},
"localAmount": {
"value": 11,
"currency": "BRL"
},
"entryMode": {
"code": "07",
"description": "PAN auto-entry via contactless M/Chip",
"cardPresent": true
},
"authorizationCode": "RZNZPW",
"transactionType": {
"code": "00",
"description": "Purchase"
},
"wallet": {
"code": "0",
"name": "Unknown"
},
"retrievalReferenceNumber": "136248133",
"merchant": {
"mcc": "5411",
"mcg": "Supermarkets",
"city": "FORTALEZA ",
"stateOrCountryCode": "BRA",
"state": "",
"name": "teste",
"zipCode": "",
"terminalId": "TM000018",
"acquirerCode": "998653213"
},
"numberOfInstallments": 1,
"processingCode": "000000",
"passwordPresent": false,
"mti": "0200",
"preAuthorization": true,
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "3af1dddc-3b71-4261-8707-81162b412e6a",
"card": {
"programId": "128",
"proxy": "0000000000000000000",
"fourLastDigits": "2817",
"alias": "Debito",
"function": "Debit",
"type": "Physical"
},
"antiFraudValidationResults ": [
{
"groupCode": "CARD_111",
"processRecommendationCode": "CARD_PROCESS_111"
}
],
}
}
{
"entityId": "67293c59-d42e-459d-9121-e7a0d091cbd6",
"companyKey": "ACESSO",
"name": "TRANSACTION_WAS_PROCESSED",
"timestamp": "2024-03-26T20:02:30.0018652Z",
"correlationId": "833db6f5-f8db-459a-adaa-747ca1d55595",
"context": "Authorization",
"idempotencyKey": "833db6f5-f8db-459a-adaa-747ca1d55595",
"data": {
"account": {
"branch": "0001",
"number": "15164",
"bank": {
"ispb": "13140088",
"code": "332",
"name": "Acesso Soluções De Pagamento S.A."
}
},
"amount": {
"value": 21.8,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 19.92,
"currency": "BRL"
},
"iofAmount": {
"value": 0.88,
"currency": "BRL"
},
"markupAmount": {
"value": 1,
"currency": "BRL"
},
"fees": {
"markup": 0.05,
"iof": 0.0438,
"dollarExchangeRate": {
"value": 4.9798,
"currency": "BRL"
}
},
"deniedRules": [],
"status": "SUCCESS",
"transactionTimeStamp": "2022-11-09T21:42:02",
"channel": {
"settlement": {
"value": 4,
"currency": "USD"
},
"localAmount": {
"value": 4,
"currency": "USD"
},
"entryMode": {
"code": "81",
"description": "PAN/Token entry via electronic commerce with optional Identity Check-AAV or DSRP cryptogram in UCAF.",
"cardPresent": false
},
"authorizationCode": "RZNZPW",
"transactionType": {
"code": "00",
"description": "Purchase"
},
"wallet": {
"code": "0",
"name": "Unknown"
},
"retrievalReferenceNumber": "136248133",
"merchant": {
"mcc": "5411",
"mcg": "Supermarkets",
"city": "new york",
"stateOrCountryCode": "USA",
"state": "",
"name": "amazon",
"zipCode": "",
"terminalId": "TM000018",
"acquirerCode": "998653213"
},
"numberOfInstallments": 1,
"processingCode": "000000",
"passwordPresent": false,
"mti": "0200",
"preAuthorization": true,
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "67293c59-d42e-459d-9121-e7a0d091cbd6",
"card": {
"programId": "128",
"proxy": "2340281000243642749",
"fourLastDigits": "2817",
"alias": "Debito",
"function": "Debit",
"type": "Physical"
}
}
}
{
"entityId": "8e658cd4-144d-4d8e-8230-629b968f2c37",
"companyKey": "ACESSO",
"name": "TRANSACTION_WAS_PROCESSED",
"timestamp": "2024-03-27T19:11:09.9238238Z",
"correlationId": "c78b4105-def2-474e-bb40-88eba351cb6f",
"context": "Authorization",
"idempotencyKey": "c78b4105-def2-474e-bb40-88eba351cb6f",
"data": {
"account": {
"branch": "0001",
"number": "15164",
"bank": {
"ispb": "13140088",
"code": "332",
"name": "Acesso Soluções De Pagamento S.A."
}
},
"amount": {
"value": 1,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 1,
"currency": "BRL"
},
"deniedRules": [],
"status": "SUCCESS",
"transactionTimeStamp": "2024-03-27T16:11:09.712-03:00",
"channel": {
"settlement": {
"value": 1,
"currency": "USD"
},
"localAmount": {
"value": 1,
"currency": "BRL"
},
"entryMode": {
"code": "81",
"description": "PAN/Token entry via electronic commerce with optional Identity Check-AAV or DSRP cryptogram in UCAF.",
"cardPresent": false
},
"authorizationCode": "6841317932663276",
"transactionType": {
"code": "00",
"description": "Purchase"
},
"wallet": {
"code": "0",
"name": "Unknown"
},
"retrievalReferenceNumber": "6841317932663276",
"merchant": {
"mcc": "5199",
"mcg": "Food",
"city": "sao paula",
"stateOrCountryCode": "BRA",
"state": "",
"name": "TESTE",
"zipCode": "",
"terminalId": ""
},
"numberOfInstallments": 1,
"authorizationId": 6841317932663276,
"passwordPresent": false,
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "8e658cd4-144d-4d8e-8230-629b968f2c37",
"card": {
"programId": "107",
"proxy": "2229141001432904325",
"alias": "Credito pos",
"function": "Pos",
"type": "Virtual"
}
}
}
{
"entityId": "9d35e782-09ac-4e28-a6f5-b8719862b6c8",
"companyKey": "ACESSO",
"name": "TRANSACTION_WAS_PROCESSED",
"timestamp": "2024-03-27T21:14:47.456964Z",
"correlationId": "e374cad4-72f5-4f1b-8a6e-7d8f1888fa5b",
"context": "Authorization",
"idempotencyKey": "e374cad4-72f5-4f1b-8a6e-7d8f1888fa5b",
"data": {
"account": {
"branch": "0001",
"number": "15164",
"bank": {
"ispb": "13140088",
"code": "332",
"name": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO"
}
},
"amount": {
"value": 2,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 2,
"currency": "BRL"
},
"deniedRules": [],
"status": "SUCCESS",
"transactionTimeStamp": "2024-03-27T21:14:46.357Z",
"channel": {
"settlement": {
"value": 2,
"currency": "USD"
},
"localAmount": {
"value": 2,
"currency": "BRL"
},
"entryMode": {
"code": "81",
"description": "PAN/Token entry via electronic commerce with optional Identity Check-AAV or DSRP cryptogram in UCAF.",
"cardPresent": false
},
"authorizationCode": "a0043fb1-7647-43d9-b9e9-abef41d4d51f",
"transactionType": {
"code": "00",
"description": "Purchase"
},
"wallet": {
"code": "111",
"name": "Unknown"
},
"retrievalReferenceNumber": "a0043fb1-7647-43d9-b9e9-abef41d4d51f",
"merchant": {
"mcc": "5311",
"mcg": "Department",
"city": "Luxemburg ",
"stateOrCountryCode": "BRA",
"state": "",
"name": "TESTE",
"zipCode": "",
"terminalId": "62683744",
"acquirerCode": "7133380"
},
"numberOfInstallments": 1,
"processingCode": "003100",
"passwordPresent": true,
"mti": "0100",
"preAuthorization": false,
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "9d35e782-09ac-4e28-a6f5-b8719862b6c8",
"card": {
"programId": "31",
"proxy": "2307171003721696184",
"fourLastDigits": "4237",
"alias": "Novo",
"function": "Pre",
"type": "Physical"
}
}
}
{
"entityId": "bffcc517-f310-4e96-a4d0-5b35d0e12df4",
"companyKey": "ACESSO",
"name": "TRANSACTION_WAS_PROCESSED",
"timestamp": "2024-03-27T12:55:58.0015373Z",
"correlationId": "055897de-d9be-403b-9a0f-af7616e61315",
"context": "Authorization",
"idempotencyKey": "055897de-d9be-403b-9a0f-af7616e61315",
"data": {
"account": {
"branch": "0001",
"number": "15164",
"bank": {
"ispb": "13140088",
"code": "332",
"name": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO"
}
},
"amount": {
"value": 10.9,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 9.96,
"currency": "BRL"
},
"iofAmount": {
"value": 0.44,
"currency": "BRL"
},
"markupAmount": {
"value": 0.5,
"currency": "BRL"
},
"fees": {
"markup": 0.05,
"iof": 0.0438,
"dollarExchangeRate": {
"value": 4.9798,
"currency": "BRL"
}
},
"deniedRules": [],
"status": "SUCCESS",
"transactionTimeStamp": "2024-03-27T12:55:56.657Z",
"channel": {
"settlement": {
"value": 2,
"currency": "USD"
},
"localAmount": {
"value": 2,
"currency": "USD"
},
"entryMode": {
"code": "81",
"description": "PAN/Token entry via electronic commerce with optional Identity Check-AAV or DSRP cryptogram in UCAF.",
"cardPresent": false
},
"authorizationCode": "bb9d9ecc-0fa8-472d-8ce2-b810acd6824a",
"transactionType": {
"code": "00",
"description": "Purchase"
},
"wallet": {
"code": "111",
"name": "Unknown"
},
"retrievalReferenceNumber": "bb9d9ecc-0fa8-472d-8ce2-b810acd6824a",
"merchant": {
"mcc": "5311",
"mcg": "Department",
"city": "Luxemburg ",
"stateOrCountryCode": "USA",
"state": "",
"name": "TESTE",
"zipCode": "",
"terminalId": "62683744",
"acquirerCode": "7133380"
},
"numberOfInstallments": 1,
"processingCode": "003100",
"passwordPresent": true,
"mti": "0100",
"preAuthorization": false,
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "bffcc517-f310-4e96-a4d0-5b35d0e12df4",
"card": {
"programId": "31",
"proxy": "2307171003721696184",
"fourLastDigits": "4237",
"alias": "Novo",
"function": "Pre",
"type": "Physical"
}
}
}
{
"entityId": "647ef3fe-82a0-4b88-8103-aebf70b24832",
"companyKey": "ACESSO",
"name": "TRANSACTION_WAS_PROCESSED",
"timestamp": "2024-03-27T19:16:46.375026Z",
"correlationId": "4fef24ea-a033-440a-b418-d68f18acb7cc",
"context": "Authorization",
"idempotencyKey": "4fef24ea-a033-440a-b418-d68f18acb7cc",
"data": {
"account": {
"branch": "0001",
"number": "15164",
"bank": {
"ispb": "13140088",
"code": "332",
"name": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO"
}
},
"amount": {
"value": 5.45,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 4.98,
"currency": "BRL"
},
"iofAmount": {
"value": 0.22,
"currency": "BRL"
},
"markupAmount": {
"value": 0.25,
"currency": "BRL"
},
"fees": {
"markup": 0.05,
"iof": 0.0438,
"dollarExchangeRate": {
"value": 4.9798,
"currency": "BRL"
}
},
"deniedRules": [],
"status": "SUCCESS",
"transactionTimeStamp": "2024-03-27T19:16:44.952Z",
"channel": {
"settlement": {
"value": 1,
"currency": "USD"
},
"localAmount": {
"value": 1,
"currency": "USD"
},
"entryMode": {
"code": "81",
"description": "PAN/Token entry via electronic commerce with optional Identity Check-AAV or DSRP cryptogram in UCAF.",
"cardPresent": false
},
"authorizationCode": "4b418674-0fbd-4363-a2e0-ae545f68cb95",
"transactionType": {
"code": "00",
"description": "Purchase"
},
"wallet": {
"code": "111",
"name": "Unknown"
},
"retrievalReferenceNumber": "4b418674-0fbd-4363-a2e0-ae545f68cb95",
"merchant": {
"mcc": "5311",
"mcg": "Department",
"city": "Luxemburg ",
"stateOrCountryCode": "USA",
"state": "",
"name": "TESTE",
"zipCode": "",
"terminalId": "62683744",
"acquirerCode": "7133380"
},
"numberOfInstallments": 1,
"processingCode": "003100",
"passwordPresent": true,
"mti": "0100",
"preAuthorization": false,
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "647ef3fe-82a0-4b88-8103-aebf70b24832",
"card": {
"programId": "31",
"proxy": "2307171003721696184",
"fourLastDigits": "4237",
"alias": "Novo",
"function": "Pre",
"type": "Physical"
}
}
}
NETWORK_VALIDATION_WAS_PROCESSED
Este evento sinaliza que o resultado da validação acatado pela rede de cartões foi processado, indicando a aprovação ou reprovação da transação de débito pela bandeira.
Descrição do objeto data do evento
data do eventoO objeto data traz detalhes específicos do contexto em que o evento ocorre. Neste caso, o objeto trará os campos de acordo com a tabela:
| Nome | Tipo | Descrição |
|---|---|---|
account | object | Objeto que contém informações sobre a conta bancária. |
account.branch | string | Número da agência bancária. |
account.number | string | Número da conta. |
account.bank | object | Objeto que contém informações sobre o banco ao qual a conta pertence. |
account.bank.ispb | string | ISPB (Identificador de Sistema de Pagamentos Brasileiro) do banco. |
account.bank.code | string | Código do banco. |
account.bank.name | string | Nome do banco. |
amount | object | Objeto que contém informações sobre o valor da transação. |
amount.value | number | Valor da transação. |
amount.currency | string | Código da moeda com base na ISO-4217. |
withoutFeeAmount | object | Objeto que contém informações sobre o valor da transação sem taxas. |
withoutFeeAmount.value | number | Valor da transação sem taxas. |
withoutFeeAmount.currency | string | Código da moeda com base na ISO-4217. |
iofAmount | object | Objeto que contém informações sobre o valor calculado do IOF da transação. |
iofAmount.value | number | Valor calculado do IOF da transação. |
iofAmount.currency | string | Código da moeda com base na ISO-4217. |
markupAmount | object | Objeto que contém informações sobre o valor calculado do markup da transação. |
markupAmount.value | number | Valor calculado do markup. |
markupAmount.currency | string | Código da moeda com base na ISO-4217. |
withdrawalFeeAmount | object | Objeto que contém informações sobre o valor da tarifa de saque (somente para transações de saque). |
withdrawalFeeAmount.value | number | Valor da tarifa de saque. |
withdrawalFeeAmount.currency | string | Código da moeda com base na ISO-4217. |
fees | object | Objeto que contém informações sobre as taxas aplicadas na transação. |
fees.markup | number | Percentual do markup. |
fees.iof | number | Percentual do IOF. |
fees.dollarExchangeRate | object | Objeto que contém informações sobre a cotação atual do dólar, em reais. |
fees.dollarExchangeRate.value | number | Cotação atual do dólar, em reais. |
fees.dollarExchangeRate.currency | string | Código da moeda com base na ISO-4217. |
deniedRules | array of strings | Motivos pelos quais a transação foi negada. |
status | string | Situação da transação, a qual pode ser “SUCCESS” ou “DENIED”. |
transactionTimeStamp | string | Data e a hora em que ocorreu a transação, no formato ISO 8601 - UTC. |
channel | object | Objeto que contém informações sobre o canal por onde passam os dados recebidos da rede de cartões. |
channel.settlement | object | Objeto que contém informações sobre o valor da transação sem taxas. |
channel.settlement.value | number | Valor da transação sem taxas. |
channel.settlement.currency | string | Código da moeda com base na ISO-4217. |
channel.localAmount | object | Objeto que contém informações sobre o valor da transação sem taxas. |
channel.localAmount.value | number | Valor da transação sem taxas. |
channel.localAmount.currency | string | Código da moeda local com base na ISO-4217. |
channel.entryMode | object | Objeto que contém informações sobre o modo de entrada do cartão. |
channel.entryMode.code | string | Código do modo de entrada de acordo com a ISO-8583. |
channel.entryMode.description | string | Descrição do modo de entrada. |
channel.entryMode.cardPresent | boolean | Indica se este modo de entrada está presente no cartão. |
channel.authorizationCode | string | Identificador da transação da rede do cartão. |
channel.transactionType | object | Objeto que contém informações sobre o tipo da transação de acordo com a ISO-8583. |
channel.transactionType.code | string | Código da transação, o qual pode ser: “00”, “01”, ou “20”. |
channel.transactionType.description | string | Descrição do código, a qual pode ser “purchase” para “00”, “withdraw” para “01” ou “voucher” para “20”. |
channel.wallet | object | Objeto que contém informações sobre a carteira utilizada na transação. |
channel.wallet.code | string | Código da carteira. |
channel.wallet.name | string | Nome da carteira. |
channel.retrievalReferenceNumber | string | Identificador de transação da rede do cartão. |
channel.merchant | object | Objeto que contém informações referentes ao estabelecimento/comerciante que aceitou a transação. Seus campos são baseados na ISO-8583. |
channel.merchant.mcc | string | Código mcc da transação. |
channel.merchant.mcg | string | Descrição do tipo do mcc. |
channel.merchant.city | string | Cidade do merchant para identificar parte de sua localização. |
channel.merchant.stateOrCountryCode | string | Código do estado ou do país do merchant para identificar parte da sua localização. |
channel.merchant.state | string | Estado do merchant para identificar parte de sua localização. |
channel.merchant.name | string | Nome do merchant. |
channel.merchant.zipCode | string | Código postal do merchant. |
channel.merchant.terminalId | string | Identificador do terminal do merchant. |
channel.merchant.acquirerCode | string | Código do credenciador. |
channel.numberOfInstallments | number | Quantidade de parcelas da transação. |
channel.mti | string | MTI (Message Type Indicator), código que identifica o tipo da transação. |
channel.processingCode | string | Identificador que indica o tipo de transação, o tipo de conta remetente e tipo de conta destinatária. |
channel.passwordPresent | boolean | Indica se a senha do cartão foi informada na autorização. |
channel.preAuthorization | boolean | Em caso de pré-autorização, esse campo retornará TRUE. Caso contrário, FALSE. |
authorizationId | number | Identificador da autorização da processadora. |
channel.name | string | Nome do canal que iniciou a transação no banco. No contexto do autorizador, o canal será sempre “CARD_NETWORK”. |
authorizationTransactionId | string | Identificador da transação gerado pela plataforma de autorização do Bankly. |
card | object | Objeto que contém informações sobre o cartão utilizado na transação. |
card.proxy | string | Código identificador do cartão. |
card.alias | string | Apelido definido pelo proprietário do cartão. |
card.function | string | Função do cartão, a qual pode ser “Pre”, “Pos”, “Debit”. |
card.type | string | Tipo do cartão, o qual pode ser “Physical” ou “Virtual”. |
card.programId | string | Identificador do programa ao qual o cartão pertence. |
card.fourLastDigits | string | Quatro últimos dígitos do cartão. |
antiFraudValidationResults[] | array of objects | Lista de objetos com informações sobre a validação antifraude da transação negada. Importante: essa lista será preenchida apenas se a transação for negada e o campo DeniedRules contiver os valores “ANTI_FRAUD_VALIDATION” e/ou “BLOCKED_BY_RISK_ANALYSIS”. |
antiFraudValidationResults[].groupCode | string | Código do grupo de regra em que a transação negada foi classificada. |
antiFraudValidationResults[].processRecommendationCode | string | Orientações sobre como atender ao cliente em caso de contato, incluindo uma estimativa do tempo necessário para a liberação do uso da solução de bypass. |
Payload do evento
O payload abaixo exemplifica a estrutura do evento que deverá ser recebido pelo parceiro. Clique na seta para expandi-lo:
Exemplo de payload
[
{
"entityId": "64ceeb22-7dac-4ab4-994c-a6a8e057ea5d",
"companyKey": "ACESSO",
"name": "NETWORK_VALIDATION_WAS_PROCESSED",
"timestamp": "2024-10-15T18:51:31.0541347Z",
"correlationId": "9d456a0a-5403-4cb2-85c0-162e3c2243ac",
"data": {
"amount": {
"value": 10.0,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 10.0,
"currency": "BRL"
},
"deniedRules": [
"BLOCKED_BY_RISK_ANALYSIS"
],
"status": "DENIED",
"transactionTimeStamp": "2024-10-15T18:51:31.0550146Z",
"channel": {
"settlement": {
"value": 10.0,
"currency": "USD"
},
"localAmount": {
"value": 10.0,
"currency": "BRL"
},
"entryMode": {
"code": "05",
"description": "PAN auto-entry via chip",
"cardPresent": true
},
"authorizationCode": "2222d5a3-90c3-4e7d-929b-8de111111111",
"transactionType": {
"code": "00",
"description": "Purchase"
},
"wallet": {
"code": "0",
"name": "Unknown"
},
"retrievalReferenceNumber": "2222d5a3-90c3-4e7d-929b-8de111111111",
"merchant": {
"mcc": "5411",
"mcg": "Supermarkets",
"city": "FORTALEZA ",
"stateOrCountryCode": "BRA",
"state": "",
"name": "SUPER FRANGOLANDIA ",
"zipCode": "60335198 ",
"terminalId": "TM000018",
"acquirerCode": "998653214"
},
"numberOfInstallments": 1,
"processingCode": "000000",
"passwordPresent": false,
"mti": "0200",
"preAuthorization": false,
"name": "CARD_NETWORK"
},
"antiFraudValidationResults": [
{
"groupCode": "CARD_001",
"processRecommendationCode": "CARD_PROCESS_001"
}
],
"authorizationTransactionId": "64ceeb22-7dac-4ab4-994c-a6a8e057ea5d",
"card": {
"programId": "130",
"proxy": "2500761000004494174",
"fourLastDigits": "8182",
"alias": "Teste LucasC",
"function": "Debit",
"type": "Physical"
},
"account": {
"branch": "0001",
"number": "233099",
"bank": {
"ispb": "13140088",
"code": "332",
"name": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO"
}
}
},
"context": "Authorization",
"idempotencyKey": "9d456a0a-5403-4cb2-85c0-162e3c2243ac"
}
]
TRANSACTION_WAS_REVERTED
Este evento sinaliza que a transação foi revertida parcial ou totalmente.
Descrição do objeto data do evento
data do eventoO objeto data traz detalhes específicos do contexto em que o evento ocorre. Neste caso, o objeto trará os campos de acordo com a tabela:
| Nome | Tipo | Descrição |
|---|---|---|
account | object | Objeto que contém informações sobre a conta bancária. |
account.branch | string | Número da agência bancária. |
account.number | string | Número da conta. |
account.bank | object | Objeto que contém informações sobre o banco ao qual a conta pertence. |
account.bank.ispb | string | ISPB (Identificador de Sistema de Pagamentos Brasileiro) do banco. |
account.bank.code | string | Código do banco. |
account.bank.name | string | Nome do banco. |
amount | object | Objeto que contém informações sobre o valor da transação. |
amount.value | number | Valor da transação. |
amount.currency | string | Código da moeda com base na ISO-4217. |
withoutFeeAmount | object | Objeto que contém informações sobre o valor da transação sem taxas. |
withoutFeeAmount.value | number | Valor da transação sem taxas. |
withoutFeeAmount.currency | string | Código da moeda com base na ISO-4217. |
iofAmount | object | Objeto que contém informações sobre o valor calculado do IOF da transação. |
iofAmount.value | number | Valor calculado do IOF da transação. |
iofAmount.currency | string | Código da moeda com base na ISO-4217. |
markupAmount | object | Objeto que contém informações sobre o valor calculado do markup da transação. |
markupAmount.value | number | Valor calculado do markup. |
markupAmount.currency | string | Código da moeda com base na ISO-4217. |
withdrawalFeeAmount | object | Objeto que contém informações sobre o valor da tarifa de saque (somente para transações de saque). |
withdrawalFeeAmount.value | number | Valor da tarifa de saque. |
withdrawalFeeAmount.currency | string | Código da moeda com base na ISO-4217. |
dollarExchangeRate | object | Objeto que contém informações sobre a cotação atual do dólar, em reais. |
dollarExchangeRate.value | number | Cotação atual do dólar, em reais. |
dollarExchangeRate.currency | string | Código da moeda local com base na ISO-4217. |
reversalReason | number | Motivo da reversão da transação. Exemplo: “SystemFault”, “PosRequest”, “DebitReversal”. |
channel | object | Objeto que contém informações sobre o canal por onde passam os dados recebidos da rede de cartões. |
channel.settlement | object | Objeto que contém informações sobre o valor da transação sem taxas. |
channel.settlement.value | number | Valor da transação sem taxas. |
channel.settlement.currency | string | Código da moeda com base na ISO-4217. |
channel.localAmount | object | Objeto que contém informações sobre o valor da transação sem taxas. |
channel.localAmount.value | number | Valor da transação sem taxas. |
channel.localAmount.currency | string | Código da moeda local com base na ISO-4217. |
channel.name | string | Nome do canal que iniciou a transação no banco. No contexto do autorizador, o canal será sempre “CARD_NETWORK”. |
channel.mti | string | MTI (Message Type Indicator), código que identifica o tipo da transação. |
channel.processingCode | string | Identificador que indica o tipo de transação, o tipo de conta remetente e tipo de conta destinatária. |
authorizationTransactionId | string | Identificador da transação gerado pela plataforma de autorização do Bankly. |
card | object | Objeto que contém informações sobre o cartão utilizado na transação. |
card.proxy | string | Código identificador do cartão. |
card.alias | string | Apelido definido pelo proprietário do cartão. |
card.function | string | Função do cartão, a qual pode ser: “Pre”, “Pos”, “Debit”. |
card.fourLastDigits | string | Quatro últimos dígitos do cartão. |
card.type | string | Tipo do cartão, o qual pode ser: “Physical” ou “Virtual”. |
Nota
Por meio do
entityIddo evento o parceiro consegue identificar a transação que foi revertida.
Payload do evento
O payload abaixo exemplifica a estrutura do evento que deverá ser recebido pelo parceiro. Clique na seta para expandi-lo:
Exemplos de payloads
{
"entityId": "30409c8e-7171-454d-a914-d893b4c12489",
"companyKey": "COMPANY_KEY",
"name": "TRANSACTION_WAS_REVERTED",
"timestamp": "2024-02-14T15:10:47.1125195Z",
"correlationId": "93c72a03-5954-449d-b40a-d438a662963d",
"$schema": : "Authorization",
"idempotencyKey": "93c72a03-5954-449d-b40a-d438a662963d",
"data": {
"account": {
"branch": "0001",
"number": "15164",
"bank": {
"ispb": "13140088",
"code": "332",
"name": "Acesso Soluções De Pagamento S.A."
}
},
"amount": {
"value": 17,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 17,
"currency": "BRL"
},
"reversalReason": "DebitReversal",
"channel": {
"settlement": {
"value": 6,
"currency": "USD"
},
"localAmount": {
"value": 6,
"currency": "BRL"
},
"mti": "0420",
"processingCode": "000000",
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "30409c8e-7171-454d-a914-d893b4c12489",
"card": {
"proxy": "0000000000000000000",
"fourLastDigits": "2817",
"alias": "Debito",
"function": "Debit"
}
}
}
{
"entityId": "cbe35d61-78d3-40d0-878d-bf47b0862acd",
"companyKey": "",
"name": "TRANSACTION_WAS_REVERTED",
"timestamp": "2024-03-26T20:03:47.5885398Z",
"correlationId": "67293c59-d42e-459d-9121-e7a0d091cbd6",
"context": "Authorization",
"idempotencyKey": "67293c59-d42e-459d-9121-e7a0d091cbd6",
"data": {
"account": {
"number": "15164",
"bank": {
"ispb": "13140088",
"code": "332",
"name": "Acesso Soluções De Pagamento S.A."
}
},
"amount": {
"value": 4,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 4,
"currency": "BRL"
},
"reversalReason": "PosRequest",
"channel": {
"settlement": {
"value": 4,
"currency": "USD"
},
"localAmount": {
"value": 4,
"currency": "USD"
},
"mti": "0420",
"processingCode": "003100",
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "cbe35d61-78d3-40d0-878d-bf47b0862acd",
"card": {
"proxy": "",
"fourLastDigits": "",
"alias": "",
"function": "Debit"
}
}
}
{
"entityId": "781d7c95-d753-4e5b-8f2d-8da64ef6ea5b",
"companyKey": "ACESSO",
"name": "TRANSACTION_WAS_REVERTED",
"timestamp": "2024-03-27T19:15:23.3118399Z",
"correlationId": "6dd61028-d3c9-459e-86c3-0c716d2fdeb9",
"context": "Authorization",
"idempotencyKey": "6dd61028-d3c9-459e-86c3-0c716d2fdeb9",
"data": {
"account": {
"branch": "0001",
"number": "15164",
"bank": {
"ispb": "13140088",
"code": "332",
"name": "Acesso Soluções De Pagamento S.A."
}
},
"amount": {
"value": 1,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 1,
"currency": "BRL"
},
"reversalReason": "SystemFault",
"channel": {
"settlement": {
"value": 1,
"currency": "BRL"
},
"localAmount": {
"value": 1,
"currency": "BRL"
},
"mti": "0120",
"processingCode": "003000",
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "781d7c95-d753-4e5b-8f2d-8da64ef6ea5b",
"card": {
"proxy": "2229141001432904325",
"fourLastDigits": "1647",
"alias": "Teste",
"function": "Pos"
}
}
}
{
"entityId": "dba95aa4-8044-43ef-8218-2172378e52f6",
"companyKey": "ACESSO",
"name": "TRANSACTION_WAS_REVERTED",
"timestamp": "2024-03-27T21:19:18.1532688Z",
"correlationId": "dba95aa4-8044-43ef-8218-2172378e52f6",
"context": "Authorization",
"idempotencyKey": "dba95aa4-8044-43ef-8218-2172378e52f6",
"data": {
"account": {
"branch": "0001",
"number": "15164",
"bank": {
"ispb": "13140088",
"code": "332",
"name": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO"
}
},
"amount": {
"value": 2,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 2,
"currency": "BRL"
},
"reversalReason": "PosRequest",
"channel": {
"settlement": {
"value": 2,
"currency": "USD"
},
"localAmount": {
"value": 2,
"currency": "BRL"
},
"mti": "0400",
"processingCode": "003100",
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "dba95aa4-8044-43ef-8218-2172378e52f6",
"card": {
"proxy": "2307171003721696184",
"fourLastDigits": "4237",
"alias": "Novo",
"function": "Pre"
}
}
}
{
"entityId": "781d7c95-d753-4e5b-8f2d-8da64ef6ea5b",
"companyKey": "ACESSO",
"name": "TRANSACTION_WAS_REVERTED",
"timestamp": "2024-03-27T16:12:29.3121489Z",
"correlationId": "f2c524e6-1a7c-4926-9798-9226fa075bce",
"context": "Authorization",
"idempotencyKey": "f2c524e6-1a7c-4926-9798-9226fa075bce",
"data": {
"account": {
"branch": "0001",
"number": "15164",
"bank": {
"ispb": "13140088",
"code": "332",
"name": "Acesso Soluções De Pagamento S.A."
}
},
"amount": {
"value": 1,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 1,
"currency": "BRL"
},
"iofAmount": {
"value": 3,
"currency": "BRL"
},
"markupAmount": {
"value": 0,
"currency": "BRL"
},
"dollarExchangeRate": {
"value": 11.8312,
"currency": "BRL"
},
"reversalReason": "SystemFault",
"channel": {
"settlement": {
"value": 1,
"currency": "USD"
},
"localAmount": {
"value": 1,
"currency": "USD"
},
"mti": "0120",
"processingCode": "003000",
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "781d7c95-d753-4e5b-8f2d-8da64ef6ea5b",
"card": {
"proxy": "2229141001432904325",
"fourLastDigits": "1647",
"alias": "Teste Marcelo",
"function": "Pos"
}
}
}
{
"entityId": "337395bc-8356-411f-9f4b-c628f7cf35d0",
"companyKey": "ACESSO",
"name": "TRANSACTION_WAS_REVERTED",
"timestamp": "2024-03-27T20:38:57.4432474Z",
"correlationId": "337395bc-8356-411f-9f4b-c628f7cf35d0",
"context": "Authorization",
"idempotencyKey": "337395bc-8356-411f-9f4b-c628f7cf35d0",
"data": {
"account": {
"branch": "0001",
"number": "15164",
"bank": {
"ispb": "13140088",
"code": "332",
"name": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO"
}
},
"amount": {
"value": 10.9,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 9.96,
"currency": "BRL"
},
"iofAmount": {
"value": 0.44,
"currency": "BRL"
},
"markupAmount": {
"value": 0.5,
"currency": "BRL"
},
"dollarExchangeRate": {
"value": 4.9798,
"currency": "BRL"
},
"reversalReason": "PosRequest",
"channel": {
"settlement": {
"value": 2,
"currency": "USD"
},
"localAmount": {
"value": 2,
"currency": "USD"
},
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "337395bc-8356-411f-9f4b-c628f7cf35d0",
"card": {
"proxy": "2307171003721696184",
"alias": "Novo",
"function": "Pre"
}
}
}
TRANSACTION_WAS_EXPIRED
Este evento sinaliza que o tempo de reserva de saldo da transação expirou e a transação foi revertida. Esse fluxo ocorre em transações pré-pagas.
Descrição do objeto data do evento
data do eventoO objeto data traz detalhes específicos do contexto em que o evento ocorre. Neste caso, o objeto trará os campos de acordo com a tabela:
| Nome | Tipo | Descrição |
|---|---|---|
authorizationTransactionId | string | Identificador da transação gerado pela plataforma de autorização do Bankly. |
card | object | Objeto que contém informações sobre o cartão utilizado na transação. |
card.proxy | string | Código identificador do cartão. |
card.alias | string | Apelido definido pelo proprietário do cartão. |
card.function | string | Função do cartão, a qual pode ser: “Pre”, “Pos”, “Debit”. |
card.type | string | Tipo do cartão, o qual pode ser: “Physical” ou “Virtual”. |
account | object | Objeto que contém os dados da conta e da licença bancária. |
account.branch | string | Número da agência bancária. |
account.number | string | Número da conta. |
account.bank | object | Objeto que contém os dados bancários. |
account.bank.ispb | string | ISPB (Identificador de Sistema de Pagamentos Brasileiro) do banco. |
account.bank.code | string | Código do banco. |
account.bank.name | string | Nome do banco. |
Payload do evento
O payload abaixo exemplifica a estrutura do evento que deverá ser recebido pelo parceiro. Clique na seta para expandi-lo:
Exemplo de payload
{
"entityId": "a1349dde-817a-4913-91d0-84fa2d787755",
"companyKey": "COMPANY_KEY",
"name": "TRANSACTION_WAS_EXPIRED",
"timestamp": "2022-04-25T12:00:02.2180183Z",
"correlationId": "9b76feea-98a0-4001-b2bf-ab83ae57adce",
"context": "Authorization",
"idempotencyKey": "9b76feea-98a0-4001-b2bf-ab83ae57adce",
"metadata": null,
"data": {
"authorizationTransactionId": "a1349dde-817a-4913-91d0-84fa2d787755",
"card": {
"proxy": "0000000000000000000",
"alias": "0921",
"function": "Pre",
"type": null
},
"account": {
"branch": "0001",
"number": "15164",
"bank": {
"ispb": "13140088",
"code": "332",
"name": "Acesso Soluções De Pagamento S.A."
}
},
}
}
CONFIRMATION_WAS_PROCESSED
Este evento sinaliza que a transação foi confirmada parcial ou totalmente.
Descrição do objeto data do evento
data do eventoO objeto data traz detalhes específicos do contexto em que o evento ocorre. Neste caso, o objeto trará os campos de acordo com a tabela:
| Nome | Tipo | Descrição |
|---|---|---|
account | object | Objeto que contém os dados da conta e da licença bancária. |
account.branch | string | Número da agência bancária. |
account.number | string | Número da conta. |
account.bank | object | Objeto que contém os dados bancários. |
account.bank.ispb | string | ISPB (Identificador de Sistema de Pagamentos Brasileiro) do banco. |
account.bank.code | string | Código do banco. |
account.bank.name | string | Nome do banco. |
amount | object | Objeto que contém informações sobre o valor da transação. |
amount.value | number | Valor da transação. |
amount.currency | string | Código da moeda com base na ISO-4217. |
withoutFeeAmount | object | Objeto que contém informações sobre o valor da transação sem taxas. |
withoutFeeAmount.value | number | Valor da transação sem taxas. |
withoutFeeAmount.currency | string | Código da moeda com base na ISO-4217. |
iofAmount | object | Objeto que contém informações sobre o valor calculado do IOF da transação. |
iofAmount.value | number | Valor calculado do IOF da transação. |
iofAmount.currency | string | Código da moeda com base na ISO-4217. |
markupAmount | object | Objeto que contém informações sobre o valor calculado do markup da transação. |
markupAmount.value | number | Valor calculado do markup. |
markupAmount.currency | string | Código da moeda com base na ISO-4217. |
withdrawalFeeAmount | object | Objeto que contém informações sobre o valor da tarifa de saque (somente para transações de saque). |
withdrawalFeeAmount.value | number | Valor da tarifa de saque. |
withdrawalFeeAmount.currency | string | Código da moeda com base na ISO-4217. |
channel | object | Objeto que contém informações sobre o canal por onde passam os dados recebidos da rede de cartões. |
channel.transactionType | object | Objeto que contém informações sobre o tipo da transação de acordo com a ISO-8583. |
channel.transactionType.code | string | Código da transação, o qual pode ser: “00”, “01”, ou “20”. |
channel.transactionType.description | string | Descrição do código, a qual pode ser “purchase” para “00”, “withdraw” para “01” ou “voucher” para “20”. |
channel.numberOfInstallments | number | Quantidade de parcelas da transação. |
channel.settlement | object | Objeto que contém informações sobre o valor da transação sem taxas. |
channel.settlement.value | number | Valor da transação sem taxas. |
channel.settlement.currency | string | Código da moeda com base na ISO-4217. |
channel.localAmount | object | Objeto que contém informações sobre o valor da transação sem taxas. |
channel.localAmount.value | number | Valor da transação sem taxas. |
channel.localAmount.currency | string | Código da moeda local com base na ISO-4217. |
channel.merchant | object | Objeto que contém informações referentes ao estabelecimento/comerciante que aceitou a transação. Seus campos são baseados na ISO-8583. |
channel.merchant.mcc | string | Código mcc da transação. |
channel.merchant.mcg | string | Descrição do tipo do mcc. |
channel.merchant.city | string | Cidade do merchant para identificar parte de sua localização. |
channel.merchant.stateOrCountryCode | string | Código do estado ou do país do merchant para identificar parte da sua localização. |
channel.merchant.state | string | Estado do merchant para identificar parte de sua localização. |
channel.merchant.name | string | Nome do merchant. |
channel.merchant.zipCode | string | Código postal do merchant. |
channel.merchant.terminalId | string | Identificador do terminal do merchant. |
channel.merchant.acquirerCode | string | Código do credenciador. |
channel.merchant.id | string | Identificador do merchant. |
channel.name | string | Nome do canal que iniciou a transação no banco. No contexto do autorizador, o canal será sempre “CARD_NETWORK”. |
channel.mti | string | MTI (Message Type Indicator), código que identifica o tipo da transação. |
channel.processingCode | string | Identificador que indica o tipo de transação, o tipo de conta remetente e tipo de conta destinatária. |
channel.preAuthorization | boolean | Em caso de pré-autorização, esse campo retornará TRUE. Caso contrário, FALSE. |
channel.responseCode | String | Código de resposta da bandeira. |
channel.authorizationId | Int64 | Código de autorização da processadora. Importante: este campo somente é retornado em caso de transação de crédito pós pago. |
channel.transactionTimeStamp | String | Data e hora em que ocorreu a transação, no formato ISO 8601 - UTC. |
channel.passwordPresent | boolean | Indica se a senha do cartão foi informada na autorização. |
fees | object | Objeto que contém informações sobre as taxas aplicadas na transação. |
fees.markup | number | Percentual do markup. |
fees.iof | number | Percentual do IOF. |
fees.dollarExchangeRate | object | Objeto que contém informações sobre a cotação atual do dólar, em reais. |
fees.dollarExchangeRate.value | number | Cotação atual do dólar, em reais. |
fees.dollarExchangeRate.currency | string | Código da moeda local com base na ISO-4217. |
authorizationTransactionId | string | Identificador da transação gerado pela plataforma de autorização do Bankly. |
card | object | Objeto que contém informações sobre o cartão utilizado na transação. |
card.proxy | string | Código identificador do cartão. |
card.alias | string | Apelido definido pelo proprietário do cartão. |
card.function | string | Função do cartão, a qual pode ser: “Pre”, “Pos”, “Debit”. |
card.type | string | Tipo do cartão, o qual pode ser: “Physical” ou “Virtual”. |
card.fourLastDigits | string | Quatro últimos dígitos do cartão. |
clearingDate | string | Data de confirmação processada pela plataforma de autorização do Bankly, no formato ISO 8601 - UTC. |
Nota
Para identificar se a transação descrita no evento se trata de uma entrada (cash-in) ou saída (cash-out) de dinheiro, consulte o campo
channel.transactionType.description.
Payload do evento
O payload abaixo exemplifica a estrutura do evento que deverá ser recebido pelo parceiro. Clique na seta para expandi-lo:
Exemplos de payloads
{
"entityId": "5e12371f-8836-4989-a9cb-956de5c8286d",
"companyKey": "ACESSO",
"name": "CONFIRMATION_WAS_PROCESSED",
"timestamp": "2024-07-25T13:22:41.3153383Z",
"correlationId": "c22fb067-6de2-4d62-a997-6f859877fba9",
"idempotencyKey": "c22fb067-6de2-4d62-a997-6f859877fba9",
"context": "Authorization",
"data": {
"amount": {
"value": 32.0,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 75.94,
"currency": "BRL"
},
"iofAmount": {
"value": 0.0,
"currency": "BRL"
},
"markupAmount": {
"value": 0.0,
"currency": "BRL"
},
"withdrawalFeeAmount": {
"value": 0.0,
"currency": "BRL"
},
"account": {
"branch": "0001",
"number": "233099",
"bank": {
"ispb": "13140088",
"code": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO",
"name": "332"
}
},
"channel": {
"numberOfInstallments": 1,
"settlement": {
"value": 5.92,
"currency": "USD"
},
"localAmount": {
"value": 32.0,
"currency": "BRL"
},
"preAuthorization": false,
"passwordPresent": true,
"mti": "0200",
"processingCode": "000000",
"responseCode": "00",
"transactionTimestamp": "2024-04-06T20:31:54Z",
"merchant": {
"mcc": "5411",
"mcg": "Supermarkets",
"city": "TESTE ",
"stateOrCountryCode": "PRY",
"state": "PRY",
"name": "EDITORA NÍSIA FLORESTA",
"zipCode": "6338500000",
"terminalId": "POS62627",
"acquirerCode": "1960021912",
"id": "000062627"
},
"transactionType": {
"code": "00",
"description": "Purchase"
},
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "5e12371f-8836-4989-a9cb-956de5c8286d",
"card": {
"proxy": "2500761000004494174",
"alias": "Apelido",
"function": "Debit",
"type": "Physical",
"fourLastDigits": "8182"
},
"clearingDate": "2024-07-25T13:22:41.3148817Z"
}
}
{
"entityId": "5428c3da-ee76-4fdc-8987-06321219a765",
"companyKey": "MELIUZ_DABACURI",
"name": "CONFIRMATION_WAS_PROCESSED",
"timestamp": "2024-04-18T08:43:13.0410956Z",
"correlationId": "5428c3da-ee76-4fdc-8987-06321219a765",
"idempotencyKey": "5428c3da-ee76-4fdc-8987-06321219a765",
"context": "Authorization",
"data": {
"amount": {
"value": 1,
"currency": "USD"
},
"withoutFeeAmount": {
"value": 1,
"currency": "USD"
},
"iofAmount": {
"value": 3,
"currency": "USD"
},
"markupAmount": {
"value": 0,
"currency": "USD"
},
"withdrawalFeeAmount": {
"value": 0,
"currency": "USD"
},
"account": {
"branch": "0001",
"number": "441977715",
"bank": {
"ispb": "13140088",
"code": "332",
"name": "Acesso Soluções De Pagamento S.A."
}
},
"authorizationTransactionId": "5428c3da-ee76-4fdc-8987-06321219a765",
"channel": {
"transactionType": {
"code": "00",
"description": "Purchase"
},
"numberOfInstallments": 1,
"settlement": {
"value": 1,
"currency": "USD"
},
"localAmount": {
"value": 1,
"currency": "USD"
},
"merchant": {
"mcc": "5411",
"mcg": "Supermarkets",
"city": "FORTALEZA ",
"stateOrCountryCode": "BRA",
"state": "",
"name": "EDITORA NÍSIA FLORESTA",
"zipCode": "",
"terminalId": "TM000018",
"acquirerCode": "998653213",
"id": "8756"
},
"preAuthorization": false,
"passwordPresent": false,
"mti": "0200",
"processingCode": "000000",
"responseCode": "00",
"AuthorizationId": 9854547,
"transactionTimeStamp": "2022-11-09T21:42:02",
"name": "CARD_NETWORK"
},
"fees": {
"markup": 0,
"iof": 0.05,
"dollarExchangeRate": {
"value": 11.8312,
"currency": "USD"
}
},
"card": {
"proxy": "2340281000070698438",
"alias": "Card Physic Pos",
"function": "Pos",
"type": "Physical",
"fourLastDigits": "8313"
},
"clearingDate": "2024-04-18T08:43:13.0410136Z"
}
}
{
"entityId": "afa76a53-e26e-463e-ac86-4fdfdce44c5f",
"companyKey": "ACESSO",
"name": "CONFIRMATION_WAS_PROCESSED",
"timestamp": "2024-07-25T19:34:04.8835543Z",
"correlationId": "afa76a53-e26e-463e-ac86-4fdfdce44c5f",
"idempotencyKey": "afa76a53-e26e-463e-ac86-4fdfdce44c5f",
"context": "Authorization",
"data": {
"amount": {
"value": 20.0,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 20.0,
"currency": "BRL"
},
"iofAmount": {
"value": 3.0,
"currency": "BRL"
},
"markupAmount": {
"value": 0.0,
"currency": "BRL"
},
"channel": {
"numberOfInstallments": 3,
"settlement": {
"value": 20.0,
"currency": "USD"
},
"localAmount": {
"value": 20.0,
"currency": "BRL"
},
"preAuthorization": true,
"passwordPresent": true,
"mti": "1240",
"processingCode": "013100",
"responseCode": "00",
"authorizationId": 4655646549359358,
"transactionTimestamp": "2024-07-25T19:34:04.662Z",
"merchant": {
"mcc": "5199",
"mcg": "Food",
"city": "Sao Paulo",
"stateOrCountryCode": "BRA",
"state": "BRA",
"name": "EDITORA NÍSIA FLORESTA",
"id": "12314"
},
"transactionType": {
"code": "01",
"description": "Withdrawal"
},
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "afa76a53-e26e-463e-ac86-4fdfdce44c5f",
"card": {
"proxy": "2307271002878379965",
"alias": "stg",
"function": "Pos",
"type": "Physical",
"fourLastDigits": "5046"
},
"clearingDate": "2024-07-25T19:34:04.873388Z"
}
}
{
"entityId": "6c68a8b3-420f-473b-b702-74b5eae44c7d",
"companyKey": "ACESSO",
"name": "CONFIRMATION_WAS_PROCESSED",
"timestamp": "2024-07-25T19:56:15.9603528Z",
"correlationId": "62ee7cde-fbce-41b2-a291-ce055e9d3dad",
"idempotencyKey": "62ee7cde-fbce-41b2-a291-ce055e9d3dad",
"context": "Authorization",
"data": {
"amount": {
"value": 2.0,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 2.0,
"currency": "BRL"
},
"iofAmount": {
"value": 0.0,
"currency": "BRL"
},
"markupAmount": {
"value": 0.0,
"currency": "BRL"
},
"withdrawalFeeAmount": {
"value": 0.0,
"currency": "BRL"
},
"account": {
"branch": "0001",
"number": "1155",
"bank": {
"ispb": "13140088",
"code": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO",
"name": "332"
}
},
"channel": {
"numberOfInstallments": 1,
"settlement": {
"value": 2.0,
"currency": "USD"
},
"localAmount": {
"value": 2.0,
"currency": "BRL"
},
"preAuthorization": false,
"passwordPresent": true,
"mti": "0100",
"processingCode": "002000",
"responseCode": "00",
"transactionTimestamp": "2024-07-25T19:55:12.175Z",
"merchant": {
"mcc": "5311",
"mcg": "Department",
"city": "Luxemburg ",
"stateOrCountryCode": "BRA",
"state": "BRA",
"name": "EDITORA NÍSIA FLORESTA",
"zipCode": "1528 ",
"terminalId": "62683744",
"acquirerCode": "548104",
"id": "63215248"
},
"transactionType": {
"code": "00",
"description": "Purchase"
},
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "6c68a8b3-420f-473b-b702-74b5eae44c7d",
"card": {
"proxy": "2228981000002700744",
"alias": "BIN Oito Digitos",
"function": "Pre",
"type": "Physical",
"fourLastDigits": "8549"
},
"clearingDate": "2024-07-25T19:56:15.9602228Z"
}
}
{
"entityId": "8b030ae9-f66f-4ba3-b9fd-cbdea5b831b0",
"companyKey": "ACESSO",
"name": "CONFIRMATION_WAS_PROCESSED",
"timestamp": "2024-07-25T19:44:43.947185Z",
"correlationId": "8b030ae9-f66f-4ba3-b9fd-cbdea5b831b0",
"idempotencyKey": "8b030ae9-f66f-4ba3-b9fd-cbdea5b831b0",
"context": "Authorization",
"data": {
"amount": {
"value": 20.0,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 20.0,
"currency": "BRL"
},
"iofAmount": {
"value": 3.0,
"currency": "BRL"
},
"markupAmount": {
"value": 0.0,
"currency": "BRL"
},
"channel": {
"numberOfInstallments": 3,
"settlement": {
"value": 20.0,
"currency": "USD"
},
"localAmount": {
"value": 20.0,
"currency": "USD"
},
"preAuthorization": true,
"passwordPresent": true,
"mti": "1240",
"processingCode": "013100",
"responseCode": "00",
"authorizationId": 1697171469461702,
"transactionTimestamp": "2024-07-25T19:44:43.25Z",
"merchant": {
"mcc": "5199",
"mcg": "Food",
"city": "Sao Paulo",
"stateOrCountryCode": "USA",
"state": "USA",
"name": "EDITORA NÍSIA FLORESTA",
"id": "12314"
},
"transactionType": {
"code": "01",
"description": "Withdrawal"
},
"name": "CARD_NETWORK"
},
"fees": {
"markup": 0.05,
"iof": 0.05,
"dollarExchangeRate": {
"value": 11.8312,
"currency": "BRL"
}
},
"authorizationTransactionId": "8b030ae9-f66f-4ba3-b9fd-cbdea5b831b0",
"card": {
"proxy": "2307271002878379965",
"alias": "stg",
"function": "Pos",
"type": "Physical",
"fourLastDigits": "5046"
},
"clearingDate": "2024-07-25T19:44:43.9470769Z"
}
}
{
"entityId": "0ba9b0d3-b49c-4ead-926d-c59301cef2fc",
"companyKey": "ACESSO",
"name": "CONFIRMATION_WAS_PROCESSED",
"timestamp": "2024-07-25T21:22:05.5994689Z",
"correlationId": "941e60c4-238b-41d9-91d7-aeb906430f46",
"idempotencyKey": "941e60c4-238b-41d9-91d7-aeb906430f46",
"context": "Authorization",
"data": {
"amount": {
"value": 5.45,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 4.98,
"currency": "BRL"
},
"iofAmount": {
"value": 0.22,
"currency": "BRL"
},
"markupAmount": {
"value": 0.25,
"currency": "BRL"
},
"withdrawalFeeAmount": {
"value": 0.0,
"currency": "BRL"
},
"account": {
"branch": "0001",
"number": "1155",
"bank": {
"ispb": "13140088",
"code": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO",
"name": "332"
}
},
"channel": {
"numberOfInstallments": 1,
"settlement": {
"value": 1.0,
"currency": "USD"
},
"localAmount": {
"value": 1.0,
"currency": "USD"
},
"preAuthorization": false,
"passwordPresent": true,
"mti": "0100",
"processingCode": "002000",
"responseCode": "00",
"transactionTimestamp": "2024-07-25T21:19:35.635Z",
"merchant": {
"mcc": "5311",
"mcg": "Department",
"city": "Luxemburg ",
"stateOrCountryCode": "USA",
"state": "USA",
"name": "TESTE",
"zipCode": "1528 ",
"terminalId": "62683744",
"acquirerCode": "7133380",
"id": "63215248 "
},
"transactionType": {
"code": "00",
"description": "Purchase"
},
"name": "CARD_NETWORK"
},
"fees": {
"markup": 0.0502008032128514056224899598,
"iof": 0.0438,
"dollarExchangeRate": {
"value": 4.97981,
"currency": "BRL"
}
},
"authorizationTransactionId": "0ba9b0d3-b49c-4ead-926d-c59301cef2fc",
"card": {
"proxy": "2228981000002700744",
"alias": "BIN Oito Digitos",
"function": "Pre",
"type": "Physical",
"fourLastDigits": "8549"
},
"clearingDate": "2024-07-25T21:22:05.5992521Z"
}
}
CANCELATION_WAS_PROCESSED
Este evento sinaliza que a transação foi cancelada.
Descrição do objeto data do evento
data do eventoO objeto data traz detalhes específicos do contexto em que o evento ocorre. Neste caso, o objeto trará os campos de acordo com a tabela:
| Nome | Tipo | Descrição |
|---|---|---|
amount | object | Objeto que contém informações sobre o valor da transação. |
amount.value | string | Valor da transação. |
amount.currency | string | Código da moeda com base na ISO-4217. |
withoutFeeAmount | object | Objeto que contém informações sobre o valor da transação sem taxas. |
withoutFeeAmount.value | boolean | Valor da transação sem taxas. |
withoutFeeAmount.currency | boolean | Código da moeda com base na ISO-4217. |
iofAmount | object | Objeto que contém informações sobre o valor calculado do IOF da transação. |
iofAmount.value | number | Valor calculado do IOF da transação. |
IofAmount.currency | string | Código da moeda com base na ISO-4217. |
markupAmount | object | Objeto que contém informações sobre o valor calculado do markup da transação. |
markupAmount.value | number | Valor calculado do markup. |
markupAmount.currency | string | Código da moeda com base na ISO-4217. |
withdrawalFeeAmount | object | Objeto que contém informações sobre o valor da tarifa de saque (somente para transações de saque). |
withdrawalFeeAmount.value | number | Valor da tarifa de saque. |
withdrawalFeeAmount.currency | string | Código da moeda com base na ISO-4217. |
account | object | Objeto que contém os dados da conta e da licença bancária. |
account.branch | string | Número da agência bancária. |
account.number | string | Número da conta. |
account.bank | object | Objeto que contém os dados bancários. |
account.bank.ispb | string | ISPB (Identificador de Sistema de Pagamentos Brasileiro) do banco. |
account.bank.code | string | Código do banco. |
account.bank.name | string | Nome do banco. |
channel | object | Objeto que contém informações sobre o canal por onde passam os dados recebidos da rede de cartões. |
channel.settlement | object | Objeto que contém informações sobre o valor da transação sem taxas. |
channel.settlement.value | number | Valor da transação sem taxas. |
channel.settlement.currency | string | Código da moeda com base na ISO-4217. |
channel.localAmount | object | Objeto que contém informações sobre o valor da transação sem taxas. |
channel.localAmount.value | number | Valor da transação sem taxas. |
channel.localAmount.currency | string | Código da moeda local com base na ISO-4217. |
channel.transactionType | object | Objeto que contém informações sobre o tipo da transação de acordo com a ISO-8583. |
channel.transactionType.code | string | Código da transação, o qual pode ser: “00”, “01”, ou “20”. |
channel.transactionType.description | string | Descrição do código, a qual pode ser “purchase” para “00”, “withdraw” para “01” ou “voucher” para “20”. |
channel.merchant | object | Objeto que contém informações referentes ao estabelecimento/comerciante que aceitou a transação. Seus campos são baseados na ISO-8583. |
channel.merchant.mcc | string | Código mcc da transação. |
channel.merchant.mcg | string | Descrição do tipo do mcc. |
channel.merchant.city | string | Cidade do merchant para identificar parte de sua localização. |
channel.merchant.stateOrCountryCode | String | Código do estado ou do país do merchant para identificar parte da sua localização. |
channel.merchant.state | string | Estado do merchant para identificar parte de sua localização. |
channel.merchant.name | string | Nome do merchant. |
channel.merchant.zipCode | string | Código postal do merchant. |
channel.merchant.terminalId | string | Identificador do terminal do merchant. |
channel.merchant.acquirerCode | string | Código do credenciador. |
channel.merchant.id | string | Identificador do merchant. |
channel.name | string | Nome do canal que iniciou a transação no banco. No contexto do autorizador, o canal será sempre “CARD_NETWORK”. |
channel.numberOfInstallments | number | Quantidade de parcelas da transação. |
channel.mti | string | MTI (Message Type Indicator), código que identifica o tipo da transação. |
channel.processingCode | string | Identificador que indica o tipo de transação, o tipo de conta remetente e tipo de conta destinatária. |
channel.preAuthorization | boolean | Em caso de pré-autorização, esse campo retornará TRUE. Caso contrário, FALSE. |
channel.responseCode | string | Código de resposta da bandeira. |
channel.authorizationId | integer | Código de autorização da processadora. Importante: este campo somente é retornado em caso de transação de crédito pós pago. |
channel.transactionTimeStamp | string | Data e hora em que ocorreu a transação, no formato ISO 8601 - UTC. |
channel.passwordPresent | boolean | Indica se a senha do cartão foi informada na autorização. |
fees | object | Objeto que contém informações sobre as taxas aplicadas na transação. |
fees.markup | number | Percentual do markup. |
fees.iof | number | Percentual do IOF. |
fees.dollarExchangeRate | object | Objeto que contém informações sobre a cotação atual do dólar, em reais. |
fees.dollarExchangeRate.value | mumber | Cotação atual do dólar, em reais. |
fees.dollarExchangeRate.currency | string | Código da moeda local com base na ISO-4217. |
authorizationTransactionId | string | Identificador da transação gerado pela plataforma de autorização do Bankly. |
card | object | Objeto que contém informações sobre o cartão utilizado na transação. |
card.proxy | string | Código identificador do cartão. |
card.alias | string | Apelido definido pelo proprietário do cartão. |
card.function | string | Função do cartão, a qual pode ser: “Pre”, “Pos”, “Debit”. |
card.type | string | Tipo do cartão, o qual pode ser: “Physical” ou “Virtual”. |
card.fourLastDigits | string | Quatro últimos dígitos do cartão. |
clearingDate | string | Data de confirmação processada pela plataforma de autorização do Bankly, no formato ISO 8601 - UTC. |
Nota
Para identificar se a transação descrita no evento se trata de uma entrada (cash-in) ou saída (cash-out) de dinheiro, consulte o campo
channel.transactionType.description.
Payload do evento
O payload abaixo exemplifica a estrutura do evento que deverá ser recebido pelo parceiro. Clique na seta para expandi-lo:
Exemplos de payloads
{
"entityId": "f5003716-2a12-447c-930c-801fa2e86eaa",
"companyKey": "ACESSO",
"name": "CANCELATION_WAS_PROCESSED",
"timestamp": "2024-07-25T21:47:21.6757445Z",
"correlationId": "c22fb067-6de2-4d62-a997-6f859877fba9",
"idempotencyKey": "c22fb067-6de2-4d62-a997-6f859877fba9",
"context": "Authorization",
"data": {
"amount": {
"value": 38.9,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 75.94,
"currency": "BRL"
},
"iofAmount": {
"value": 0.0,
"currency": "BRL"
},
"withdrawalFeeAmount": {
"value": 6.9,
"currency": "BRL"
},
"account": {
"branch": "0001",
"number": "233099",
"bank": {
"ispb": "13140088",
"code": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO",
"name": "332"
}
},
"channel": {
"numberOfInstallments": 1,
"settlement": {
"value": 5.92,
"currency": "USD"
},
"localAmount": {
"value": 32.0,
"currency": "BRL"
},
"transactionType": {
"code": "00",
"description": "Purchase"
},
"processingCode": "000000",
"mti": "0200",
"preAuthorization": false,
"passwordPresent": true,
"responseCode": "00",
"transactionTimestamp": "2024-04-06T20:31:54Z",
"merchant": {
"mcc": "5411",
"mcg": "Supermarkets",
"city": "TESTE ",
"stateOrCountryCode": "PRY",
"state": "PRY",
"name": "SUP.S6-3 DE FEBRERO ",
"zipCode": "6338500000",
"terminalId": "POS62627 ",
"acquirerCode": "1960021912",
"id": "000062627 "
},
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "f5003716-2a12-447c-930c-801fa2e86eaa",
"card": {
"proxy": "2500761000004494174",
"alias": "Teste LucasC",
"function": "Debit",
"type": "Physical",
"fourLastDigits": "8182"
},
"clearingDate": "2024-07-25T21:47:21.6757429Z"
}
}
{
"entityId": "2b1f56f1-2e5b-4ffa-873c-7a805534afdd",
"companyKey": "ACESSO",
"name": "CANCELATION_WAS_PROCESSED",
"timestamp": "2024-08-02T13:38:39.0004505Z",
"correlationId": "c22fb067-6de2-4d62-a997-6f859877fba9",
"idempotencyKey": "c22fb067-6de2-4d62-a997-6f859877fba9",
"context": "Authorization",
"data": {
"amount": {
"value": 32.27,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 75.94,
"currency": "BRL"
},
"iofAmount": {
"value": 1.3,
"currency": "BRL"
},
"withdrawalFeeAmount": {
"value": 0.0,
"currency": "BRL"
},
"account": {
"branch": "0001",
"number": "233099",
"bank": {
"ispb": "13140088",
"code": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO",
"name": "332"
}
},
"channel": {
"numberOfInstallments": 1,
"settlement": {
"value": 5.92,
"currency": "USD"
},
"localAmount": {
"value": 32.0,
"currency": "USD"
},
"transactionType": {
"code": "00",
"description": "Purchase"
},
"processingCode": "000000",
"mti": "0200",
"preAuthorization": false,
"passwordPresent": true,
"responseCode": "00",
"transactionTimestamp": "2024-04-06T20:31:54Z",
"merchant": {
"mcc": "5411",
"mcg": "Supermarkets",
"city": "TESTE ",
"stateOrCountryCode": "PRY",
"state": "PRY",
"name": "SUP.S6-3 DE FEBRERO",
"zipCode": "6338500000",
"terminalId": "POS62627 ",
"acquirerCode": "1960021912",
"id": "000062627 "
},
"name": "CARD_NETWORK"
},
"fees": {
"markup": 0.05,
"iof": 0.0438,
"dollarExchangeRate": {
"value": 4.97981,
"currency": "BRL"
}
},
"authorizationTransactionId": "2b1f56f1-2e5b-4ffa-873c-7a805534afdd",
"card": {
"proxy": "2500761000004494174",
"alias": "Teste LucasC",
"function": "Debit",
"type": "Physical",
"fourLastDigits": "8182"
},
"clearingDate": "2024-07-25T21:56:17.028875Z"
}
}
{
"entityId": "afa76a53-e26e-463e-ac86-4fdfdce44c5f",
"companyKey": "ACESSO",
"name": "CANCELATION_WAS_PROCESSED",
"timestamp": "2024-07-25T19:36:43.3231504Z",
"correlationId": "afa76a53-e26e-463e-ac86-4fdfdce44c5f",
"idempotencyKey": "afa76a53-e26e-463e-ac86-4fdfdce44c5f",
"context": "Authorization",
"data": {
"amount": {
"value": 20.0,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 20.0,
"currency": "BRL"
},
"iofAmount": {
"value": 3.0,
"currency": "BRL"
},
"channel": {
"numberOfInstallments": 3,
"settlement": {
"value": 20.0,
"currency": "USD"
},
"localAmount": {
"value": 20.0,
"currency": "BRL"
},
"transactionType": {
"code": "00",
"description": "Purchase"
},
"processingCode": "003100",
"mti": "1240",
"preAuthorization": true,
"passwordPresent": false,
"responseCode": "00",
"authorizationId": 4655646549359358,
"transactionTimestamp": "2024-07-25T19:36:42.523Z",
"merchant": {
"mcc": "5199",
"mcg": "Food",
"city": "Sao paulo",
"stateOrCountryCode": "BRA",
"state": "BRA",
"name": "EDITORA NÍSIA FLORESTA",
"id": "213124"
},
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "afa76a53-e26e-463e-ac86-4fdfdce44c5f",
"card": {
"proxy": "2307271002878379965",
"alias": "stg",
"function": "Pos",
"type": "Physical",
"fourLastDigits": "5046"
},
"clearingDate": "2024-07-25T19:36:43.323149Z"
}
}
{
"entityId": "fe059e1d-4c19-4e8f-81a7-acaca66f2811",
"companyKey": "ACESSO",
"name": "CANCELATION_WAS_PROCESSED",
"timestamp": "2024-07-25T19:54:01.8102385Z",
"correlationId": "c595582a-fec3-4cb8-a650-5012c5d96576",
"idempotencyKey": "c595582a-fec3-4cb8-a650-5012c5d96576",
"context": "Authorization",
"data": {
"amount": {
"value": 2.0,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 2.0,
"currency": "BRL"
},
"iofAmount": {
"value": 0.0,
"currency": "BRL"
},
"withdrawalFeeAmount": {
"value": 0.0,
"currency": "BRL"
},
"account": {
"branch": "0001",
"number": "1155",
"bank": {
"ispb": "13140088",
"code": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO",
"name": "332"
}
},
"channel": {
"numberOfInstallments": 1,
"settlement": {
"value": 2.0,
"currency": "USD"
},
"localAmount": {
"value": 2.0,
"currency": "BRL"
},
"transactionType": {
"code": "00",
"description": "Purchase"
},
"processingCode": "002000",
"mti": "0100",
"preAuthorization": false,
"passwordPresent": true,
"responseCode": "00",
"transactionTimestamp": "2024-07-25T19:50:58.594Z",
"merchant": {
"mcc": "5311",
"mcg": "Department",
"city": "Luxemburg ",
"stateOrCountryCode": "BRA",
"state": "BRA",
"zipCode": "1528 ",
"name": "EDITORA NÍSIA FLORESTA",
"terminalId": "62683744",
"acquirerCode": "548104",
"id": "63215248 "
},
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "fe059e1d-4c19-4e8f-81a7-acaca66f2811",
"card": {
"proxy": "2228981000002700744",
"alias": "BIN Oito Digitos",
"function": "Pre",
"type": "Physical",
"fourLastDigits": "8549"
},
"clearingDate": "2024-07-25T19:54:01.8102363Z"
}
}
{
"entityId": "8b030ae9-f66f-4ba3-b9fd-cbdea5b831b0",
"companyKey": "ACESSO",
"name": "CANCELATION_WAS_PROCESSED",
"timestamp": "2024-07-25T19:45:29.4326158Z",
"correlationId": "8b030ae9-f66f-4ba3-b9fd-cbdea5b831b0",
"idempotencyKey": "8b030ae9-f66f-4ba3-b9fd-cbdea5b831b0",
"context": "Authorization",
"data": {
"amount": {
"value": 20.0,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 20.0,
"currency": "BRL"
},
"iofAmount": {
"value": 3.0,
"currency": "BRL"
},
"channel": {
"numberOfInstallments": 3,
"settlement": {
"value": 20.0,
"currency": "USD"
},
"localAmount": {
"value": 20.0,
"currency": "USD"
},
"transactionType": {
"code": "00",
"description": "Purchase"
},
"processingCode": "003100",
"mti": "1240",
"preAuthorization": true,
"passwordPresent": false,
"responseCode": "00",
"authorizationId": 1697171469461702,
"transactionTimestamp": "2024-07-25T19:45:29.116Z",
"merchant": {
"mcc": "5199",
"mcg": "Food",
"city": "Sao paulo",
"stateOrCountryCode": "BRA",
"state": "BRA",
"name": "EDITORA NÍSIA FLORESTA",
"id": "213124"
},
"name": "CARD_NETWORK"
},
"fees": {
"markup": 0.0,
"iof": 0.05,
"dollarExchangeRate": {
"value": 11.8312,
"currency": "BRL"
}
},
"authorizationTransactionId": "8b030ae9-f66f-4ba3-b9fd-cbdea5b831b0",
"card": {
"proxy": "2307271002878379965",
"alias": "stg",
"function": "Pos",
"type": "Physical",
"fourLastDigits": "5046"
},
"clearingDate": "2024-07-25T19:45:29.4326147Z"
}
}
{
"entityId": "0ba9b0d3-b49c-4ead-926d-c59301cef2fc",
"companyKey": "ACESSO",
"name": "CANCELATION_WAS_PROCESSED",
"timestamp": "2024-07-25T21:23:25.5164584Z",
"correlationId": "941e60c4-238b-41d9-91d7-aeb906430f46",
"idempotencyKey": "941e60c4-238b-41d9-91d7-aeb906430f46",
"context": "Authorization",
"data": {
"amount": {
"value": 5.45,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 4.98,
"currency": "BRL"
},
"iofAmount": {
"value": 0.22,
"currency": "BRL"
},
"withdrawalFeeAmount": {
"value": 0.0,
"currency": "BRL"
},
"account": {
"branch": "0001",
"number": "1155",
"bank": {
"ispb": "13140088",
"code": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO",
"name": "332"
}
},
"channel": {
"numberOfInstallments": 1,
"settlement": {
"value": 1.0,
"currency": "USD"
},
"localAmount": {
"value": 1.0,
"currency": "USD"
},
"transactionType": {
"code": "00",
"description": "Purchase"
},
"processingCode": "002000",
"mti": "0100",
"preAuthorization": false,
"passwordPresent": true,
"responseCode": "00",
"transactionTimestamp": "2024-07-25T21:19:35.635Z",
"merchant": {
"mcc": "5311",
"mcg": "Department",
"city": "Luxemburg ",
"stateOrCountryCode": "USA",
"state": "USA",
"name": "EDITORA NÍSIA FLORESTA",
"zipCode": "1528 ",
"terminalId": "62683744",
"acquirerCode": "7133380",
"id": "63215248 "
},
"name": "CARD_NETWORK"
},
"fees": {
"markup": 0.0502008032128514056224899598,
"iof": 0.0438,
"dollarExchangeRate": {
"value": 4.97981,
"currency": "BRL"
}
},
"authorizationTransactionId": "0ba9b0d3-b49c-4ead-926d-c59301cef2fc",
"card": {
"proxy": "2228981000002700744",
"alias": "BIN Oito Digitos",
"function": "Pre",
"type": "Physical",
"fourLastDigits": "8549"
},
"clearingDate": "2024-07-25T21:23:25.5164544Z"
}
}
VOUCHER_WAS_PROCESSED
Este evento sinaliza que o voucher (crédito) foi lançado na conta do cliente.
Descrição do objeto data do evento
data do eventoO objeto data traz detalhes específicos do contexto em que o evento ocorre. Neste caso, o objeto trará os campos de acordo com a tabela:
| Nome | Tipo | Descrição |
|---|---|---|
amount | object | Objeto que contém informações sobre o valor da transação. |
amount.value | number | Valor da transação. |
amount.currency | string | Código da moeda com base na ISO-4217. |
withoutFeeAmount | object | Objeto que contém informações sobre o valor da transação sem taxas. |
withoutFeeAmount.value | number | Valor da transação sem taxas. |
withoutFeeAmount.currency | string | Código da moeda com base na ISO-4217. |
iofAmount | object | Objeto que contém informações sobre o valor calculado do IOF da transação. |
iofAmount.value | number | Valor calculado do IOF da transação. |
iofAmount.currency | string | Código da moeda com base na ISO-4217. |
markupAmount | object | Objeto que contém informações sobre o valor calculado do markup da transação. |
markupAmount.value | number | Valor calculado do markup. |
markupAmount.currency | string | Código da moeda com base na ISO-4217. |
withdrawalFeeAmount | object | Objeto que contém informações sobre o valor da tarifa de saque (somente para transações de saque). |
withdrawalFeeAmount.value | number | Valor da tarifa de saque. |
withdrawalFeeAmount.currency | string | Código da moeda com base na ISO-4217. |
account | object | Objeto que contém informações sobre a conta bancária. |
account.branch | string | Número da agência bancária. |
account.number | string | Número da conta. |
account.bank | object | Objeto que contém informações sobre o banco ao qual a conta pertence. |
account.bank.ispb | string | ISPB (Identificador de Sistema de Pagamentos Brasileiro) do banco. |
account.bank.code | string | Código do banco. |
account.bank.name | string | Nome do banco. |
channel | object | Objeto que contém informações sobre o canal por onde passam os dados recebidos da rede de cartões. |
channel.transactionType | object | Objeto que contém informações sobre o tipo da transação de acordo com a ISO-8583. |
channel.transactionType.code | string | Código da transação, o qual pode ser: “00”, “01”, ou “20”. |
channel.transactionType.description | string | Descrição do código, a qual pode ser “purchase” para “00”, “withdraw” para “01” ou “voucher” para “20”. |
channel.numberOfInstallments | integer | Quantidade de parcelas da transação. |
channel.authorizationCode | string | Identificador da transação da rede do cartão. |
channel.entryMode | object | Objeto que contém informações sobre o modo de entrada do cartão. |
channel.entryMode.code | string | Código do modo de entrada de acordo com a ISO-8583. |
channel.entryMode.description | string | Descrição do modo de entrada. |
channel.retrievalReferenceNumber | string | Identificador de transação da rede do cartão. |
channel.merchant | object | Objeto que contém informações referentes ao estabelecimento/comerciante que aceitou a transação. Seus campos são baseados na ISO-8583. |
channel.merchant.mcc | string | Código mcc da transação. |
channel.merchant.mcg | string | Descrição do tipo do mcc. |
channel.merchant.city | string | Cidade do merchant para identificar parte de sua localização. |
channel.merchant.stateOrCountryCode | string | Código do estado ou do país do merchant para identificar parte da sua localização. |
channel.merchant.state | string | Estado do merchant para identificar parte de sua localização |
channel.merchant.name | string | Nome do merchant. |
channel.merchant.zipCode | string | Código postal do merchant. |
channel.merchant.terminalId | string | Identificador do terminal do merchant. |
channel.merchant.acquirerCode | string | Código do credenciador. |
channel.merchant.id | string | Identificador do merchant |
channel.settlement | object | Objeto que contém informações sobre o valor da transação sem taxas. |
channel.settlement.value | number | Valor da transação sem taxas. |
channel.settlement.currency | string | Código da moeda com base na ISO-4217. |
channel.localAmount | object | Objeto que contém informações sobre o valor da transação sem taxas. |
channel.localAmount.value | number | Valor da transação sem taxas. |
channel.localAmount.currency | string | Código da moeda local com base na ISO-4217. |
channel.name | string | Nome do canal que iniciou a transação no banco. No contexto do autorizador, o canal será sempre “CARD_NETWORK”. |
channel.mti | string | MTI (Message Type Indicator), código que identifica o tipo da transação. |
channel.processingCode | string | Identificador que indica o tipo de transação, o tipo de conta remetente e tipo de conta destinatária. |
channel.preAuthorization | boolean | Em caso de pré-autorização, esse campo retornará TRUE. Caso contrário, FALSE. |
channel.passwordPresent | boolean | Indica se a senha do cartão foi informada na autorização. |
channel.responseCode | string | Código de resposta da bandeira. |
channel.authorizationId | integer | Código de autorização da processadora. Importante: este campo somente é retornado em caso de transação de crédito pós pago. |
channel.transactionTimeStamp | string | Data e hora em que ocorreu a transação, no formato ISO 8601 - UTC. |
fees | object | Objeto que contém informações sobre as taxas aplicadas na transação. |
fees.markup | number | Percentual do markup. |
fees.iof | number | Percentual do IOF. |
fees.dollarExchangeRate | object | Objeto que contém informações sobre a cotação atual do dólar, em reais. |
fees.dollarExchangeRate.value | number | Cotação atual do dólar, em reais. |
fees.dollarExchangeRate.currency | string | Código da moeda local com base na ISO-4217. |
authorizationTransactionId | string | Identificador da transação gerado pela plataforma de autorização do Bankly. |
card | object | Objeto que contém informações sobre o cartão utilizado na transação. |
card.proxy | string | Código identificador do cartão. |
card.alias | string | Apelido definido pelo proprietário do cartão. |
card.function | string | Função do cartão, a qual pode ser: “Pre”, “Pos”, “Debit”. |
card.type | string | Tipo do cartão, o qual pode ser: “Physical” ou “Virtual”. |
card.fourLastDigits | string | Quatro últimos dígitos do cartão. |
account | object | Objeto que contém os dados da conta e da licença bancária. |
account.branch | string | Número da agência bancária. |
account.number | string | Número da conta. |
account.bank | object | Objeto que contém os dados bancários. |
account.bank.ispb | string | ISPB do banco. |
account.bank.code | string | Código do banco. |
account.bank.name | string | Nome do banco. |
clearingDate | string | Data de confirmação processada pela plataforma de autorização do Bankly, no formato ISO 8601 - UTC. |
Payload do evento
O payload abaixo exemplifica a estrutura do evento que deverá ser recebido pelo parceiro. Clique na seta para expandi-lo:
Exemplos de payloads
{
"entityId": "afa76a53-e26e-463e-ac86-4fdfdce44c5f",
"companyKey": "ACESSO",
"name": "VOUCHER_WAS_PROCESSED",
"timestamp": "2024-07-25T19:38:43.3377561Z",
"correlationId": "afa76a53-e26e-463e-ac86-4fdfdce44c5f",
"idempotencyKey": "afa76a53-e26e-463e-ac86-4fdfdce44c5f",
"context": "Authorization",
"data": {
"amount": {
"value": 20.0,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 20.0,
"currency": "BRL"
},
"iofAmount": {
"value": 0.0,
"currency": "BRL"
},
"markupAmount": {
"value": 0.0,
"currency": "BRL"
},
"channel": {
"numberOfInstallments": 3,
"authorizationCode": "5672384159793536",
"entryMode": {
"description": "EletronicCommerceSecureWithUCAF"
},
"retriavelReferenceNumber": "5672384159793536",
"merchant": {
"mcc": "5199",
"mcg": "Food",
"city": "sao paulo",
"stateOrCountryCode": "BRA",
"state": "BRA",
"name": "EDITORA NÍSIA FLORESTA",
"id": "213445214"
},
"settlement": {
"value": 20.0,
"currency": "USD"
},
"localAmount": {
"value": 20.0,
"currency": "BRL"
},
"processingCode": "20",
"mti": "1240",
"preAuthorization": true,
"passwordPresent": false,
"responseCode": "00",
"authorizationId": 4655646549359358,
"transactionTimestamp": "2024-07-25T19:38:41.304Z",
"transactionType": {
"code": "20",
"description": "Voucher"
},
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "afa76a53-e26e-463e-ac86-4fdfdce44c5f",
"card": {
"proxy": "2307271002878379965",
"alias": "stg",
"function": "Pos",
"type": "Physical",
"fourLastDigits": "5046"
},
"clearingDate": "2024-07-25T19:38:43.3376225Z"
}
}
{
"entityId": "fa5c09c9-1ace-40cd-ae18-c2d0d3d1580c",
"companyKey": "ACESSO",
"name": "VOUCHER_WAS_PROCESSED",
"timestamp": "2024-07-03T21:37:40.5122194Z",
"correlationId": "4bc5ff16-6ad7-4c82-92a4-4a2f0506a9dc",
"idempotencyKey": "4bc5ff16-6ad7-4c82-92a4-4a2f0506a9dc",
"context": "Authorization",
"data": {
"amount": {
"value": 1.0,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 1.0,
"currency": "BRL"
},
"iofAmount": {
"value": 0.0,
"currency": "BRL"
},
"markupAmount": {
"value": 0.0,
"currency": "BRL"
},
"withdrawalFeeAmount": {
"value": 0.0,
"currency": "BRL"
},
"account": {
"branch": "0001",
"number": "1155",
"bank": {
"ispb": "13140088",
"code": "332",
"name": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO"
}
},
"channel": {
"numberOfInstallments": 1,
"authorizationCode": "acfcd937-f9fd-4e5b-9ad0-8d143a6aa071",
"entryMode": {
"code": "600450S99111",
"description": "Unknown"
},
"retriavelReferenceNumber": "acfcd937-f9fd-4e5b-9ad0-8d143a6aa071",
"merchant": {
"mcc": "5311",
"mcg": "Department",
"city": "Luxemburg ",
"stateOrCountryCode": "BRA",
"state": "BRA",
"name": "Editora Nísia Floresta",
"zipCode": "1528 ",
"terminalId": "62683744",
"acquirerCode": "728384008",
"id": "63215248 "
},
"settlement": {
"value": 1.0,
"currency": "USD"
},
"localAmount": {
"value": 1.0,
"currency": "BRL"
},
"processingCode": "002000",
"mti": "0100",
"preAuthorization": false,
"passwordPresent": true,
"responseCode": "00",
"transactionTimestamp": "2024-07-03T21:36:53.894Z",
"transactionType": {
"code": "20",
"description": "Voucher"
},
"name": "CARD_NETWORK"
},
"authorizationTransactionId": "fa5c09c9-1ace-40cd-ae18-c2d0d3d1580c",
"card": {
"proxy": "2228981000002700744",
"alias": "BIN Oito Digitos",
"function": "Pre",
"type": "Physical",
"fourLastDigits": "8549"
},
"clearingDate": "2024-07-03T21:37:40.5120981Z"
}
{
"entityId": "8b030ae9-f66f-4ba3-b9fd-cbdea5b831b0",
"companyKey": "ACESSO",
"name": "VOUCHER_WAS_PROCESSED",
"timestamp": "2024-07-25T19:46:26.1525107Z",
"correlationId": "8b030ae9-f66f-4ba3-b9fd-cbdea5b831b0",
"idempotencyKey": "8b030ae9-f66f-4ba3-b9fd-cbdea5b831b0",
"context": "Authorization",
"data": {
"amount": {
"value": 20.0,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 20.0,
"currency": "BRL"
},
"iofAmount": {
"value": 0.0,
"currency": "BRL"
},
"markupAmount": {
"value": 0.0,
"currency": "BRL"
},
"channel": {
"numberOfInstallments": 3,
"authorizationCode": "5672384159793536",
"entryMode": {
"description": "EletronicCommerceSecureWithUCAF"
},
"retriavelReferenceNumber": "5672384159793536",
"merchant": {
"mcc": "5199",
"mcg": "Food",
"city": "sao paulo",
"stateOrCountryCode": "BRA",
"state": "BRA",
"name": "EDITORA NÍSIA FLORESTA",
"id": "213445214"
},
"settlement": {
"value": 20.0,
"currency": "USD"
},
"localAmount": {
"value": 20.0,
"currency": "USD"
},
"processingCode": "20",
"mti": "1240",
"preAuthorization": true,
"passwordPresent": false,
"responseCode": "00",
"authorizationId": 1697171469461702,
"transactionTimestamp": "2024-07-25T19:46:25.318Z",
"transactionType": {
"code": "20",
"description": "Voucher"
},
"name": "CARD_NETWORK"
},
"fees": {
"markup": 0.0,
"iof": 0.0,
"dollarExchangeRate": {
"value": 11.8312,
"currency": "BRL"
}
},
"authorizationTransactionId": "8b030ae9-f66f-4ba3-b9fd-cbdea5b831b0",
"card": {
"proxy": "2307271002878379965",
"alias": "stg",
"function": "Pos",
"type": "Physical",
"fourLastDigits": "5046"
},
"clearingDate": "2024-07-25T19:46:26.1523804Z"
}
}
{
"entityId": "f7df0241-ae23-45f6-ac2a-9d3fc3ad7032",
"companyKey": "ACESSO",
"name": "VOUCHER_WAS_PROCESSED",
"timestamp": "2024-07-25T21:28:27.5182091Z",
"correlationId": "4bc5ff16-6ad7-4c82-92a4-4a2f0506a9dc",
"idempotencyKey": "4bc5ff16-6ad7-4c82-92a4-4a2f0506a9dc",
"context": "Authorization",
"data": {
"amount": {
"value": 1.0,
"currency": "BRL"
},
"withoutFeeAmount": {
"value": 4.98,
"currency": "BRL"
},
"iofAmount": {
"value": 0.22,
"currency": "BRL"
},
"markupAmount": {
"value": 0.25,
"currency": "BRL"
},
"withdrawalFeeAmount": {
"value": 0.0,
"currency": "BRL"
},
"account": {
"branch": "0001",
"number": "1155",
"bank": {
"ispb": "13140088",
"code": "ACESSO SOLUÇÕES DE PAGAMENTO S.A. - INSTITUIÇÃO DE PAGAMENTO",
"name": "332"
}
},
"channel": {
"numberOfInstallments": 1,
"authorizationCode": "397c88c2-1235-4a93-baec-1db19de03ee7",
"entryMode": {
"code": "600450S99111",
"description": "Unknown"
},
"retriavelReferenceNumber": "397c88c2-1235-4a93-baec-1db19de03ee7",
"merchant": {
"mcc": "5311",
"mcg": "Department",
"city": "Luxemburg ",
"stateOrCountryCode": "USA",
"state": "USA",
"name": "EDITORA NÍSIA FLORESTA",
"zipCode": "1528 ",
"terminalId": "62683744",
"acquirerCode": "7133380",
"id": "63215248 "
},
"settlement": {
"value": 1.0,
"currency": "USD"
},
"localAmount": {
"value": 1.0,
"currency": "USD"
},
"processingCode": "002000",
"mti": "0100",
"preAuthorization": false,
"passwordPresent": true,
"responseCode": "00",
"transactionTimestamp": "2024-07-25T21:27:38.607Z",
"transactionType": {
"code": "20",
"description": "Voucher"
},
"name": "CARD_NETWORK"
},
"fees": {
"markup": 0.0502008032128514056224899598,
"iof": 0.0438,
"dollarExchangeRate": {
"value": 4.97981,
"currency": "BRL"
}
},
"authorizationTransactionId": "f7df0241-ae23-45f6-ac2a-9d3fc3ad7032",
"card": {
"proxy": "2228981000002700744",
"alias": "BIN Oito Digitos",
"function": "Pre",
"type": "Physical",
"fourLastDigits": "8549"
},
"clearingDate": "2024-07-25T21:28:27.517619Z"
}
}
Exemplos de conteúdo do campo wallet
| Código | Descrição |
|---|---|
| 101 | MasterpassByMastercard |
| 103 | ApplePay |
| 216 | GooglePay |
| 217 | SamsungPay |
| 327 | MerchantTokenizationProgram |
| 0 | Unknown |
| 00 | Unknown |
Motivos para uma transação negada (deniedRules)
deniedRules)O evento de autorização TRANSACTION_WAS_PROCESSED traz o campo deniedRules, que pode conter os seguintes motivos de negação:
Bankly
| Motivo | Descrição |
|---|---|
| NOT_ALLOWED_ADVICE_FOR_DENIED_TRANSACTION_HOLD | A reversão por falha sistêmica não foi permitida porque a autorização foi negada. |
| OPERATION_NOT_IMPLEMENTED | A interpretação da requisição recebida não resultou em nenhuma operação válida (autorização, advice ou reversão). |
| DUPLICATED_TRANSACTION | Transação duplicada. |
| TRANSACTION_NOT_EXISTS | Transação não existe. |
| BLOCKED_BY_CARD_INTEGRATION | Erro de comunicação interna com o serviço de cartão. |
| NOT_ALLOWED_WITHDRAWAL | Não é permitido saque. |
| NOT_ALLOWED_PURCHASE_INTERNATIONAL | Não é permitida compra internacional. |
| NOT_ALLOWED_PURCHASE_ONLINE | Não é permitida compra online. |
| NOT_ALLOWED_PURCHASE_PHYSICAL | Não é permitida compra física. |
| NOT_ALLOWED_PRE_AUTHORIZATION | Não é permitida pré-autorização. |
| NOT_ALLOWED_MORE_THAN_ONE_INSTALLMENT | Não é permitido parcelamento. |
| CONSTITUTION_NOT_FOUND | Erro interno na consulta de configurações do cartão. |
| NOT_ALLOWED_CONTACTLESS | Não é permitido contactless. |
| NOT_ALLOWED_MCC | MCC não permitido. |
| NOT_ALLOWED_CARD_NOT_VALID | Cartão não ativo. |
| NOT_ALLOWED_CARD_LOCKED | Cartão bloqueado. |
| NOT_ALLOWED_CARD_CANCELED | Cartão cancelado. |
| NOT_ALLOWED_CARD_IS_BUILDING | Cartão ainda em processo de impressão. |
| NOT_ALLOWED_REVERSAL_AMOUNT_GREATER_THAN_ORIGINAL_AMOUNT | Reversão não permitida, pois o valor é maior que o original. |
| NOT_ALLOWED_REVERSAL_FOR_ALREADY_PROCESSED_TRANSACTION_IN_SECOND_INSTANCE | Não é permitida a reversão para a transação já conciliada. |
| NOT_ALLOWED_PARTIAL_WITHDRAWAL_REVERSAL | Não é permitida a reversão de saque parcial. |
| BLOCKED_BY_CORE_BANK_VALIDATION | Falha na integração com core bancário. |
| BLOCKED_BY_LIMIT_VALIDATION | Bloqueado por validação de limite de quantidade de transações ou montante por CPF por ciclo (transacional, diário ou mensal). |
| BLOCKED_BY_RISK_ANALYSIS | Bloqueado para análise de risco (enviado em transações pré-pagas). |
| BLOCKED_BY_RISK_ANALYSIS_AND_LIMIT_VALIDATION | Bloqueado por análise de risco e validação de limite. |
| INVALID_OPERATION | A compra foi passada em uma operação (débito ou crédito) não permitida. |
| NOT_ALLOWED_CARD_WITH_STATUS_CREATED | Cartão com status de Criação. |
| NOT_ALLOWED_CARD_WITH_STATUS_BLOCKED | Cartão com status Bloqueado. |
| NOT_ALLOWED_CARD_WITH_STATUS_WARNING | Cartão com status de Atenção. |
| NOT_ALLOWED_CARD_WITH_STATUS_CANCELLED_OR_CLIENTORDER | Cartão com status Cancelado. |
| NOT_ALLOWED_CARD_WITH_STATUS_FRAUD | Cartão com status de Fraude. |
| NOT_ALLOWED_CARD_WITH_STATUS_LOST | Cartão com status Perdido. |
| NOT_ALLOWED_CARD_WITH_STATUS_ROBBED_OR_THEFT | Cartão com status Roubado. |
| NOT_ALLOWED_CARD_WITH_STATUS_DELETED | Cartão com status Excluído. |
| NOT_ALLOWED_CARD_WITH_STATUS_UNRECEIVED | Cartão com status Não Recebido. |
| NOT_ALLOWED_CARD_WITH_STATUS_INOPERATIVE | Cartão com status Inoperante. |
| NOT_ALLOWED_PURCHASE_WITH_CURRENCY_UNMATCH_COUNTRY | A compra foi realizada em BRL, mas o estabelecimento é internacional. |
| NOT_ALLOWED_CARD_WITH_STATUS_OTHER | Cartão com status Outros. |
| TRANSACTION_IS_NOT_ON_HOLD | Transação já revertida. |
| NOT_ALLOWED_REVERSAL_CURRENCY_UNMATCH_ORIGINAL_CURRENCY | Moeda de reversão diferente da utilizada na autorização. |
Core bancário
| Motivo | Descrição |
|---|---|
| INSUFFICIENT_BALANCE | Saldo insuficiente. |
| AUTHORIZATION_HOLD_NOT_FOUND | Erro ao tentar reverter uma autorização não efetuada. |
| WITHDRAWAL_LIMIT_EXCEEDED | O limite de retirada de dinheiro no core bancário foi excedido. |
| CORE_BANK_INTEGRATION_ERROR | Erro ao integrar com o core bancário. |
Processadora
| Motivo | Descrição |
|---|---|
| INVALID_PASSWORD | A senha informada na compra/saque não é válida. |
| PAN_NOT_FOUND_IN_PCI_DATABASE | Cartão não encontrado pela processadora. |
| INVALID_EXPIRATION_DATE | Data de expiração inválida. |
| NOT_ALOWED_PURCHASE_WITH_STRIPE_CARD | Não é permitido passar a compra com a tarja do cartão. |
| INVALID_ENTRY_MODE | Não é permitido passar a compra com a tarja do cartão, pois a máquina só aceita chip. |
| CVV_VALIDATION_WITH_SAFETY_AUTHENTICATION_MODE_VALIDATION | CVV inválido. |
| UNSAFETY_TRANSACTION_WITHOUT_VALIDATION_METHOD | Não foi informado nenhum dado de segurança, no momento da transação. |
| CVV_VALIDATION_WITH_EXPIRATION_DATE_VALIDATION | Cartão temporário utilizado após o término do seu prazo de vida. |
| ANTI_FRAUD_VALIDATION | Transação pós-paga negada no antifraude do Bankly. |
| CANCEL_REQUEST_UNMATCH_ORIGINAL_TRANSACTION | Transação original não encontrada na processadora. |
| LIMIT_EXCEEDED | Limite da processadora excedido. |
| TIMEOUT | Tempo de comunicação expirado. |
| COMUNICATION_FAIL | Comunicação indisponível. |
| CRIPTOGRAM_VALIDATION_HSM | Falha na validação de segurança do criptograma. |
| OBSOLET_CARDHOLDER_VALIDATION | Método de validação do usuário é obsoleto. |
| INVALID_OPERATION_FOR_THE_PROGRAM_OR_ACCOUNT | Não é permitido o parcelamento de compra com cartão de débito ou crédito pré. |
| NOT_ALOWED_TRANSACTION_DATE_BIGGER_THAN_CARD_EXPIRATION_DATE | Cartão expirado. |
| RETRY_QUANTITY_EXCEEDED | Número de tentativas de senha foi excedido. |
| ATC | Discrepância entre o ATC (Application Transaction Counter) do chip e do autorizador. |
| NOT_ALLOWED_PURCHASE_FOR_BLOCKED_ACCOUNT | Conta bloqueada. |
| CRIPTOGRAM_VALIDATION_PER_ENTRY_MODE | Criptograma não enviado para o modo de entrada escolhido. |
| ANTI_FRAUD_GENERIC_ERROR | Falha na análise de risco da transação de crédito pós-pago. |
| ANTI_FRAUD_TIEMOUT | Tempo de comunicação expirado na análise de risco da transação crédito pós pago. |
Código do modo de entrada (entryMode)
entryMode)code | description | Descrição |
|---|---|---|
| 00 | Unknown | Modo de entrada do PAN desconhecido. |
| 01 | Manual | Entrada do PAN manual. |
| 02 | MagneticStripe | 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 | BarCodeReader | Entrada automática via leitor de código de barras. |
| 04 | OCR | Entrada automática de PAN via leitor óptico de caracteres (OCR). |
| 05 | Chip | Entrada automática de PAN via chip. |
| 06 | ContactlessObsolete | Contactless obsoleto. |
| 07 | ContactlessMChip | Entrada automática de PAN via M/Chip sem contato. |
| 09 | EletronicCommerce | Entrada de PAN/Token via comércio eletrônico contendo criptograma DSRP em DE 55 (Integrated Circuit Card [ICC] System-Related Data). |
| 10 | CredentialOnFile | Credencial em arquivo. |
| 79 | HybridTerminalFailedConnection | 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 | ChipCapableTerminal | O cartão com chip não foi capaz de processar/leitura da tarja magnética padrão. |
| 81 | EletronicCommerceSecureWithUCAF | Entrada de PAN/Token via comércio eletrônico com opcional Identity Check-AAV ou criptograma DSRP em UCAF. |
| 82 | Server | Entrada automática de PAN via servidor (sistema emissor, adquirente ou fornecedor terceirizado). |
| 90 | MagneticStripeFullTrackData | 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 | ContactlessMagneticStripe | Entrada automática do número da conta via tarja magnética sem contato. |
| 95 | Visa | Apenas Visa – Chip com CVV não confiável. |
Nota
Os valores de
entryModedescritos na tabela acima são provenientes da bandeira do cartão e podem sofrer alterações e/ou acréscimos.
Updated 21 days ago