O Visa Intelligent Data Exchange (IDX) é uma solução da Visa para compartilhamento de dados em transações sem cartão presente.
Provedores de dados terceirizados enviam dados adicionais para Visa, que envia esses dados para os emissores de forma apartada. Os emissores, então, usam esses dados para a análise de risco e decisão de autorização. Esses dados são identificados via chave IDX, enviada pela loja ao criar um pagamento com cartão de crédito. O objetivo é melhorar a análise de risco feita pelos emissores sem aumentar a fricção para o portador do cartão.
Para enviar a chave IDX, preencha o nó ExternalAuthentication da seguinte forma:
{
"Payment": {
"ExternalAuthentication": {
"Eci": 7,
"Cavv": "chave IDX"
}
}
}
Payment.ExternalAuthentication.Eci: envie com valor "7", indicando autenticação externa;Payment.ExternalAuthentication.Cavv: insira a chave IDX provida pelo provedor de dados.
- O serviço IDX da Visa não funciona em conjunto com a autenticação 3DS, é necessário escolher uma forma de autenticação;
- O serviço IDX não está disponível para transações em sandbox;
- O serviço IDX é exclusivo para transações com cartões da bandeira Visa.
Para usar o IDX, é preciso contratar o serviço com a Visa e usar um provedor de dados terceirizado que faça parte do programa.
Saiba mais sobre o serviço na documentação da Visa.
Exemplo de requisição com Visa IDX
{
"Customer": {
"DeliveryAddress": {
"Street": "Alameda Xingu",
"Number": "512",
"Complement": "27 andar",
"ZipCode": "12345987",
"City": "São Paulo",
"State": "SP",
"Country": "BR",
"District": "Alphaville"
},
"Name": "Comprador Accept",
"Email": "[email protected]",
"Identity": "12750233713",
"IdentityType": "CPF",
"Mobile": "5521996660078",
"Phone": "552125553669"
},
"Payment": {
"Type": "splittedcreditcard",
"CreditCard": {
"CardNumber": "4481530710186111",
"holder": "Oswaldo Soares",
"ExpirationDate": "12/2019",
"SecurityCode": "693",
"Brand": "Visa",
"SaveCard": "false"
},
"SplitPayments": [
{
"SubordinateMerchantId": "f2d6eb34-2c6b-4948-8fff-51facdd2a28f",
"Amount": 5000,
"Fares": {
"Mdr": 5,
"Fee": 30
}
},
{
"SubordinateMerchantId": "9140ca78-3955-44a5-bd44-793370afef94",
"Amount": 5000,
"Fares": {
"Mdr": 4,
"Fee": 15
}
}
],
"DoSplit": true,
"ExternalAuthentication": {
"Eci": 7,
"Cavv": "chaveIDX"
},
"Amount": 10000,
"Capture": true,
"Installments": 1,
"Softdescriptor": "teste"
},
"MerchantOrderId": "22082019v4"
}
'Os parâmetros influenciados pelo IDX são:
| Parâmetros | Descrição |
|---|---|
Payment.ExternalAuthentication.Eci | Envie o campo com valor "7", indicando autenticação externa. |
Payment.ExternalAuthentication.Cavv | Envie sua chave IDX. |
Exemplo de resposta
{
"MerchantOrderId": "22082019v5",
"Customer": {
"Name": "Comprador Accept",
"Identity": "12750233713",
"IdentityType": "CPF",
"Email": "[email protected]",
"DeliveryAddress": {
"Street": "Alameda Xingu",
"Number": "512",
"Complement": "27 andar",
"ZipCode": "12345987",
"City": "São Paulo",
"State": "SP",
"Country": "BR",
"District": "Alphaville"
},
"Phone": "552125553669",
"Mobile": "5521996660078"
},
"Payment": {
"ServiceTaxAmount": 0,
"Installments": 1,
"Interest": 0,
"Capture": true,
"Authenticate": false,
"Recurrent": false,
"CreditCard": {
"CardNumber": "448153******6111",
"Holder": "Oswaldo Soares",
"ExpirationDate": "12/2019",
"SaveCard": false,
"Brand": "Visa"
},
"Tid": "0823033923354",
"ProofOfSale": "20190823033923354",
"AuthorizationCode": "664803",
"SoftDescriptor": "teste",
"Provider": "Simulado",
"ExternalAuthentication": {
"Eci": 7,
"Cavv": "chaveIDX"
},
"SplitPayments": [
{
"SubordinateMerchantId": "f2d6eb34-2c6b-4948-8fff-51facdd2a28f",
"Amount": 6000,
"Fares": {
"Mdr": 5,
"Fee": 30
},
"Splits": [
{
"MerchantId": "f2d6eb34-2c6b-4948-8fff-51facdd2a28f",
"Amount": 5670
},
{
"MerchantId": "f43fca07-48ec-46b5-8b93-ce79b75a8f63",
"Amount": 330
}
]
},
{
"SubordinateMerchantId": "f2d6eb34-2c6b-4948-8fff-51facdd2a28f",
"Amount": 4000,
"Fares": {
"Mdr": 4,
"Fee": 15
},
"Splits": [
{
"MerchantId": "9140ca78-3955-44a5-bd44-793370afef94",
"Amount": 3825
},
{
"MerchantId": "f43fca07-48ec-46b5-8b93-ce79b75a8f63",
"Amount": 175
}
]
}
],
"IsQrCode": false,
"Amount": 10000,
"ReceivedDate": "2019-08-23 15:39:15",
"CapturedAmount": 10000,
"CapturedDate": "2019-08-23 15:39:23",
"Status": 2,
"IsSplitted": true,
"ReturnMessage": "Operation Successful",
"ReturnCode": "6",
"PaymentId": "bc0758ca-245b-4c35-9b13-20e48417667e",
"Type": "SplittedCreditCard",
"Currency": "BRL",
"Country": "BRA",
"Links": [
{
"Method": "PUT",
"Rel": "split",
"Href": "https://splitsandbox.braspag.com.br/api/transactions/bc0758ca-245b-4c35-9b13-20e48417667e/split"
},
{
"Method": "GET",
"Rel": "self",
"Href": "https://apiquerysandbox.cieloecommerce.cielo.com.br/1/sales/bc0758ca-245b-4c35-9b13-20e48417667e"
},
{
"Method": "PUT",
"Rel": "void",
"Href": "https://apisandbox.cieloecommerce.cielo.com.br/1/sales/bc0758ca-245b-4c35-9b13-20e48417667e/void"
}
]
}
}