Intents de consentimiento

Anunciar un consentimiento que se va a pedir

Changed on

Registra qué se le va a pedir a quién, y devuelve el token con el que el widget lo registra. La organización llama esto desde su servidor, antes de renderizar el paso de su formulario.

El titular queda anunciado acá y no viaja en el HTML. El registro copia de este intent el identificador, el documento de identidad, el correo, el teléfono y el nombre, así que nada de lo que el browser mande puede cambiar quién aceptó.

El client_token se responde una sola vez —de acá en adelante sólo existe su hash—, vence a los 30 minutos y registra un solo consentimiento: reintentar con él devuelve el registro que ya existe en vez de escribir otro. Un formulario con varios agreements necesita un intent por cada uno.

El titular tiene que poder encontrarse después: además del identificador del comercio, trae un documento de identidad —RUT o pasaporte— o un correo. El correo se guarda sin espacios alrededor y en minúsculas.

Un titular sin ninguno de los dos, un RUT con dígito verificador inválido, un pasaporte que no cumple el formato o un correo sin forma de correo se rechaza acá, antes de que exista una página.

Límite de tasa: 20 solicitudes por segundo. Al superarlo, la API responde 429. Ver Límites de tasa.

post/consent/intents

Request

  • Base URL
    https://api.trytoku.com
  • URL
    https://api.trytoku.com/consent/intents
  • Auth
    API key in header x-api-key

Request body

agreementstring required

uuid del agreement que el titular va a aceptar, el que la organización ve en el backoffice.

Example request

{
  "agreement": "b3d7c1a2-58f0-4e6d-9c11-7a2e5f0b8d44",
  "subject": {
    "email": "javiera.rojas@example.cl",
    "external_id": "cliente-4471",
    "government_id": {
      "value": "16.869.976-K"
    },
    "name": "Javiera Rojas",
    "phone": "+56 9 8765 4321"
  }
}

Response

El consentimiento quedó anunciado. Devuelve el client_token que va al HTML, una sola vez, y hasta cuándo sirve.

client_tokenstring required

Lo único que va al HTML del comercio. Es opaco para la organización, se responde una sola vez —acá se guarda sólo su hash—, vence a los 30 minutos y registra un solo consentimiento.

expires_atstring date-time required

Momento en que el token deja de servir, en UTC. Después de esto hay que emitir otro.

uuidstring required

uuid del intent creado, con el que la organización puede reconocerlo después.

Example response

{
  "client_token": "org_dhn3lnrfAjFyWuyEz-8Q3DFaFPnzc9-b.Qm9yZ2VzIGVzIGVsIG1lam9y",
  "expires_at": "2026-09-09T15:42:00Z",
  "uuid": "7c1e9d3a-2b8f-4c6e-9a01-5d3f7b2e8c44"
}

Changes