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:
Utilizar los endpoints:
Producción: https://checkoutv2.greenpay.me/tokenizeOrder
Una orden de tokenización genera una respuesta en formato JSON que contiene un valor statusCode, session y token.
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.
Se recomienda que este proceso se realice en el backend del comercio, para proteger los datos de
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
Realizar POST para crear la orden de Tokenización
GreenPay 2.0 API Services (Public)
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
Recomendación: Enviar todos los datos que tenga al alcance según la estructura de creación 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",
}