Parámetros opcionales del JSON:

1. tokenize: De tipo Boolean. Parámetro que indica si se desea tokenizar la tarjeta después de realizar el pago. (true = tokeniza, false= no tokeniza).

1.2. Crear objeto JSON con los datos de la tarjeta para procesar con Credix

3. Cifrar el objeto tipo JSON que contiene la información de la tarjeta o el token.

Por razones de seguridad, tanto para GreenPay como para proteger su comercio se requiere que la información de la tarjeta o el token se envíe encriptada. Para cifrar estos datos, se debe utilizar el algoritmo de encriptación “AES-CTR-128”.  

Si esta información no se cifra el algoritmo "AES-CTR-128" , el servicio de pagos rechazará la solicitud pago.

En https://gitlab.com/gp-examples/checkout/checkout_csharp se encuentran unos ejemplos de cifrado con AES-CTR-128 desarrollados en C#, uno se desarrolló sin librerías externas y otro utiliza la librería “BouncyCastle”. Además de otro desarrollado en NodeJS con la librería Aes JS .

A continuación, se muestran los pasos a seguir para cifrar la información de la tarjeta.

• Generar dinámicamente un par de llaves AES (Key , Counter), las cuales se utilizarán para cifrar la información de la tarjeta.
  
• Cada llave es un arreglo de 16 bytes.
  
• El key contiene la llave para cifrar en AES.
  
• El Counter es el contador para el modo CTR de AES.
  
• Cifrar el objeto JSON con los datos de la tarjeta, y convertir el resultado del cifrado a formato hexadecimal.
  
• El string en formato hexadecimal corresponde al valor “ld” que se debe enviar en el “body” de la solicitud de pago
  
• El valor “ld” que debe enviar en el body de la solicitud de pago, corresponde al string en formato hexadecimal que se obtiene al cifrar el objeto JSON que contiene la información de la tarjeta con AES-CTR-128
  
• Cifrar con RSA las llaves AES (key, counter) con la llave pública provista por “GreenPay support team”.
  
• El string en formato base64 que se obtiene de cifrar el par de llaves AES, corresponde al valor “lk” que se debe enviar en el “body” de la solicitud de pago.
  
• El valor “lk” que se debe enviar en el body de la solicitud de pago corresponde a la codificación en base64 del cifrado de las llaves AES.
  

1. Para generar el par de claves AES, se utiliza la biblioteca de JavaScript aes-js, y el código de ejemplo siguiente:
   
   public generateAESPairs () {
   

   let key = []
   

   var iv = 0;
   

   for (let k = 0; k < 16; k++) {
   

   key.push(Math.floor(Math.random() * 255))
   

   }
   

   for (let k = 0; k < 16; k++) {
   

   iv = Math.floor(Math.random() * 255)
   

   }
   

   return {
   

   k: key,
   

   s: iv
   

   }
   

   }
   
2. Para encriptar los datos de la tarjeta se utiliza el algoritmo RSA con la biblioteca de JavaScript jsencrypt, 
   
    y el código de ejemplo siguiente:
   
   Los parámetros de la función son obj (el objeto con los datos de la tarjeta y el kountSession), session (la sesión que se genera en la orden de compra) y pair_ (un undefined). La función retorna el objeto especificado en el siguiente punto Crear un objeto de tipo JSON con los datos cifrado anteriormente.
   
   
   public pack(obj, session, pair_) {
   

   var pair = (pair_ !== undefined) ? pair_ : this.generateAESPairs();
   

   var textBytes = AesModule.utils.utf8.toBytes(JSON.stringify(obj));
   

   var aesCtr = new AesModule.ModeOfOperation.ctr(pair.k, new AesModule.Counter(pair.s));
   

   var encryptedBytes = aesCtr.encrypt(textBytes);
   

   var encryptedHex = AesModule.utils.hex.fromBytes(encryptedBytes);
   

   var returnObj = {
   

   session: session,
   

   ld: encryptedHex,
   

   lk: this.rsa_.encrypt(JSON.stringify(pair))
   

   };
   

   return returnObj;
   

   }
   

4. Crear un objeto de tipo JSON con los datos cifrados anteriormente.

Se debe crear un objeto de tipo JSON que contenga los resultados del proceso de cifrado anterior (lk, ld) y la sesión obtenida en el articulo "Crear una orden de pago"  , este JSON debe estar estructurado de la siguiente forma:

Con la respuesta obtenida, el comercio deberá actualizar la compra del cliente respectivo.