Guía para desarrolladores
Crear una verificación
Preparación de documentos
- Tipo de documento: Los documentos se envían con un tipo específico. Generalmente, el tipo será genérico. El beneficio para los clientes es que Trébol se encarga de confirmar o indicar exactamente el tipo de documento, facilitando así el proceso y reduciendo la carga de trabajo para el cliente.
- URL descargable: Proporcione una URL desde donde se pueda descargar el documento. La URL debe estar disponible al menos 5 minutos para que Trébol pueda descargar el documento.
- Guía del tipo de documento (Opcional): Puede incluir un guía del tipo de documento. Esto no es obligatorio.
Ejemplo de guía: tipo de documento puede ser un
ac_mx
, que significa acta constitutiva operson_id
para los INE o pasaportes. - Scope (Alcance): Defina el alcance del documento, especialmente para los firmantes de la empresa (apoderados legales).
En casos donde se presume que el documento contiene un INE de un firmante, el scope debe ser
powers
. - Key people: Si se necesita buscar poderes de personas específicas, se pueden incluir en un arreglo llamado
key_people
, donde se proporciona el nombre completo de la persona y el scope que se necesita, usualmentepowers
.
Ejemplo de campos a enviar
type
: genericurl
: URL descargable del documentoitem_type_guide
: tipo de documento opcional, comopersonID
scope
: alcance comoPowers
key_people
: nombres de personas clave y sus scopes
Respuesta Trébol
Después de que sea crear una verificación, Trébol responde con un verification_id
, el cual puede ser usado para consultar el estado y los datos extraidos de la empresa.