English

Tokenização

Nossa biblioteca é fácil de usar e versátil; você pode utilizá-la com vários frameworks e com JavaScript puro em seu frontend.

Veja o diagrama abaixo

Alt text

Apresentaremos exemplos de como usar nossa biblioteca. No entanto, observe que esses são exemplos introdutórios e podem não ser necessariamente a escolha certa em termos de arquitetura. Isso dependerá das especificidades do seu produto e da sua equipe.

Incluindo paag-tokenization.js

Info

Html

<script
  type="text/javascript"
  src="https://js.paag.io/paag-tokenization-min.js"
></script>

Criando um Token de Cartão de Crédito

Info

JavaSript

Paag.createPaymentToken(
  {
    first_name: "João",
    last_name: "Doe",
    number: "4111111111111111",
    verification_value: "123",
    expiration: "12/26",
  },
  function (response) {
    if (response.errors) {
      alert("Erro salvando cartão");
    } else {
      alert("Token criado:" + response.id);
    }
  }
);

Criando um objeto Cartão de Crédito

Info

JavaSript

cc = Paag.CreditCard(
  "4111111111111111",
  "12",
  "2017",
  "Nome",
  "Sobrenome",
  "123"
);

Os parâmetros são, respectivamente:

Número do Cartão de Crédito
Mês de Vencimento
Ano de Vencimento
Nome próprio
Sobrenome
CVV

O objeto CreditCard possui uma função valid() que valida o cartão de crédito e retorna um booleano (true ou false).

Funções Utilitárias

Validar Número do Cartão de Crédito

Info

Java

Paag.utils.validateCreditCardNumber("4111111111111111"); // Returns true
Paag.utils.validateCreditCardNumber("3213"); // Returns false

Validar o CVV

Valida o número de verificação de acordo com a bandeira.

As bandeiras suportadas são "visa", "mastercard", "amex", "diners" e "elo".

Info

JavaSript

Paag.utils.validateCVV("123", "visa"); // Returns true
Paag.utils.validateCVV("1234", "amex"); // Returns true
Paag.utils.validateCVV("3213", "mastercard"); // Returns false

Validar a Expiração

Valida a data de expiração com o mês e o ano.

Supondo que a data de hoje seja dezembro de 2013, temos os seguintes exemplos:

Info

JavaSript

Paag.utils.validateExpiration(12, 2018); // Returns true
Paag.utils.validateExpiration(11, 2016); // Returns false
Paag.utils.validateExpiration(11, 2019); // Returns true

Validar String de Expiração

Valida a data de vencimento com uma string no formato DD/YYYY ou DD/YY.

Supondo que a data de hoje seja dezembro de 2013, temos os seguintes exemplos:

Info

JavaSript

Paag.utils.validateExpirationString("12/2018"); // Returns true
Paag.utils.validateExpirationString("11/2016"); // Returns false
Paag.utils.validateExpirationString("11/19"); // Returns true

Está Bloqueado pelo AdBlock

Retorna se existe algum AdBlock impedindo que o paag-tokenization.js funcione corretamente.

Info

JavaSript

Paag.utils.isBlockedByAdBlock(); // Retorna true se houver um adBlock impedindo a operação correta e false caso contrário.

Obter Marca pelo Número do Cartão de Crédito

Info

JavaSript

Paag.utils.getBrandByCreditCardNumber("4111111111111111"); // Returns "visa"
Paag.utils.getBrandByCreditCardNumber("5555555555554444"); // Returns "mastercard"
Paag.utils.getBrandByCreditCardNumber("123321"); // Returns false