Plugins & SDKsReferencias APIAyudaForoReunión TécnicaFAQs
Referencias API

Tokenizar Tarjeta de Suscripcion

🚧

Importante

Es necesario que ya tengas tu cuenta de Netpay Manager para poder ejecutar la tokenizacion con tus llaves de pruebas.

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 Pruebas: https://docs.netpay.mx/cdn/js/dev/netpay.154.js
CDN Producción: 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/js/dev/netpay.154.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() 

<!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/js/dev/netpay.154.js"></script>
  
</head>
  <body style="padding: 50px;">
        <div id="netpay-form"></div>
        <script>
        NetPay.setApiKey("pk_netpay_ryDNhWywMbMjqXbLzMUEeTMfW");
        NetPay.setSandboxMode(true);
          
         let cardInformation = {
            cardNumber: "4000000000000002",
            expMonth: "01",
            expYear: "25",
            cvv2:"123",
            cardHolderName: "Jon Doe",
          };
        
            function success(e) {
                console.log("Token created successfully");
                console.log(e); 
            }
        
            function error(e) {
                console.log("Something went wrong!");
                console.log(e);
            }
        
            NetPay.token.create(cardInformation, success, error, { title: "", submitText: "" });
            
        </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ámetroDescripciónTipo de dato
cvvValor del cvv de la tarjeta a tokenizarString
cardNumberNumero de la tarjeta a tokenizarString

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.

ParámetroDescripciónTipo de dato
monthRecibe el mes en formato de 2 dígitosString
yearRecibe el año en formato de 2 dígitosString

Ejemplo de uso

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