API · Crear CoF (Tokenizar)

POST /api/v1/processTokenize

Qué hace#

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

Autenticación#

Requiere el token bearer del API en el header Authorization — ver autenticación.

Parámetros#

Ejemplo de request#

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

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

Respuesta#

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

Respuestas de error#

Parámetros que llegan al redirect#

token, code, description, auth, crd, order, tpt, brand, last-digits, tilopay-transaction, OrderHash, returnData.

El token de la tarjeta viaja en token y crd; guardalo asociado al correo del cliente. brand y last-digits sirven para mostrar la tarjeta guardada. crd solo trae valor cuando la tarjeta quedó guardada con code = 1.

HTTP 300:

{
  "type": "300",
  "result": "Message error"
}

HTTP 402:

{
  "type": "402",
  "result": "Message error"
}

Para interpretar una respuesta que no es de éxito, ver cómo leer una respuesta de error.