1. Tokenizar tarjeta

Formulario para tokenización creado por NetPay

Para poder tokenizar una tarjeta puedes utilizar nuestra librería NetpayJS que se puede importar desde una CDN, o bien, se puede utilizar directamente descargando la librería JS y guardandola en tu proyecto.
Lo que nuestro librería NetpayJS hará es encriptar los datos bancarios de tu cliente para enviarlos a nuestros servidores y una vez procesada la información, nosotros te devolveremos un token con el cual el cliente podrá comenzar una transacción 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">
    <!-- Aquí se cargará el formulario predeterminado de NetPay -->
    </div>
    <script>
      function success(e) {
        console.log("Token creado correctamente");
        console.log(e);
      }
      
      function error(e) {
        console.log("¡Algo ha salido mal!");
        console.log(e);
      }
      
      let formTitle = "Pagar con NetPay";
      let paymentBtnText = "Completar Pago";
      
      NetPay.setApiKey("pk_netpay_ryDNhWywMbMjqXbLzMUEeTMfW");
      NetPay.setSandboxMode(true);
      NetPay.form.generate("netpay-form", success, error, 
                           { title: formTitle, submitText: paymentBtnText });
    </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 operar sobre 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 JSON 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.

🚧
Atención
Al momento de tokenizar una tarjeta con NetpayJS el token que te devolverá hasta este punto solo será de un solo uso y se invalidará para un segundo uso si no se le asigna un cliente antes de procesar otro pago con este token de la tarjeta.

Formulario para tokenización creado por el comercio

NetPayJS cuenta con herramientas para generar el token de una tarjeta sin necesidad de utilizar el formulario predeterminado de la librería. Solo se requiere invocar la función NetPay.token.create().

❗️
Importante
Al utilizar esta función se tendrá que validar en el código fuente que no se almacene ninguna información bancaria sin tokenizar por parte del comercio, solo se deberá usar en variables temporales para pasarlas como argumento a nuestra función y poder obtener el token de transacción. Lo anterior será validado durante la certificación en ambiente sandbox.
NetPay tendrá registro de esta certificación y en dado caso que se realice algún cambio al código fuente que afecte el flujo de pago anteriormente descrito será necesario agendar una nueva certificación.

Código de ejemplo

<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",
                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 JSON 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

NetPayJS cuenta con funciones que ayudan a 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 del número de 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	Número 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 validar que la fecha ingresada no está expirada. La función regresa true o false según la validación.

Parámetro	Descripción	Tipo de dato
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");

validateNumberLength

Esta función ayuda a validar la longitud de la tarjeta en función del tipo de tarjeta que sea (VISA, MasterCard o AmericanExpress). La función regresa true o false según la validación.

Parámetro	Descripción	Tipo de dato
cardNumber	Recibe el número de la tarjeta	String

Ejemplo de uso

NetPay.card.validateNumberLength("5200000000000007");

validateNumber

Esta función ayuda a validar el número de la tarjeta, es decir, que la tarjeta introducida sea correcta y no solo número aleatorios que simulen pertenecer a una tarjeta. La función regresa true o false según la validación.

Parámetro	Descripción	Tipo de dato
cardNumber	Recibe el número de la tarjeta	String

Ejemplo de uso

NetPay.card.validateNumber("5200000000000007");