Proceso de tokenización con formulario

Proceso de tokenización con formulario

Consideraciones

Para utilizar el formulario de tokenización de tarjetas se debe considerar lo siguiente:
  1. El formulario está disponible en:
    1. Sandbox: http://sandbox-tokenizeform.greenpay.me/
    2. Producción: https://tokenizeform.greenpay.me/
  2. Se requiere tener una session y token de una orden de tokenización que no haya excedido los 30 minutos establecidos de vencimiento. Además, la orden debió ser creada con el parámetro callback.
  3. Para ver cómo crear una orden de tokenización  y agregar el parámetro  callback visite este enlace.
  4. El formulario de tokenización de Greenpay solo está disponible para aplicaciones web.

Pasos para uso del formulario

1. Redireccionar al formulario de tokenización

Con la respuesta (session, token) obtenida en la orden de tokenización, se debe redireccionar desde el sitio del comercio hacia el formulario de Greenpay, de la siguiente manera:
  1. Generar la orden de tokenización (session y token) en sandbox o producción, según el ambiente.
  2. Construir la URL:
    1. Sandbox: http://sandbox-tokenizeform.greenpay.me/{{session}}
    2. Producción: https://tokenizeform.greenpay.me/{{session}}
A continuación, se muestra un ejemplo en javascript de cómo hacer el redireccionamiento.
  1. const express = require("express");
        const app = express();
       
        app.use(bodyParser.json());
        app.use(bodyParser.urlencoded({
        extended: true
        }));
       
        app.get("/order", async function (req, res) {
        try {
            const security = await postOrder(order);
            //console.log(security);
            console.log("https://sandbox-tokenizeform.greenpay.me/"+ security.session);
            res.redirect("https://sandbox-tokenizeform.greenpay.me/"+ security.session);
            }
            catch (err) {
                res.send(err);
            }
        });

Al hacer el redireccionamiento, se les presentará el siguiente formulario:



2. Capturar la repuesta del formulario

Cuando se obtiene la respuesta, el formulario la envía al URL callback de la orden de tokenización. La respuesta es un JSON codificado en BASE64, como se muestra en la siguiente imagen:




Se requiere que exista una función en el destino (callback) que capture la respuesta y la de-codifique. A continuación, se muestra un ejemplo:
  1. app.get("/callback/:data", async function (req, res) {
        try {
            //get the response in base64
            const data = req.params.data;
           
            //decode the response in base64
            var responsejson = Buffer.from(data, 'base64').toString();
            console.log(responsejson);
            res.send(JSON.parse(responsejson));
        } catch (err) {
            res.send(err);
        }
    });

A continuación, se muestra un ejemplo de la respuesta JSON:
  1. {
        "status": 201,
        "requestId": 1,
        "result": {
            "token": "fb3d1a7b-9cb1-45b7-b49d-b2a3efd98371",
            "last_digits": "7777",
            "bin": "477777"
        },
        "expiration_date": "2109",
        "brand": "Visa",
        "nickname": "Visa",
        "errors": [],
        "_signature": "5005b0d596e6078.....c35bbbd9dcd44431100"
    }

3. Hacer cobro sobre un token

Para aplicar un cobro sobre un token de tarjeta, revisar este artículo.


    • Related Articles

    • Proceso de pago con formulario de GreenPay

      En esta sección se muestra una guía paso a paso de cómo integrarse al servicio de pagos por medio del formulario web. Para utilizar esta funcionalidad es necesario haber creado una orden de pago, para crear la orden pago puede revisar el  ...

    • Proceso de tokenización con formulario

      En esta sección se muestra una guía paso a paso de cómo integrarse al API de tokenización. Para utilizar esta funcionalidad es necesario haber creado una orden de tokenización, para crear la orden pago puede revisar el  articulo "Crear una orden de ...

    • Proceso de pago sin formulario de GreenPay

      En esta sección se muestra una guía paso a paso de cómo integrarse al API de pago. Para utilizar esta funcionalidad es necesario haber creado una orden de pago, para crear la orden pago puede revisar el  articulo "Crear una orden de pago" . Para ...

    • Proceso de tokenización sin formulario

      En esta sección se muestra una guía paso a paso de como integrase al API de tokenización. Para utilizar esta funcionalidad es necesario haber creado una orden de tokenización, para crear la orden pago puede revisar el  articulo "Crear una orden de ...

    • Proceso para actualizar token con formulario

      Consideraciones Para utilizar el formulario de tokenización de tarjetas se debe considerar los siguiente: El formulario está disponible en: Sandbox: http://sandbox-tokenizeform.greenpay.me/ Producción: https://tokenizeform.greenpay.me/ Tener una ...