Crear orden de tokenización

Crear orden de tokenización

Consideraciones

Una orden de tokenizar se crea para indicar al API de tokenización, que se efectuará una tokenización con los datos de la tarjeta ingresados en el formulario. Para esto se debe tener las siguientes consideraciones:

  1. Utilizar los endpoints:

  1. Una orden de tokenización genera una respuesta en formato JSON que contiene un valor statusCode, session y token.

  2. Los valores session y token tendrán una vigencia de 30 minutos desde su creación, una vez cumplido ese plazo ya no tendrán validez, y se deberá crear una nueva orden.

  3. Se recomienda que este proceso se realice en el backend del comercio, para proteger los datos de

Pasos para el uso del servicio

Estructura de los Datos

  1. Orden de Tokenización

    { "secret": "secret provisto por GreenPay 2.0", "merchantId": "merchant provisto por GreenPay 2.0", "requestId": "número entero para identificar la orden" }

Datos obligatorios por la API

  • secret : String, llave secreta provisto por GreenPay 2.0

  • merchantId: String del identificador único para el comercio, provisto por GreenPay 2.0

  • requestId : Integer, número entero de la petición realizada por el comercio

  1. Realizar POST para crear la orden de Tokenización

GreenPay 2.0 API Services (Public)

 

Open image-20241025-200820.png

 

Se debe enviar la solicitud HTTP con método POST al endpoint de creación de órdenes de tokenización con el objeto JSON creado en el paso anterior en el cuerpo de la solicitud. La respuesta será proporcionada en formato JSON con valores session y token necesarios para efectuar la tokenización.

{ secret: "your secret provisioned by GreenPay 2.0", merchantId: "your merchantId provisioned by GreenPay v2.0", requestId: "número entero para identificar la orden" }
https://checkoutv2.greenpaysbx.me/tokenizeOrder

 

Si la orden se crea correctamente el HTTP Code será 200, si falla se obtendrá un HTTP Code 400

 

Open image-20241025-200639.png

 

Recomendación: Enviar todos los datos que tenga al alcance según la estructura de creación de la orden

Respuesta de la orden

a) Solicitud exitosa (HTTP Code 200)

{ "statusCode":200, "session":"2eae115f-501d-4a9f-833f-2f313c9d1d64", "token":"7ab23973-9167-4990-bba0-9ea09d809631" }

 

b) Solicitud Fallida (HTTP Code 400)

{ "status": "String razón solicitud rechazada", "message":"String mensaje solicitud rechazada", }
    • Related Articles

    • Crear orden de tokenización

      Consideraciones Una orden de tokenización se crea para indicar al API de Greenpay que se creará un token a partir de los datos de una tarjeta de crédito o débito. Para esto se debe tener las siguientes consideraciones: Endpoints para crear la orden ...
    • Crear orden de pago

      Consideraciones La orden de pago se genera para indicar al API de pago que se realizará una transacción, basándose en los datos proporcionados en la orden. Para esto, se debe considerar lo siguiente: Utilizar el servicio en los endpoints: En sandbox: ...
    • Crear orden de pago V2

      Consideraciones Una orden de pago se crea para indicar al API de pago que se efectuará una transacción por el motivo de los datos indicados en la orden. Para esto se debe tener las siguientes consideraciones: Utilizar el servicio en los endpoints: En ...
    • Proceso de tokenización

      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 Producción: https://checkout.greenpay.me/tokenize Tener una ...
    • 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 ...