Configuraciones adicionales que pueden ser de utilidad en diferentes casos.

Customización del POST request

En el post request a pl/create-session-token se pueden agregar ciertos campos opcionales que permiten un cierto grado de customización en la sesión de pago que recibe el cliente.

URLs de pago exitoso y cancelado dinámicas

Se implementa una estructura con reglas para los merchants. Esta estructura es opcional, forma parte de cada merchant en la colección dentro de la base de datos y consta por ahora de 2 reglas orientadas a las URL de retorno, pero con la posibilidad de incorporar otras adicionales a futuro:

Validación general de las URLs de retorno:

• Se aplica a todas las URLs de retorno, sean por defecto o pasadas por parámetro.
• Se valida mediante una expresión regular, la estructura básica de una URL (que conste de un protocolo http o https, hostname, puerto opcional y un path).

Parámetros esperados:

• payment_completed_url: URL que se tomará para la redirección de un pago exitoso.
• payment_cancellation_url: URL que se tomará para la redirección de un pago cancelado.
• concat: Si en el path se contempla el uso de parámetros, corresponde enviar ese parámetro, para indicar el carácter que debiera utilizarse para concatenar algo a esa URL.

Llamada StartSession URL:pl/create-session-token:

La llamada pl/create-session-token no sufre ningún cambio en la estructura de respuesta, solo que al realizarse la llamada se le pueden incorporar los parámetros mencionados.

Headers:

{
    "x-api-key": "{MERCHANT_API_TOKEN}"
}

Body:

{
    "merchant_code": "{MERCHANT_CODE}",
    "merchant_order_id": "{ORDER_ID}",
    "order_amount": 500,
    "customer_email": "[email protected]",
    "payment_completed_url": "{URL_SUCCESS}",
    "payment_cancellation_url": "{URL_CANCEL}",
    "concat":"{“&”}",
    "metadata":[{
        "name": "Title",
        "value": "subtitle",
        "show": true
    }]
}

Reglas