introducao
visao-geral-textpublico-alvo
publico-alvo-textosobre-3ds
sobre-3ds-texto
{
"paymentAuthorization":{
"paymentId":"010003872201241223520014983807920000000000",
"authorizationCode":"021150",
"orderNumber":"17836-55544",
"expireAt":"2024-02-14T09:23:52.8778532-03:00",
"amount":2166,
"returnCode":"0",
"description":"Sucesso",
"releaseAt":"2024-01-24T09:23:52-03:00"
},
"threeDs":{
"status":"Silent",
"eci":"02",
"threeDsVersion":"2.2.0",
"veresEnrolled":"Y",
"paresStatus":"Y",
"threeDsStatus":"AUTHENTICATION_SUCCESSFUL"
}
}
{
"threeDs":{
"status":"Challenge",
"threeDsVersion":"2.2.0",
"ascUrl":"https://merchantacsstag.cardinalcommerce.com/MerchantASSWeb/pareq.jsp?vaa=b&gold=AAAAA",
"authenticationTransactionId":"WUcomZFeccuB0fjhD8z0",
"pareq":"3232a0d7e6cf46908cede9fb453536433232a0d7e6cf46908cede9fb453536433232a0d7e6cf46908cede9fb453536433232a0d7e6cf46908cede9fb453536433232a0d7e6cf46908cede9fb453536433232a0d7e6cf46908cede9fb45353643"
}
}
{
"paymentAuthorization":{
"returnCode":"0",
"description":"Sucesso",
"paymentId":"02008028610304095215000006201850000000",
"authorizationCode":"043711",
"orderNumber":"0000000001",
"expireAt":"2019-09-24T13:20:52.8775511-03:00",
"amount": 1035,
"releaseAt": "2019-09-24T13:20:52.8775511-03:00"
}
}
Debit without 3DS
All debit card transactions in Brazil must go through a 3DS 2.0 authentication to be authorized by the issuer. Exceptions to this rule include specific BINs where such authentication is not required .However, with permission from the card networks/issuers, merchants can obtain authorization for their MID to process these types of cards without needing 3DS 2.0 authentication. This allows for recurring transactions with debit cards.
Required
- Ensure that the validation that allows transacting without the 3DS is enabled in the ADIQ (Customer Service Team).
- It is essential to obtain authorization from the issuer to process transactions without 3DS, requiring registration with them.
- Do not provide 3DS data during the transaction.
titulo-impl-js
link-download
link-download-texto-jstitulo-3ds-procedimento
3ds-procedimento-jscapturar-campos
capturar-campos-textocampos-necessarios
campos-necessarios-texto tabela-1
{
"Payment":
{
"TransactionType": "debit",
"Amount":1111,
"CurrencyCode": "brl",
"ProductType": "debito",
"Installments": 1,
"CaptureType": "ac",
"Recurrent":false
},
"CardInfo":
{
"NumberToken":"d56109ce-6a3b-4190-beea-1c975e8cd486",
"CardholderName":"Luiz Silveira Neto",
"SecurityCode":"123",
"Brand": "mastercard",
"ExpirationMonth":"01",
"ExpirationYear":"29"
},
"SellerInfo":
{
"OrderNumber":"1110197548565",
"SoftDescriptor":"PAG*TESTE",
"UrlSite3DS":"empresa.ecommerce.com.br",
"Code3DS":"aa415dc21f4e4e7ca083a1473d5c4c58"
},
"Customer":
{
"DocumentType": "cpf",
"DocumentNumber":"51115672088",
"FirstName":"Luiz",
"LastName":"Silveira Neto",
"Email":"luiz.silveira@teste.rafael.com",
"PhoneNumber":"1122542454",
"MobilePhoneNumber":"11987683332",
"Address":"Rua Luiz Vieira, 134",
"Complement":"apto. 34 - Vila Guarani",
"City":"São Paulo",
"State":"SP",
"ZipCode":"09876-098",
"IpAddress":"45.233.232.248",
"Country":"BR"
},
"Sellers":[
],
"DeviceInfo":
{
"HttpAcceptBrowserValue":"text/html,application/xhtml+xml,application/xml;
q=0.9,image/webp,image/apng,*/*;q=0.8",
"HttpAcceptContent":"text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8",
"HttpBrowserLanguage":"pt-BR",
"HttpBrowserJavaEnabled":"N",
"HttpBrowserJavaScriptEnabled":"Y",
"HttpBrowserColorDepth":"24",
"HttpBrowserScreenHeight":"937",
"HttpBrowserScreenWidth":"1920",
"HttpBrowserTimeDifference":"180",
"UserAgentBrowserValue":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.102 Safari/537.36"
}
}
requisicao-payments
{
"paymentAuthorization":{
"returnCode":"0",
"description":"Sucesso",
"paymentId":"02008028610304095215000006201850000000",
"authorizationCode":"043711",
"orderNumber":"0000000001",
"expireAt":"2019-09-24T13:20:52.8775511-03:00",
"amount": 1035,
"releaseAt": "2019-09-24T13:20:52.8775511-03:00"
},
"threeDs":{
"status":"Silent",
"eci":"02",
"threeDsVersion":"2.1.0",
"veresEnrolled":"Y",
"paresStatus":"Y",
"threeDsStatus":"AUTHENTICATION_SUCCESSFUL"
}
}
tabela-2 tabela-3
{
"code3ds": "dbe5a61a-836d-45dd-82c1-52d0c5e3c010",
"validateToken":
"eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiI1ZWNkNzVkNjNlMzFiYzQ3MWExZWM2MWYiLCJpYXQi
OjE1OTQyMzI4MTcsImV4cCI6MTU5NDI0MDAxNywianRpIjoiYjFmNjEyZWEtMDRhZS00ZDY2LW
EzM2QtY2I1MjgwOGY4M2FlIiwiQ29uc3VtZXJTZXNzaW9uSWQiOiIwX2E3MGIzMjk0LTI1MTIt
NDc0ZS05OTcxLTZmZTk3YTllYWYzNiIsIlJlZmVyZW5jZUlkIjoiN2Y0ODc3YmVkODVhNDU2Mm
IxYjNlZjk4MWQ2MjViY2UiLCJhdWQiOiIwMzc2NTk3ODgyMTU0NWRiOTBjN2Y1YmE1ZDNmNWU1
NiIsIlBheWxvYWQiOiJ7XCJQYXltZW50XCI6e1wiVHlwZVwiOlwiQ0NBXCIsXCJQcm9jZXNzb3
JUcmFuc2FjdGlvbklkXCI6XCJHc2pMM1lkczVmWk80MzBXYk1RMFwiLFwiRXh0ZW5kZWREYXRh
XCI6e1wiQW1vdW50XCI6XCIxMTExXCIsXCJDdXJyZW5jeUNvZGVcIjpcIjk4NlwifX0sXCJFcn
Jvck51bWJlclwiOjAsXCJFcnJvckRlc2NyaXB0aW9uXCI6XCJTdWNjZXNzXCJ9In0.9oBbxbtu
hZyZaE_vuu6UzU-Mp5BjK2FNp5XAfoDy2uQ"
}
validate-request
{
"paymentAuthorization":{
"returnCode":"0",
"description":"Sucesso",
"paymentId":"020006204409231653310000023790740000000000",
"authorizationCode":"026603",
"orderNumber":"3979908797721",
"amount":1111,
"releaseAt":"2020-09-23T16:53:34+00:00"
},
"threeDs":{
"status":"Challenge",
"eci":"02",
"threeDsVersion":"2.2.0",
"paresStatus":"Y",
"threeDsStatus":"AUTHENTICATION_SUCCESSFUL"
}
}
validate-badrequest
{
"FailureDetails":[
{
"tag": "string",
"description": "motivo da falha"
}
]
}
titulo-impl-sdk-android
link-download
link-download-texto-sdk-androidtitulo-3ds-procedimento
3ds-procedimento-sdk-androidcampos-necessarios
campos-necessarios-texto tabela-1-sdk
{
"Payment":
{
"TransactionType": "debit",
"Amount":1111,
"CurrencyCode": "brl",
"ProductType": "debito",
"Installments": 1,
"CaptureType": "ac",
"Recurrent":false
},
"CardInfo":
{
"NumberToken":"d56109ce-6a3b-4190-beea-1c975e8cd486",
"CardholderName":"Luiz Silveira Neto",
"SecurityCode":"123",
"Brand": "mastercard",
"ExpirationMonth":"01",
"ExpirationYear":"29"
},
"SellerInfo":
{
"OrderNumber":"1110197548565",
"SoftDescriptor":"PAG*TESTE",
"UrlSite3DS":"empresa.ecommerce.com.br",
"Code3DS":"aa415dc21f4e4e7ca083a1473d5c4c58"
},
"Customer":
{
"DocumentType": "cpf",
"DocumentNumber":"51115672088",
"FirstName":"Luiz",
"LastName":"Silveira Neto",
"Email":"luiz.silveira@teste.rafael.com",
"PhoneNumber":"1122542454",
"MobilePhoneNumber":"11987683332",
"Address":"Rua Luiz Vieira, 134",
"Complement":"apto. 34 - Vila Guarani",
"City":"São Paulo",
"State":"SP",
"ZipCode":"09876-098",
"IpAddress":"45.233.232.248",
"Country":"BR"
},
"Sellers":[
],
"DeviceInfo":
{
"DeviceChannel":"SDK"
}
}
requisicao-payments
{
"paymentAuthorization":{
"returnCode":"0",
"description":"Sucesso",
"paymentId":"02008028610304095215000006201850000000",
"authorizationCode":"043711",
"orderNumber":"0000000001",
"expireAt":"2019-09-24T13:20:52.8775511-03:00",
"amount": 1035,
"releaseAt": "2019-09-24T13:20:52.8775511-03:00"
},
"threeDs":{
"status":"Silent",
"eci":"02",
"threeDsVersion":"2.1.0",
"veresEnrolled":"Y",
"paresStatus":"Y",
"threeDsStatus":"AUTHENTICATION_SUCCESSFUL"
}
}
tabela-2 tabela-3
{
"code3ds": "dbe5a61a-836d-45dd-82c1-52d0c5e3c010",
"validateToken":
"eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiI1ZWNkNzVkNjNlMzFiYzQ3MWExZWM2MWYiLCJpYXQi
OjE1OTQyMzI4MTcsImV4cCI6MTU5NDI0MDAxNywianRpIjoiYjFmNjEyZWEtMDRhZS00ZDY2LW
EzM2QtY2I1MjgwOGY4M2FlIiwiQ29uc3VtZXJTZXNzaW9uSWQiOiIwX2E3MGIzMjk0LTI1MTIt
NDc0ZS05OTcxLTZmZTk3YTllYWYzNiIsIlJlZmVyZW5jZUlkIjoiN2Y0ODc3YmVkODVhNDU2Mm
IxYjNlZjk4MWQ2MjViY2UiLCJhdWQiOiIwMzc2NTk3ODgyMTU0NWRiOTBjN2Y1YmE1ZDNmNWU1
NiIsIlBheWxvYWQiOiJ7XCJQYXltZW50XCI6e1wiVHlwZVwiOlwiQ0NBXCIsXCJQcm9jZXNzb3
JUcmFuc2FjdGlvbklkXCI6XCJHc2pMM1lkczVmWk80MzBXYk1RMFwiLFwiRXh0ZW5kZWREYXRh
XCI6e1wiQW1vdW50XCI6XCIxMTExXCIsXCJDdXJyZW5jeUNvZGVcIjpcIjk4NlwifX0sXCJFcn
Jvck51bWJlclwiOjAsXCJFcnJvckRlc2NyaXB0aW9uXCI6XCJTdWNjZXNzXCJ9In0.9oBbxbtu
hZyZaE_vuu6UzU-Mp5BjK2FNp5XAfoDy2uQ"
}
validate-request
{
"paymentAuthorization":{
"returnCode":"0",
"description":"Sucesso",
"paymentId":"020006204409231653310000023790740000000000",
"authorizationCode":"026603",
"orderNumber":"3979908797721",
"amount":1111,
"releaseAt":"2020-09-23T16:53:34+00:00"
},
"threeDs":{
"status":"Challenge",
"eci":"02",
"threeDsVersion":"2.2.0",
"paresStatus":"Y",
"threeDsStatus":"AUTHENTICATION_SUCCESSFUL"
}
}
validate-badrequest
{
"FailureDetails":[
{
"tag": "string",
"description": "motivo da falha"
}
]
}
titulo-impl-sdk-ios
link-download
link-download-texto-sdk-iostitulo-3ds-procedimento
3ds-procedimento-sdk-ioscampos-necessarios
campos-necessarios-texto tabela-1-sdk
{
"Payment":
{
"TransactionType": "debit",
"Amount":1111,
"CurrencyCode": "brl",
"ProductType": "debito",
"Installments": 1,
"CaptureType": "ac",
"Recurrent":false
},
"CardInfo":
{
"NumberToken":"d56109ce-6a3b-4190-beea-1c975e8cd486",
"CardholderName":"Luiz Silveira Neto",
"SecurityCode":"123",
"Brand": "mastercard",
"ExpirationMonth":"01",
"ExpirationYear":"29"
},
"SellerInfo":
{
"OrderNumber":"1110197548565",
"SoftDescriptor":"PAG*TESTE",
"UrlSite3DS":"empresa.ecommerce.com.br",
"Code3DS":"aa415dc21f4e4e7ca083a1473d5c4c58"
},
"Customer":
{
"DocumentType": "cpf",
"DocumentNumber":"51115672088",
"FirstName":"Luiz",
"LastName":"Silveira Neto",
"Email":"luiz.silveira@teste.rafael.com",
"PhoneNumber":"1122542454",
"MobilePhoneNumber":"11987683332",
"Address":"Rua Luiz Vieira, 134",
"Complement":"apto. 34 - Vila Guarani",
"City":"São Paulo",
"State":"SP",
"ZipCode":"09876-098",
"IpAddress":"45.233.232.248",
"Country":"BR"
},
"Sellers":[
],
"DeviceInfo":
{
"DeviceChannel":"SDK"
}
}
requisicao-payments
{
"paymentAuthorization":{
"returnCode":"0",
"description":"Sucesso",
"paymentId":"02008028610304095215000006201850000000",
"authorizationCode":"043711",
"orderNumber":"0000000001",
"expireAt":"2019-09-24T13:20:52.8775511-03:00",
"amount": 1035,
"releaseAt": "2019-09-24T13:20:52.8775511-03:00"
},
"threeDs":{
"status":"Silent",
"eci":"02",
"threeDsVersion":"2.1.0",
"veresEnrolled":"Y",
"paresStatus":"Y",
"threeDsStatus":"AUTHENTICATION_SUCCESSFUL"
}
}
tabela-2 tabela-3
{
"code3ds": "dbe5a61a-836d-45dd-82c1-52d0c5e3c010",
"validateToken":
"eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiI1ZWNkNzVkNjNlMzFiYzQ3MWExZWM2MWYiLCJpYXQi
OjE1OTQyMzI4MTcsImV4cCI6MTU5NDI0MDAxNywianRpIjoiYjFmNjEyZWEtMDRhZS00ZDY2LW
EzM2QtY2I1MjgwOGY4M2FlIiwiQ29uc3VtZXJTZXNzaW9uSWQiOiIwX2E3MGIzMjk0LTI1MTIt
NDc0ZS05OTcxLTZmZTk3YTllYWYzNiIsIlJlZmVyZW5jZUlkIjoiN2Y0ODc3YmVkODVhNDU2Mm
IxYjNlZjk4MWQ2MjViY2UiLCJhdWQiOiIwMzc2NTk3ODgyMTU0NWRiOTBjN2Y1YmE1ZDNmNWU1
NiIsIlBheWxvYWQiOiJ7XCJQYXltZW50XCI6e1wiVHlwZVwiOlwiQ0NBXCIsXCJQcm9jZXNzb3
JUcmFuc2FjdGlvbklkXCI6XCJHc2pMM1lkczVmWk80MzBXYk1RMFwiLFwiRXh0ZW5kZWREYXRh
XCI6e1wiQW1vdW50XCI6XCIxMTExXCIsXCJDdXJyZW5jeUNvZGVcIjpcIjk4NlwifX0sXCJFcn
Jvck51bWJlclwiOjAsXCJFcnJvckRlc2NyaXB0aW9uXCI6XCJTdWNjZXNzXCJ9In0.9oBbxbtu
hZyZaE_vuu6UzU-Mp5BjK2FNp5XAfoDy2uQ"
}
validate-request
{
"paymentAuthorization":{
"returnCode":"0",
"description":"Sucesso",
"paymentId":"020006204409231653310000023790740000000000",
"authorizationCode":"026603",
"orderNumber":"3979908797721",
"amount":1111,
"releaseAt":"2020-09-23T16:53:34+00:00"
},
"threeDs":{
"status":"Challenge",
"eci":"02",
"threeDsVersion":"2.2.0",
"paresStatus":"Y",
"threeDsStatus":"AUTHENTICATION_SUCCESSFUL"
}
}
validate-badrequest
{
"FailureDetails":[
{
"tag": "string",
"description": "motivo da falha"
}
]
}