Tilopay.InitTokenize()
SDK 2.1.1Inicia el guardado de una tarjeta sin compra. Se usa con los mismos
campos del formulario que Init() y se cierra con
Tilopay.startPayment().
Cobro de validación. Para validar la tarjeta, Tilopay hace un cobro de USD 0.10 (o su equivalente en la moneda) que se reversa de inmediato; el cliente lo ve devuelto en minutos.
Guardá el token que recibís y asocialo al correo del cliente para usarlo después.
Firma#
No envíes orderNumber: el SDK usa su propio identificador de sesión. Tilopay fija el monto de validación.
await Tilopay.InitTokenize({ /* parámetros */ })Parámetros del redirect#
El redirect trae por query params code, crd, order, brand, last-digits y OrderHash. crd es el token de la tarjeta y solo trae valor cuando code = 1; guardalo asociado al correo del cliente. order lo genera Tilopay, no el comercio.
Parámetros#
Token del SDK, obtenido con POST /api/v1/loginSdk.
Moneda, ISO 4217.
Idioma: es o en.
Correo del cliente.
Nombre del cliente.
Apellidos del cliente.
Dirección 1 del cliente.
Dirección 2 del cliente.
Ciudad.
Provincia o estado.
Código postal.
País, ISO 3166-1 alpha-2.
Teléfono del cliente.
URL donde el SDK renderiza la respuesta final.
Llamada#
const init = await Tilopay.InitTokenize({
token: "<token_del_sdk>",
currency: "USD",
language: "es",
billToEmail: "cliente@ejemplo.com",
billToFirstName: "Ana",
billToLastName: "Rojas",
redirect: "https://ejemplo.com/respuesta",
});Respuesta#
{
"message": "Success",
"environment": "PROD",
"methods": [
{ "id": "<id_del_metodo_tarjeta>", "name": "Tarjeta", "type": "card" }
]
}En caso de error:
{
"message": "<descripción del error>",
"methods": []
}Última verificación: 2026-10-22