{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/fincore/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Business Units API","siteUrl":"https://docs.monato.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"business-units-api","__idx":0},"children":["Business Units API"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Business Units are independent sub-accounts that can be created under a client’s main account."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each Business Unit is treated as its own legal entity; it has a CLABE, its own balance, and when a CEP (Comprobante Electrónico de Pago) is generated, it shows the Business Unit’s name, not the parent client’s."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This structure allows companies to organize their operations while maintaining the legal and accounting separation they require."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Business Units are represented as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customers"]}," in the API.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Each Customer is essentially a Business Unit account, treated as its own legal entity: it has a RFC, CLABE, and independent balance."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All Customers (Business Units) belong to a parent Merchant account, which must be provisioned by Monato before you can create or manage Private accounts."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Typical use cases include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Assigning CLABEs to subsidiaries or affiliates."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Handling projects or business units that require independent balances and reporting."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensuring that CEP receipts match the correct legal entity for compliance and accounting."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Structuring ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["private debt facilities"]}," by modeling SPVs, facilities, and reserve accounts as Business Units, enabling clear separation of balances and automated allocation of inflows."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-benefits","__idx":2},"children":["Key Benefits"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Legal & Accounting Compliance:"]}," Each Business Unit appears as a distinct legal entity, simplifying audits and tax obligations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Simplified Finance Management:"]}," Centralize treasury while avoiding the complexity of opening multiple bank accounts."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Operational Flexibility:"]}," Receive and send payments directly from each entity’s CLABE."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Scalable Setup:"]}," Add new Business Unit quickly as the business grows, without extra bureaucracy."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integration Ready:"]}," Manage entities via API, enabling automation and custom workflows."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"important-considerations","__idx":3},"children":["Important Considerations"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Business Unit Main Account:"]}," A Merchant account (the “parent” of all Business Units) is required. This step is handled by Monato. Please contact us if you do not yet have a Merchant account."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Customer Creation and Validation:"]}," When a Business Unit (Customer) is first created, its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerValidationStatus"]}," will be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PENDING"]}," until KYB checks are completed. Only ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VALIDATED"]}," Customers should be used for production operations. This step si also performed by Monato"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Processing Time:"]}," Account creation and activation may take a few seconds to propagate across systems."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account Status:"]}," Newly created accounts start in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]}," if successful."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unique CLABE:"]}," Each Business Unit account generates a unique CLABE that cannot be reused or reassigned."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-create-an-account-for-a-business-unit-endpoint","__idx":4},"children":["Step 1: Create an account for a Business Unit endpoint"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A valid ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clientId"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerId"]}," must exist."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Authentication token must be included in the request headers."]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/clients/{{clientId}}/customers/{{customersId}}/private_accounts"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Path parameters"]},": none"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Query Parameters"]},": none"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request Body"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"client_id\": \"{{client_id}}\",\n  \"client_bank_adapter_id\": \"{{client_bank_adapter_id}}\",\n  \"bank_id\": \"{{bank_id}}\",\n  \"owner_id\": \"{{owner_id}}\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status Code"]},": 200 OK",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response Body"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"id\": \"9bde649b-a109-4304-848d-4af4dd898f5b\",\n    \"bankId\": \"14b392f6-0dd9-4cd9-ac51-d13c5547c137\",\n    \"clientId\": \"d9836d30-b235-4k4b-8c51-f994326c0888\",\n    \"clientBankAdapterId\": \"848af863-fe20-4f3a-96a5-a8d4909995c1\",\n    \"accountId\": \"ac8e89e6-fbfa-41ce-8c77-058b6c485891\",\n    \"instrumentId\": \"53826860-8426-4876-90e0-3ffc5314d35c\",\n    \"ownerId\": \"85cb81bb-f3ff-4294-8864-988e83f02b3c\",\n    \"ownerType\": \"CUSTOMER\",\n    \"accountNumber\": \"123456789012\",\n    \"clabeNumber\": \"734180123456789012\",\n    \"availableBalance\": \"0.00\",\n    \"accountType\": \"PRIVATE_ACCOUNT\",\n    \"accountStatus\": \"ACTIVE\",\n    \"audit\": {\n        \"createdAt\": \"2025-09-08 16:56:30.668821-06:00\",\n        \"updatedAt\": \"2025-09-08 16:56:30.668821-06:00\",\n        \"deletedAt\": \"None\",\n        \"blockedAt\": \"None\",\n        \"activatedAt\": \"None\",\n        \"suspendedAt\": \"None\"\n    },\n    \"bankAdapter\": \"SIES\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As you can see, the response includes not only the account identifiers (such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accountId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accountNumber"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clabeNumber"]},"), but also metadata like the audit trail (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAt"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updatedAt"]},") and the current ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accountStatus"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"This detailed payload ensures you can immediately confirm the account’s state, trace when it was created, and map it to your internal systems with certainty."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-list-customers","__idx":5},"children":["Step 2: List Customers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once Business Units (Customers) are created, you can retrieve them and their details using the following endpoint:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ℹ️ ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Note:"]}," Customers always start with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerValidationStatus = PENDING"]}," and move to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VALIDATED"]}," once KYB checks are completed."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A valid ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clientId"]}," must exist."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Authentication token must be included in the request headers."]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/clients/{{clientId}}/customers"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Path Parameters"]},": none",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Query Parameters"]},": none"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request Body"]},": none"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status Code"]},": 200 OK",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response Body"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"\n{\n    \"currentPage\": 1,\n    \"perPage\": 50,\n    \"totalItems\": 3,\n    \"data\": [\n        {\n            \"id\": \"85cb81bb-f3ff-4294-8864-938e83f02b3c\",\n            \"clientId\": \"d9836d30-b235-4f4b-8c51-f974326c0888\",\n            \"name\": \"Pedro Juarez Aguila\",\n            \"rfc\": \"XAXX010101000\",\n            \"legalRepresentativeName\": \"Pedro Juarez Aguilar\",\n            \"legalRepresentativeRfc\": \"XAXX010101000\",\n            \"legalRepresentativePhone\": \"1234567890\",\n            \"legalRepresentativeEmail\": \"mail1@mail.com\",\n            \"domain\": \"mydomain.com3\",\n            \"customerAlias\": \"Peter\",\n            \"customerStatus\": \"ACTIVE\",\n            \"customerValidationStatus\": \"VALIDATED\",\n            \"audit\": {\n                \"createdAt\": \"2025-09-05 11:14:22.883546-06:00\",\n                \"updatedAt\": \"2025-09-05 11:14:22.883546-06:00\",\n                \"deletedAt\": \"None\",\n                \"blockedAt\": \"None\"\n            }\n        },\n        {\n            \"id\": \"95ba5a24-4312-4bc5-9dd8-61c7e6767d7a\",\n            \"clientId\": \"d9836d30-b235-4f4b-8c51-f974326c0888\",\n            \"name\": \"Raul Gonzalez Sanchez\",\n            \"rfc\": \"XAXX010101000\",\n            \"legalRepresentativeName\": \"Raul Gonzalez Sanchez\",\n            \"legalRepresentativeRfc\": \"XAXX010101000\",\n            \"legalRepresentativePhone\": \"1234567890\",\n            \"legalRepresentativeEmail\": \"mail@mail.com\",\n            \"domain\": \"mydomain.com4\",\n            \"customerAlias\": \"Raul\",\n            \"customerStatus\": \"ACTIVE\",\n            \"customerValidationStatus\": \"VALIDATED\",\n            \"audit\": {\n                \"createdAt\": \"2025-09-05 11:18:58.559081-06:00\",\n                \"updatedAt\": \"2025-09-05 11:18:58.559081-06:00\",\n                \"deletedAt\": \"None\",\n                \"blockedAt\": \"None\"\n            }\n        },\n        {\n            \"id\": \"997792b0-2d2d-4bb0-bf1d-2b0c90c42ec9\",\n            \"clientId\": \"d9836d30-b235-4f4b-8c51-f974326c0888\",\n            \"name\": \"Juan Perez Arguelles\",\n            \"rfc\": \"XAXX010101000\",\n            \"legalRepresentativeName\": \"Juan Perez Arguelles\",\n            \"legalRepresentativeRfc\": \"XAXX010101000\",\n            \"legalRepresentativePhone\": \"1234567890\",\n            \"legalRepresentativeEmail\": \"name@mail.com\",\n            \"domain\": \"mydomain.com5\",\n            \"customerAlias\": \"Juan\",\n            \"customerStatus\": \"ACTIVE\",\n            \"customerValidationStatus\": \"VALIDATED\",\n            \"audit\": {\n                \"createdAt\": \"2025-09-05 11:21:11.091527-06:00\",\n                \"updatedAt\": \"2025-09-05 11:21:11.091527-06:00\",\n                \"deletedAt\": \"None\",\n                \"blockedAt\": \"None\"\n            }\n        }\n    ]\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":6},"children":["Next Steps"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure your Business Units are fully ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["VALIDATED"]}," before using them in production."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the generated CLABEs to start receiving funds into each Business Unit."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Refer to the Webhooks documentation to integrate notifications for incoming transactions."]}]}]},"headings":[{"value":"Business Units API","id":"business-units-api","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Key Benefits","id":"key-benefits","depth":2},{"value":"Important Considerations","id":"important-considerations","depth":2},{"value":"Step 1: Create an account for a Business Unit endpoint","id":"step-1-create-an-account-for-a-business-unit-endpoint","depth":2},{"value":"Step 2: List Customers","id":"step-2-list-customers","depth":2},{"value":"Next Steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Business Units API"}},"lastModified":"2025-09-25T19:38:12.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/fincore/guides/business-units","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}