Tilopay.InitTokenize()

SDK 2.1.1

Starts saving a card without a purchase. It uses the same form fields as Init() and is closed with Tilopay.startPayment().

Validation charge. To validate the card, Tilopay makes a USD 1 charge (or its equivalent in the currency) that is reversed immediately; the customer sees it refunded within minutes.

Store the token you receive and associate it with the customer's email to use it later.

Signature#

await Tilopay.InitTokenize({ /* parameters */ })

Parameters#

tokenstringrequired#

SDK token, obtained with POST /api/v1/loginSdk.

currencystringrequired#

Currency, ISO 4217.

languagestringrequired#

Language: es or en.

billToEmailstringrequired#

Customer email.

billToFirstNamestring#

Customer first name.

billToLastNamestring#

Customer last name.

billToAddressstring#

Customer address line 1.

billToAddress2string#

Customer address line 2.

billToCitystring#

City.

billToStatestring#

State or province.

billToZipPostCodestring#

Postal code.

billToCountrystring#

Country, ISO 3166-1 alpha-2.

billToTelephonestring#

Customer phone.

redirectstring (URL)#

URL where the SDK renders the final response.

Call#

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",
});

Response#

{
  "message": "Success",
  "environment": "PROD",
  "methods": [
    { "id": "<id_del_metodo_tarjeta>", "name": "Tarjeta", "type": "card" }
  ]
}

On error:

{
  "message": "<error description>",
  "methods": []
}

Last verified: 2026-10-21

View as raw Markdown