Authentication of Child Companies (Beta)

Version 2.1 introduces the concept of child companies, which allow liquidation and receipts to be emitted by a parent company on behalf of its child companies while maintaining a clear separation of operations. This is common for franchises and when managing different business lines within a same company. The structure of child companies is as follows:

All child companies will need to complete the Conekta onboarding process separately and then associated with the parent account. At the moment you will need to contact support in order to associate the child companies with the parent and in order to configure your liquidation/receipt preferences.

In order to obtain a complete list of sub-companies you can perform an HTTP GET request to https://api.conekta.io/companies, for example:

curl --location 'https://api.conekta.io/companies?limit=20' \
--header 'Accept-Language: es' \
--header 'Accept: application/vnd.conekta-v2.1.0+json' \
--header 'Authorization: Bearer key_8N47yt8PWrgSE6yUuds1dFL'

Once you identify the subcompany you can process charges or realize any other operation on its behalf by sending the X-Child-Company-Id header.