O que é 3DS 2.0?

Para maiores detalhes sobre o 3DS 2.0, acesse: https://developercielo.github.io/manual/3ds

Passo 1 - Solicitação de Token de Acesso

A solução é composta pelo passo de solicitação de token de acesso via API e solicitação de autenticação a partir do APP.

Request

{
     "EstablishmentCode":"1006993069",
     "MerchantName": "Loja Exemplo Ltda",
     "MCC": "5912"
}

Response

{
      "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjbGllbnRfbmFtZSI6IlFBXzNEU19BdXRoZW50aWNhdG9yIiwiY2xpZW50X2lkIjoiZGJhM2E4ZGItZmE1NC00MGUwLThiYWItN2JmYjliNmYyZTJlIiwic2NvcGVzIjoie1wiU2NvcGVcIjpcIjNEU0F1dGhlbnRpY2F0b3JcIixcIkNsYWltc1wiOlt7XCJOYW1lXCI6XCJNZXJjaGFudE5hbWVcIixcIlZhbHVlc1wiOFwiVmFsdWVzXCI6W1wiNTU1NVwiXX0se1wiTmFtZVwiOlwiUmVmZXJlbmNlSWRcIixcIlZhbHVlc1wiOltcImY3MjE1YmQ3LWM0OTQtNGQ5Yi1NzEyfQ.daMqXko3dZOV0TzNFQ2vSsVSKqOsrwuswg7RB82ecAASSSSSSSSSSSSFFFFFFFFFFFFFGGGGGGGGGGGGGGGGGGGGGGGG",
      "token_type": "barear",
      "expires_in": "2018-07-23T11:29:32"
}

Passo 2 - Utilizando o SDK

Para utilizar o SDK é necessário realizar a importação do módulo Braspag3dsSdk:

import Braspag3dsSdk

Em seguida é necessário passar para o lado cliente(APP) o access_token gerado no passo anterior:

let braspag3ds = Braspag3ds(accessToken: "<<Access_Token gerado no passo 1>>", environment: Environment.production)

Em seguida é necessário utilizar o método authenticate, informando os dados do comprador e o callback que receberá a resposta:

braspag3ds.authenticate(orderData: OrderData(...),
                        cardData: CardData(...),
                        authOptions: OptionsData(...),
                        billToData: BillToData(...),
                        shipToData: ShipToData(...),
                        cart: [CartItemData(...),
                        deviceData: DeviceData(...),
                        userData: UserData(...),
                        airlineData: AirlineData(...),
                        mdd: MddData(...),
                        recurringData: RecurringData(...),
                        deviceIpAddress: "0.0.0.0"){ (status, authenticationResponse) in
                        
                        switch(status){
                        case .success:
                          ...
                        case .unenrolled:
                          ...
                        case failure:
                          ...
                        case error:
                          ...
                        case unsupportedBrand:
                          ...
                        }                  
  }

Parâmetros de entrada do método authenticate

Descrição dos Status do Callback

Descrição dos campos do AuthenticationResponse

Nota: No caso de uma transação submetida como Data Only (bpmpi_auth_notifyonly como true), mesmo que bem-sucedida, não serão retornados os campos CAVV e XID (campos não necessários para uma transação no modelo Data Only).

Detalhamento dos objetos da requisição

Para facilitar o uso somente daquilo que o lojista precisa enviar, a requisição é separada em diversos objetos com contexto de dados bem definido conforme a tabela dos parâmetros de entrada do authenticate mostra. Abaixo vamos detalhar cada um dos objetos utilziados.

OptionsData

OrderData

CardData

BillToData

ShipToData

CartItemData

DeviceData

UserData

AirlineData

TravelLeg

Passenger

MDD

RecurringData

Demais parâmetros

ECI (E-commerce Indicator)

E-Commerce Indicator (ECI) é retornado no processo de autenticação. Este código é um indicador do que exatamente ocorreu no processo de autenticação da transação. Por meio do ECI, pode-se verificar se a transação foi autenticada e quem foi o agente responsável por aquela autenticação, conforme tabela abaixo:

Cartões de Teste

Utilize os cartões de teste abaixo para simular diversos cenários no ambiente de SANDBOX

Autorização com Autenticação

Após autenticação ser concluída, submete-se ao processo de autorização, enviando os dados de autenticação no modelo de "autenticação externa" (nó ExternalAuthentication ). Veja maiores detalhes em: https://developercielo.github.io/manual/autorizacao-com-autenticacao

Últimas atualizações

Para visualizar as últimas atualizações do manual, clique aqui