3. Implementando o script

Neste passo, implemente o script e faça o mapeamento de classes responsáveis pela comunicação com as plataformas de autenticação das bandeiras e emissor. Siga o exemplo a seguir, que demonstra a implementação básica. Recomenda-se que o trecho seja colocado no final do código HTML de seu checkout, conforme o exemplo de uma implementação básica, a seguir:

<html>
  <head>
    <title>Sample</title>
    <script type="text/javascript">
      function sendOrder() {
        bpmpi_authenticate();
      }
    </script>
  </head>
  <body>
    <div>
      <h2>Sample</h2>

      <input type="hidden" name="authEnabled" class="bpmpi_auth" value="true" />
      <input
        type="hidden"
        name="authEnabledNotifyonly"
        class="bpmpi_auth_notifyonly"
        value="true"
      />
      <input
        type="hidden"
        name="accessToken"
        class="bpmpi_accesstoken"
        value="eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjbGllbnRfbmFtZSI6IlFBXzNEU19BdXRoZW50aWNhdG9yIiwiY2xpZW50X2lkIjoiZGJhM2E4ZGItZmE1NC00MGUwLThiYWItN2JmYjliNmYyZTJlIiwic2NvcGVzIjoie1wiU2NvcGVcIjpcIjNEU0F1dGhlbnRpY2F0b3JcIixcIkNsYWltc1wiOlt7XCJOYW1lXCI6XCJNZXJjaGFudE5hbWVcIixcIlZhbHVlc1wiOltcIk1QSSBRQSBTdG9yZVwiXX0se1wiTmFtZVwiOlwiRXN0YWJsaXNobWVudENvZGVcIixcIlZhbHVlc1wiOltcIjEwMDU1NVwiXX0se1wiTmFtZVwiOlwiTUNDXCIsXCJWYWx1ZXNcIjpbXCI1NTU1XCJdfSx7XCJOYW1lXCI6XCJSZWZlcmVuY2VJZFwiLFwiVmFsdWVzXCI6W1wiMzU5ZmYxZWItOTgzNi00ZWFkLTg0OTItYjFhMDZhMjljYTRiXCJdfV19IiwiaXNzIjoiaHR0cHM6Ly9hdXRoc2FuZGJveC5icmFzcGFnLmNvbS5iciIsImF1ZCI6IlVWUXhjVUEyY1NKMWZrUTNJVUVuT2lJM2RtOXRmbWw1ZWxCNUpVVXVRV2c9IiwiZXhwIjoxNTM4MDcwMTk0LCJuYmYiOjE1Mzc5ODM3OTR9.uvQlQENbJomrdaRWYkBPeBAILJV9LuMdu5n7owhANoI"
      />
      <div>
        <label>Order Number:</label>
        <input
          type="text"
          size="50"
          name="orderNumber"
          class="bpmpi_ordernumber"
          value="123456"
        />
      </div>
      <div>
        <label>Currency:</label>
        <select name="currency" class="bpmpi_currency">
          <option value="986" selected="selected">BRL</option>
          <option value="840">USD</option>
          <option value="032">ARS</option>
        </select>
      </div>
      <div>
        <label>Amount:</label>
        <input
          type="text"
          size="50"
          name="amount"
          class="bpmpi_totalamount"
          value="1000"
        />
      </div>
      <div>
        <label>Installments:</label>
        <input
          type="text"
          size="2"
          name="installments"
          class="bpmpi_installments"
          value="1"
        />
      </div>
      <div>
        <label>Payment Method:</label>
        <select name="paymentMethod" class="bpmpi_paymentmethod">
          <option value="credit" selected="selected">Credit</option>
          <option value="debit">Debit</option>
        </select>
      </div>
      <div>
        <label>Card Number:</label>
        <input
          type="text"
          size="50"
          name="cardNumber"
          class="bpmpi_cardnumber"
          value="4000000000000002"
        />
      </div>
      <div>
        <label>Expiration date:</label>
        <input
          type="text"
          size="50"
          name="expMonth"
          class="bpmpi_cardexpirationmonth"
          value="01"
        />
        <input
          type="text"
          size="50"
          name="expYear"
          class="bpmpi_cardexpirationyear"
          value="2021"
        />
      </div>
      <div>
        <label>Card Alias:</label>
        <input
          type="text"
          size="50"
          class="bpmpi_cardalias"
          value="cartaodoguilherme"
        />
      </div>
      <div>
        <label>Default:</label>
        <input type="text" size="50" class="bpmpi_default_card" value="true" />
      </div>
      <div>
        <label>Recurring End Date:</label>
        <input
          type="text"
          size="50"
          class="bpmpi_recurring_enddate"
          value="2021-01-16"
        />
      </div>
      <div>
        <label>Recurring Frequency:</label>
        <select class="bpmpi_recurring_frequency">
          <option value="1">Monthly</option>
          <option value="2">Bimonthly</option>
          <option value="3">Quarterly</option>
          <option value="4">FourMonths</option>
          <option value="6">SemiAnnual</option>
          <option value="12">Annual</option>
        </select>
      </div>
      <div>
        <label>Recurring Original Purchase Date:</label>
        <input
          type="text"
          size="50"
          class="bpmpi_recurring_originalpurchasedate"
          value="2019-08-01T15:30:50"
        />
      </div>
      <fieldset style="width: 0">
        <legend>Gift Card</legend>
        <div>
          <label>Amount:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_giftcard_amount"
            value="1000"
          />
          <!-- em centavos -->
        </div>
        <div>
          <label>Currency:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_giftcard_currency"
            value="BRL"
          />
        </div>
      </fieldset>
      <!-- dados de cobrança -->
      <fieldset style="width: 0">
        <legend>Billing Address</legend>
        <div>
          <label>Customer ID (CPF/CNPJ):</label>
          <input
            type="text"
            size="14"
            class="bpmpi_billto_customerid"
            value="12345678909"
          />
        </div>
        <div>
          <label>New Customer:</label>
          <select name="newCustomer" class="bpmpi_merchant_newcustomer">
            <option value="credit" selected="selected">true</option>
            <option value="debit">false</option>
          </select>
        </div>
        <div>
          <label>Name:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_billto_name"
            value="Comprador de Teste"
          />
        </div>
        <div>
          <label>Phone number:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_billto_phonenumber"
            value="999225626381"
          />
        </div>
        <div>
          <label>E-mail:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_billto_email"
            value="[email protected]"
          />
        </div>
        <div>
          <label>Street 1:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_billto_street1"
            value="Av Marechal Camara 160"
          />
        </div>
        <div>
          <label>Street 2:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_billto_street2"
            value="Sala 934 Centro"
          />
        </div>
        <div>
          <label>City:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_billto_city"
            value="Rio de Janeiro"
          />
        </div>
        <div>
          <label>State:</label>
          <input type="text" size="50" class="bpmpi_billto_state" value="RJ" />
        </div>
        <div>
          <label>Country:</label>
          <input type="text" size="2" class="bpmpi_billto_country" value="BR" />
        </div>
        <div>
          <label>Zipcode:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_billto_zipcode"
            value="20020080"
          />
        </div>
      </fieldset>
      <!-- dados de entrega (obs: se o "bpmpi_shipto_sameasbillto" for "true" não é necessário enviar os dados de entrega) -->
      <fieldset style="width: 0">
        <legend>Delivery Address</legend>
        <div>
          <label>Same as billing address:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_shipto_sameasbillto"
            value="false"
          />
        </div>
        <div>
          <label>Recipient:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_shipto_name"
            value="Destinatario de Teste"
          />
        </div>
        <div>
          <label>Phone number:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_shipto_phonenumber"
            value="552122326381"
          />
        </div>
        <div>
          <label>E-mail:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_shipto_email"
            value="[email protected]"
          />
        </div>
        <div>
          <label>Street 1:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_shipto_street1"
            value="Rua do Carmo 64"
          />
        </div>
        <div>
          <label>Street 2:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_shipto_street2"
            value="2º andar Centro"
          />
        </div>
        <div>
          <label>City:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_shipto_city"
            value="Rio de Janeiro"
          />
        </div>
        <div>
          <label>State:</label>
          <input type="text" size="50" class="bpmpi_shipto_state" value="RJ" />
        </div>
        <div>
          <label>Country:</label>
          <input type="text" size="2" class="bpmpi_shipto_country" value="BR" />
        </div>
        <div>
          <label>Zipcode:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_shipto_zipcode"
            value="20011020"
          />
        </div>
        <div>
          <label>Shipping Method:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_shipto_shippingmethod"
            value="lowcost"
          />
          <!-- ver domínio no manual -->
        </div>
        <div>
          <label>Last usage date:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_shipto_lastusagedate"
            value="2018-09-06"
          />
        </div>
      </fieldset>
      <!-- dados do device (coleção) -->
      <fieldset style="width: 0">
        <legend>Device</legend>
        <div>
          <label>Ip address:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_device_ipaddress"
            value="200.155.265.12"
          />
        </div>
        <div>
          <label>Fingerprint:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_device_1_fingerprint"
            value="04003hQUMXGB0poNf94lis1ztuLYRFk+zJ17aP79a9O8mWOBmEnKs6ziAo94ggAtBvKEN6/FI8Vv2QMAyHLnc295s0Nn8akZzRJtHwsEilYx"
          />
        </div>
        <div>
          <label>Provider:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_device_1_provider"
            value="cardinal"
          />
          <!-- ver domínio no manual -->
        </div>
      </fieldset>
      <!-- dados do carrinho (coleção) -->
      <table border="1">
        <caption>
          Cart
        </caption>
        <thead>
          <tr>
            <th>Item</th>
            <th>Description</th>
            <th>Sku</th>
            <th>Quantity</th>
            <th>Unit Price</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td>
              <input
                type="text"
                class="bpmpi_cart_1_name"
                value="ostarine mk-2866"
              />
            </td>
            <td>
              <input
                type="text"
                class="bpmpi_cart_1_description"
                value="Estimula o aumento da massa muscular e da força"
              />
            </td>
            <td>
              <input
                type="text"
                class="bpmpi_cart_1_sku"
                value="10000000000234"
              />
            </td>
            <td>
              <input type="text" class="bpmpi_cart_1_quantity" value="2" />
            </td>
            <td>
              <input type="text" class="bpmpi_cart_1_unitprice" value="450" />
              <!-- em centavos -->
            </td>
          </tr>
          <tr>
            <td>
              <input
                type="text"
                class="bpmpi_cart_2_name"
                value="ostarine mk-2867"
              />
            </td>
            <td>
              <input
                type="text"
                class="bpmpi_cart_2_description"
                value="Estimula mais aumento da massa muscular e da força"
              />
            </td>
            <td>
              <input
                type="text"
                class="bpmpi_cart_2_sku"
                value="10000000000235"
              />
            </td>
            <td>
              <input type="text" class="bpmpi_cart_2_quantity" value="3" />
            </td>
            <td>
              <input type="text" class="bpmpi_cart_2_unitprice" value="550" />
              <!-- em centavos -->
            </td>
          </tr>
        </tbody>
      </table>
      <!-- dados de aérea (coleção de trechos) -->
      <table border="1">
        <caption>
          Travel legs
        </caption>
        <thead>
          <tr>
            <th>Carrier</th>
            <th>Departure Date</th>
            <th>Origin</th>
            <th>Destination</th>
          </tr>
        </thead>

        <tbody>
          <tr>
            <td>
              <input
                type="text"
                class="bpmpi_airline_travelleg_1_carrier"
                value="G3"
              />
            </td>
            <td>
              <input
                type="text"
                class="bpmpi_airline_travelleg_1_departuredate"
                value="2018-09-21"
              />
            </td>
            <td>
              <input
                type="text"
                class="bpmpi_airline_travelleg_1_origin"
                value="SDC"
              />
            </td>
            <td>
              <input
                type="text"
                class="bpmpi_airline_travelleg_1_destination"
                value="GIG"
              />
            </td>
          </tr>
          <tr>
            <td>
              <input
                type="text"
                class="bpmpi_airline_travelleg_2_carrier"
                value="G3"
              />
            </td>
            <td>
              <input
                type="text"
                class="bpmpi_airline_travelleg_2_departuredate"
                value="2018-09-22"
              />
            </td>
            <td>
              <input
                type="text"
                class="bpmpi_airline_travelleg_2_origin"
                value="GIG"
              />
            </td>
            <td>
              <input
                type="text"
                class="bpmpi_airline_travelleg_2_destination"
                value="SDC"
              />
            </td>
          </tr>
        </tbody>
      </table>
      <!-- dados de passageiros (coleção) -->
      <table border="1">
        <caption>
          Passengers
        </caption>
        <thead>
          <tr>
            <th>Name</th>
            <th>Ticket Price</th>
          </tr>
        </thead>

        <tbody>
          <tr>
            <td>
              <input
                type="text"
                class="bpmpi_airline_passenger_1_name"
                value="Chuck Norris"
              />
            </td>
            <td>
              <input
                type="text"
                class="bpmpi_airline_passenger_1_ticketprice"
                value="450"
              />
              <!-- em centavos -->
            </td>
          </tr>
          <tr>
            <td>
              <input
                type="text"
                class="bpmpi_airline_passenger_2_name"
                value="Charles Bronson"
              />
            </td>
            <td>
              <input
                type="text"
                class="bpmpi_airline_passenger_2_ticketprice"
                value="550"
              />
              <!-- em centavos -->
            </td>
          </tr>
        </tbody>
      </table>
      <!-- dados de aérea complementares -->
      <fieldset style="width: 0">
        <legend>Airline Aditional Data</legend>
        <div>
          <label>Number of passengers:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_airline_numberofpassengers"
            value="2"
          />
        </div>
        <div>
          <label>Passport Country:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_airline_billto_passportcountry"
            value="BR"
          />
        </div>
        <div>
          <label>Passport Number:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_airline_billto_passportnumber"
            value="4849494984911"
          />
        </div>
        <div>
          <label>MDD1:</label>
          <input type="text" size="50" class="bpmpi_mdd1" value="mdd1" />
        </div>
        <div>
          <label>MDD2:</label>
          <input type="text" size="50" class="bpmpi_mdd2" value="mdd2" />
        </div>
        <div>
          <label>MDD3:</label>
          <input type="text" size="50" class="bpmpi_mdd3" value="mdd3" />
        </div>
        <div>
          <label>MDD4:</label>
          <input type="text" size="50" class="bpmpi_mdd4" value="mdd4" />
        </div>
        <div>
          <label>MDD5:</label>
          <input type="text" size="50" class="bpmpi_mdd5" value="mdd5" />
        </div>
      </fieldset>
      <!-- dados do pedido -->
      <fieldset style="width: 0">
        <legend>Order</legend>
        <div>
          <label>Transaction Mode:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_transaction_mode"
            value="R"
          />
        </div>
        <div>
          <label>Merchant URL:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_merchant_url"
            value="http://www.loja.com.br"
          />
        </div>
        <div>
          <label>Recurrence:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_order_recurrence"
            value="false"
          />
        </div>
        <div>
          <label>Product code:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_order_productcode"
            value="PHY"
          />
          <!-- ver domínio no manual -->
        </div>
        <div>
          <label>Last 24 hours count:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_order_countlast24hours"
            value="1"
          />
        </div>
        <div>
          <label>Last 6 month count:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_order_countlast6months"
            value="8"
          />
        </div>
        <div>
          <label>Last year count:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_order_countlast1year"
            value="55"
          />
        </div>
        <div>
          <label>Card attempts on last 24 hours:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_order_cardattemptslast24hours"
            value="3"
          />
        </div>
        <div>
          <label>Marketing optin:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_order_marketingoptin"
            value="false"
          />
        </div>
        <div>
          <label>Marketing source:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_order_marketingsource"
            value="mercadolivre"
          />
        </div>
      </fieldset>
      <!-- dados do usuário/conta -->
      <fieldset style="width: 0">
        <legend>User account</legend>
        <div>
          <label>Guest:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_useraccount_guest"
            value="true"
          />
        </div>
        <div>
          <label>Created date:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_useraccount_createddate"
            value="2018-08-01"
          />
        </div>
        <div>
          <label>Changed date:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_useraccount_changeddate"
            value="2018-09-06"
          />
        </div>
        <div>
          <label>Password changed date:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_useraccount_passwordchangeddate"
            value="2018-09-06"
          />
        </div>
        <div>
          <label>Authentication method:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_useraccount_authenticationmethod"
            value="02"
          />
          <!-- ver domínio no manual -->
        </div>
        <div>
          <label>Authentication protocol:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_useraccount_authenticationprotocol"
            value="oauth"
          />
        </div>
        <div>
          <label>Authentication timetamp:</label>
          <input
            type="text"
            size="50"
            class="bpmpi_useraccount_authenticationtimestamp"
            value="201809061510"
          />
        </div>
      </fieldset>
      <input
        type="button"
        onclick="sendOrder()"
        value="Send Order"
        id="btnSendOrder"
      />
    </div>
  </body>

  <script type="text/javascript">
    var env = getQueryString("env");

    function bpmpi_config() {
      return {
        onReady: function () {
          // Evento indicando quando a inicialização do script terminou.
          document.getElementById("btnSendOrder").disabled = false;
        },
        onSuccess: function (e) {
          // Cartão elegível para autenticação, e portador autenticou com sucesso.
          var cavv = e.Cavv;
          var xid = e.Xid;
          var eci = e.Eci;
          var version = e.Version;
          var referenceId = e.ReferenceId;
        },
        onFailure: function (e) {
          // Cartão elegível para autenticação, porém o portador finalizou com falha.
          var xid = e.Xid;
          var eci = e.Eci;
          var version = e.Version;
          var referenceId = e.ReferenceId;
        },
        onUnenrolled: function (e) {
          // Cartão não elegível para autenticação (não autenticável).
          var xid = e.Xid;
          var eci = e.Eci;
          var version = e.Version;
          var referenceId = e.ReferenceId;
        },
        onDisabled: function () {
          // Loja não requer autenticação do portador (classe "bpmpi_auth" false -> autenticação desabilitada).
        },
        onError: function (e) {
          // Erro no processo de autenticação.
          var xid = e.Xid;
          var eci = e.Eci;
          var returnCode = e.ReturnCode;
          var returnMessage = e.ReturnMessage;
          var referenceId = e.ReferenceId;
        },
        onUnsupportedBrand: function (e) {
          // Bandeira não suportada para autenticação.
          var returnCode = e.ReturnCode;
          var returnMessage = e.ReturnMessage;
        },
        Environment: env ? env : "SDB",
        Debug: true,
      };
    }

    function getQueryString(field) {
      var href = window.location.href;
      var reg = new RegExp("[?&]" + field + "=([^&#]*)", "i");
      var string = reg.exec(href);
      return string ? string[1] : null;
    }
  </script>
  <script src="/Scripts/BP.Mpi.3ds20.min.js" type="text/javascript"></script>
</html>

Descrição dos eventos

Os eventos são ações que o script toma como resposta para acompanhamento do processo de autenticação, mas não indicam se a transação foi autenticada com sucesso.

O valor retornado no ECI (E-commerce Indicator) é o que indica se a transação foi autenticada ou não e de quem é o risco de chargeback. Para submeter a transação para autorização, considere o valor do ECI e use os eventos apenas como complemento para auxiliar na tomada de decisão.

⚠️

Atenção

É possível submeter uma transação não autenticada para autorização; no entanto, o risco de chargeback passa a ser do estabelecimento.

EventoDescrição
onReadyÉ acionado quando todos os procedimentos de carregamento do script da solução foram concluídos com sucesso, o que inclui a validação do token de acesso, indicando que o checkout está pronto para iniciar a autenticação.
onSuccessÉ acionado quando o cartão é elegível e teve o processo de autenticação finalizado com sucesso. Neste caso, as variáveis CAVV, XID e ECI serão retornadas. Estas variáveis devem ser enviadas na requisição de autorização. Neste cenário, se a transação é autorizada, o liability shift é transferido ao emissor.
onFailureÉ acionado quando o cartão é elegível, porém o processo de autenticação falhou por algum motivo. Neste caso, somente a variável ECI será retornada. Caso haja a decisão de seguir com a autorização mesmo assim, o ECI deverá ser enviado no momento da autorização. Neste cenário, se a transação é autorizada, o liability shift permanece com o estabelecimento.
onUnenrolledÉ acionado quando o cartão não é elegível, ou seja, o portador e/ou emissor não participam do programa de autenticação. Neste caso, orientar o comprador a verificar junto ao emissor se o cartão está habilitado para realizar autenticação no e-commerce. Somente a variável ECI será retornada. Caso haja a decisão de seguir com a autorização mesmo assim, o ECI deverá ser enviado no momento da autorização. Neste cenário, se a transação é autorizada, o liability shift permanece com o estabelecimento.
onDisabledÉ acionado quando o estabelecimento optou por não submeter o portador ao processo de autenticação (classe bpmpi\_auth como false). Neste cenário, se a transação é autorizada, o liability shift permanece com o estabelecimento.
onErrorÉ acionado quando o processo de autenticação recebeu um erro sistêmico. Neste cenário, se a transação é autorizada, o liability shift permanece com o estabelecimento.
onUnsupportedBrandÉ acionado quando a bandeira do cartão não é suportada pelo 3DS.

Descrição dos parâmetros de entrada

ParâmetroDescriçãoTipo
EnvironmentIndica o ambiente a ser utilizado (Sandbox ou Produção)SDB – Sandbox (ambiente de teste)
PRD – Produção (ambiente de produção)
DebugBooleano que indica se o modo debug está ativado ou não. Quando true, a plataforma emitirá o relatório no mecanismo de debug do browser.Não é recomendado deixar o modo debug ativado no ambiente de produção.Booleano
true – modo debug ativado
false – modo debug desativado

IMPORTANTE:
O arquivo JavaScript deve ser salvo no servidor onde está a aplicação da loja. Para baixar o arquivo, acesse https://bit.ly/2CSOp2n.

Descrição das saídas

SaídaDescriçãoTipoTamanho
CavvDado que representa assinatura da autenticaçãoTexto-
XidID que representa a requisição da autenticaçãoTexto-
EciCódigo indicador do e-commerce, que representa o resultado da autenticaçãoNuméricoaté 2 posições
VersionVersão do 3DS aplicado no processo de autenticação. Valores possíveis: "2.2.0" ou "2.1.0".Numérico5 posições
ReferenceIDID que representa a requisição de autenticaçãoGUID36 posições
ReturnCodeCódigo de retorno da requisição de autenticaçãoAlfanuméricoaté 5 posições
ReturnMessageMensagem de retorno da requisição de autenticaçãoAlfanuméricovariável

Exemplo de retorno do script

Exemplo de evento OnSuccess

{
  Cavv: 'Y2FyZGluYWxjb21tZXJjZWF1dGg=',
  Xid: null,
  Eci: '01',
  Version: '2.2.0',
  ReferenceId: '973cf83d-b378-43d5-84b6-ce1531475f2a'
}

Exemplo de evento OnFailure

{
  Xid: null,
  Eci: null,
  ReturnCode: '231',
  ReturnMessage: 'Unexpected error ocurred',
  ReferenceId: null
}

Exemplo de retorno para bandeira não suportada

Quando a bandeira não é suportada pelo 3DS, o MPI retorna o código "MPI 600" e a mensagem "Brand not supported for authentication".

{
  Xid: null,
  Eci: null,
  ReturnCode: 'MPI600',
  ReturnMessage: 'Brand not supported for authentication',
  ReferenceId: null
}

Confira os valores possíveis de ReturnCodes na tabela Lista de Return Codes .