Tokenizar Tarjeta

Para poder tokenizar una tarjeta es necesario utilizar nuestro archivo NetpayJS que se puede cargar desde un CDN o se puede utilizar directamente desde un archivo JS que guardes en tu proyecto.
Lo que nuestro NetpayJS hará será hacer el proceso necesario para poder encriptar los datos bancarios de tu cliente mandarlos a nuestros servidores y nosotros te devolveremos un token con el cual este cliente podrá transaccionar en nuestra API.

Ejemplo NetpayJS

CDN: https://docs.netpay.mx/cdn/v1.3/netpay.min.js

<!DOCTYPE html>
<html>
<head>
  <title>NetPay.js</title>
  <meta http-equiv="content-type" content="text/html;charset=utf-8" />
  <script type="text/javascript" src="https://docs.netpay.mx/cdn/v1.3/netpay.min.js"></script>
  
</head>
  <body style="padding: 50px;">
        <div id="netpay-form"></div>
        <script>  
            NetPay.setApiKey("pk_netpay_ryDNhWywMbMjqXbLzMUEeTMfW");
            NetPay.setSandboxMode(true);
        
            function success(e) {
                console.log("Token created successfully");
                console.log(e); 
            }
        
            function error(e) {
                console.log("Something went wrong!");
                console.log(e);
            }
        
            NetPay.form.generate("netpay-form", success, error, { title: "", submitText: "" });
            
        </script>
  </body> 
</html>

Anatomía NetpayJS

Inicialización

Netpay.setApiKey("PUBLIC_API_KEY");

Modo Sandbox
NetpayJS opera en dos ambientes, producción y sandbox, para indicar el modo
sandbox es necesario indicarlo de la siguiente manera.

NetPay.setSandboxMode(true);

Manejo de respuestas

NetpayJS regresa los resultados de la operación por medio de funciones de
respuesta ( callbacks ), estas funciones reciben objetos con la respuesta.

Las funciones de respuesta se pasan como argumentos al momento de inicializar un
formulario o al momento de llamar la función NetPay.form.generate();

NetPay.form.generate("netpay-form", success, error, { title: "Pago con tarjeta", submitText: "Pagar" });

La operación de tokenización puede concluir de dos maneras, satisfactoriamente o con
error, para ambos casos se declara una función que recibe la respuesta.

Ejemplo de respuesta al momento de tokenizar

{
   "token":"token_kBUuPLrNJszmMVbMpYuqPGuPBFLRJemeJJjIoZnx",
   "lastFourDigits":"0002",
   "brand":"visa",
   "bank":"Test bank",
   "type":"debit",
   "country":"unknown",
   "scheme":"unknown",
   "cardPrefix":"400000"
}

Formulario para tokenizacion creado por el comercio.

NetPay.js cuenta con herramientas para generar un token de una tarjeta sin necesidad de
utilizar el formulario auto-generado por la librería. Solo se requiere invocar la función
NetPay.token.create()

<html>

<head>
    <script type="text/javascript" src="https://docs.netpay.mx/cdn/v1.3/netpay.min.js"></script>
</head>

<body style="padding: 50px;">
    <script>
        let deviceFingerPrint;
        NetPay.setSandboxMode(true); // Esta línea se debe de llamar antes de la generación del device fingerprint

        //La generación del device fingerprint debe de estar al momento en que se visualiza el formulario de pago
        function generateDevice(callback) {
            deviceFingerPrint = NetPay.form.generateDeviceFingerPrint();
            callback();
        }
        
        generateDevice(function() { 
            console.log(deviceFingerPrint);
            let cardInformation = {
                cardNumber: "4000000000000002",
                expMonth: "04",     
                expYear: "25",
                cvv2: "999",
                vault: true,
                simpleUse:false,
                deviceFingerPrint : deviceFingerPrint
            };
            NetPay.setApiKey("pk_netpay_JGFtQNUFIENMlhkoBXdgiozmQ");

            var validateNumber = NetPay.card.validateNumber(cardInformation.cardNumber);
            var validateExpiry = NetPay.card.validateExpiry(cardInformation.expMonth, cardInformation.expYear);
            var validateCVV = NetPay.card.validateCVV(cardInformation.cvv2, cardInformation.cardNumber);
            var validateNumberLength = NetPay.card.validateNumberLength(cardInformation.cardNumber);

            if (!validateNumberLength || !validateNumber 
                || !validateExpiry || !validateCVV) {
                alert("Por favor, verifica los datos de tu tarjeta");
                return false;
            }
            NetPay.token.create(cardInformation, success, error);

            function success(e) {
                console.log("Token created successfully");
                console.log(e.message.data);
            }

            function error(e) {
                console.log("Something went wrong!");
                console.log(e);
            }
        });
    </script>
</body>

</html>

Manejo de respuesta

NetPay.js regresa los resultados de la operación por medio de funciones de
respuesta ( callbacks ), estas funciones reciben objetos con la respuesta.

Las funciones de respuesta se pasan como argumentos al momento de inicializar un
formulario o al momento de llamar la función NetPay.token.create().

Validaciones

NetPay.js cuenta con funciones que ayudan validar los datos utilizados para la tokenización
de una tarjeta. Las validaciones de la tarjeta se hacen a través del objeto NetPay.card, este
objeto cuenta con las siguiente funciones de validación:

validateCVV

Esta función ayuda a validar si el CVV es válido en función al número de tarjeta de la tarjeta
a tokenizar. La función regresa true o false según la validación.

Parámetro	Descripción	Tipo de dato
cvv	Valor del cvv de la tarjeta a tokenizar	String
cardNumber	Numero de la tarjeta a tokenizar	String

Ejemplo de uso

NetPay.card.validateCVV("123","400000000000002");

validateExpiry

Esta función ayuda a validar la fecha de expiración, tanto el formato mm/aa así
como si la fecha ingresada no está expirada. La función regresa true o false según la
validación.


month	Recibe el mes en formato de 2 dígitos	String
year	Recibe el año en formato de 2 dígitos	String

Ejemplo de uso

NetPay.card.validateExpiry("01","25");