Proceso para actualizar token con formulario

Proceso para actualizar token con formulario

Consideraciones

Para utilizar el formulario de tokenización de tarjetas se debe considerar los siguiente:
  1. El formulario está disponible en:
    1. Sandbox: http://sandbox-tokenizeform.greenpay.me/
    2. Producción: https://tokenizeform.greenpay.me/
  2. Tener una session 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, para mas información visite este enlace.
  3. El formulario de tokenización de Greenpay solo esta disponible para aplicaciones web.

Pasos para actualizar el token

1. Redireccionar al formulario de tokenización

Una vez obtenida la respuesta (session, token) de 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. Tener el token de tarjeta que quiere actualizar.
  3. Construir la URL:
    1. Sandbox: http://sandbox-tokenizeform.greenpay.me/{{session}}?{{token_tarjeta}}
    2. Producción: https://tokenizeform.greenpay.me/{{session}}?{{token_tarjeta}}
A continuación, se muestra un ejemplo en Javascript de cómo hacer el redireccionamiento.
  1. const express = require("express");
    const app = express();
    const tokenToUpdate = "5eb37ba3-f439-4401-8d5e-4d9302c2ccc9"
    app.use(bodyParser.json());
    app.use(bodyParser.urlencoded({
    extended: true
    }));
    app.get("/order", async function (req, res)
    {
    try {
    const security = await postOrder(order);
    res.redirect(`https://sandbox-tokenizeform.greenpay.me/${{security.session}}?${{tokenToUpdate}}`)
    } catch (err) {
    res.send(err);
    }
    })

Al hacer el redireccionamiento, se les presentará el siguiente formulario con los datos de la tarjeta actual asociados al token.



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 en BASE 64 y lo de-codifique. A continuación, se muestra un ejemplo de cómo obtener la respuesta.
  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 tokenización con formulario

      Consideraciones Para utilizar el formulario de tokenización de tarjetas se debe considerar lo siguiente: El formulario está disponible en: Sandbox: http://sandbox-tokenizeform.greenpay.me/ Producción: https://tokenizeform.greenpay.me/ Se requiere ...
    • Actualizar token de tarjeta

      Consideraciones Para utilizar el servicio de tokenización se debe tomar en cuenta los siguiente: Utilizar el servicio en los endpoints: Sandbox: https://sandbox-checkout.greenpay.me/tokenize/update Producción: ...
    • Proceso de pago con webform

      Consideraciones Para utilizar el formulario de pago de Greenpay, se debe considerar los siguiente: El formulario está disponible en dos entornos: Sandbox: https://sandbox-checkoutform.greenpay.me/ Producción: https://checkout-form.greenpay.me/ Se ...
    • Proceso de pago con Widget

      Consideraciones Al utilizar el widget de pago de Greenpay, es importante tener en cuenta lo siguiente: Es necesario disponer de una cuenta de sandbox o de producción. Para obtener esta cuenta, visite la sección Sobre cuenta de pruebas o sandbox. El ...
    • Actualizar monto

      Consideraciones Para este servicio se debe consumir el siguiente endpoint: https://sandbox-merchant.greenpay.me/subscriptions/update A continuación, se muestra el paso a paso para actualizar el monto de una suscripción en nuestro API de forma ...