# API · processTokenize

> Tokenización de tarjeta con processTokenize: parámetros, request y respuesta.

- kind: api-operation
- status: stable
- api_version: v1
- last_verified: 2026-08-29
- url: https://www.tilopay.com/developers/api/tokenizacion/process-tokenize

```http
POST /api/v1/processTokenize
```

## Qué hace [#que-hace]

Tokeniza una tarjeta: devuelve la URL del formulario de tokenización.

## Autenticación [#autenticacion]

Requiere el token bearer del API en el header `Authorization` — ver [autenticación](/developers/api/autenticacion).

## Parámetros [#parametros]

<Param id="process-tokenize-parametro-redirect" name="redirect" type="string">
Sitio donde espera la respuesta de la transacción.
</Param>

<Param id="process-tokenize-parametro-key" name="key" type="string">
Key asociado al comercio.
</Param>

<Param id="process-tokenize-parametro-email" name="email" type="string">
Correo electrónico del tarjetahabiente.
</Param>

<Param id="process-tokenize-parametro-language" name="language" type="string">
Idioma [es, en].
</Param>

<Param id="process-tokenize-parametro-firstname" name="firstName" type="string">
Nombre del tarjetahabiente.
</Param>

<Param id="process-tokenize-parametro-lastname" name="lastName" type="string">
Apellido del tarjetahabiente.
</Param>

<Param id="process-tokenize-parametro-token-version" name="token_version" type="string">
Enviar como valor "v2".
</Param>

## Ejemplo de request [#request]

Los valores `<...>` son marcadores: reemplazalos por tus credenciales y datos.

```json
{
  "redirect": "https://urlToRedirect.com",
  "key": "<api_key>",
  "email": "email@user.com",
  "language": "es",
  "firstName": "name",
  "lastName": "lastname",
  "token_version": "v2"
}
```

## Respuesta [#respuesta]

```json
{
  "type": "100",
  "url": "https://secure.tilopay.com/htmls/TOK-5063-740506121440_1648145457file.html"
}
```

Para interpretar una respuesta que no es de éxito, ver [cómo leer una respuesta de error](/developers/api/procesos-operativos/errors).