HomeGuíasAPI ReferenceChangelog
Log In
API Reference

Anunciar un consentimiento que se va a pedir

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

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

subject
object
required

Quién va a aceptar, tal como la organización lo conoce. Es lo que queda en el registro: el browser no lo declara y no lo puede cambiar.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json