Each time you want to verify a Business, you should use the Business Verification Request resource. You can create a verification request in order to onboard a new business customer, create an AML report, or update a business' identity information.
To create a verification request you need to:
- Specify the country of the business you want to verify.
- Declare which type of items you want Trébol to include on the Verification Request. The items Trébol supports are here.
- For private items and documents, you need to include an URL of public access (such as a GCP or AWS pre-signed URL) in the Verification Request. This way Trébol can access and analyze the private item. See how to upload a document here
Optionally, you can also add:
- If you know the Business tax id number, you can also include it on the Verification Request.
- A unique tag that helps you identify more easily the verification on your system. This can be a uuid you assign to the verification on your internal system. This value does not affect by any means the verification result.
- A JSON object metadata where you can attach any relevant information you need to relate to the Business Verification. This metadata is not used by Trébol at any part of the Business Verification and does not affect the result of the Verification.
From your side, you do not have to validate anything from the documents, Trébol does all of the hard work for you!
Mexico example:
Generally, to onbard a business in México you need to analyze documents like actas constitutivas, powers of attornery or actas de asamblea. Trébol helps you obtain the necessary data out of these documents.
To start a Verification Request you only have to send us the documents you collected from you customers.
{
"tax_id": "RFC1234",
"country": "mx",
"items": [
{
"type": "ac_mx",
"options": {
"file_url": "htps://your-domain.com/fileUrl1"
}
},
{
"type": "aa_mx",
"options": {
"file_url": "htps://your-domain.com/fileUrl2"
}
}
],
"metadata": {
"some": "value"
},
"tag": "some-tag"
}
Colombia example:
{
"tax_id": "901549584",
"country": "co",
"items": [
{
"type": "co_rut",
"options": {
"max_date": 60
}
},
{
"type": "co_camara_comercio",
"options": {
"buy": true
}
}
],
"metadata": {
"some": "value"
},
"tag": "some tag"
}
To check the country codes and valid items, check this link.