Create more accounts

Create accounts under your own entity or an entity you open for a client. Each account tracks a separate balance. An entity is the legal account holder. Your organization always has a main entity, and you can also create entities for your clients.

Account activation

An Account is active as soon as Fintoc creates it. Accounts have no pending state: status is active, blocked, or closed.

For your main entity, you can create accounts at any time.
For a new entity, Fintoc creates the entity’s main Account when Fintoc approves the business verification. Verification takes up to 5 business days. Until then, the entity has no accounts.

Create more accounts for your organization’s entity

Your Fintoc organization starts with one Account. You can immediately create more accounts for your main entity. Multiple accounts improve reconciliation because each account keeps a separate balance.

Use the API

Call the Create account endpoint with your main entity’s entity_id. To retrieve the entity_id, call the List entities endpoint. You can also create the account from the Dashboard.

curl --request POST \
     --url https://api.fintoc.com/v2/accounts \
     --header 'Authorization: sk_test_32ExjlGaPrvG2AiNSU2lAmNiXL8' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "entity_id": "ent_32ExjlGaPrvG2AiNSU2lAmNiXL8",
  "description": "My main account"
}
'

const account = await fintoc.v2.accounts.create({
  entity_id: "ent_32ExjlGaPrvG2AiNSU2lAmNiXL8",
  description: "My main account"
});

account = client.v2.accounts.create(
  entity_id="ent_32ExjlGaPrvG2AiNSU2lAmNiXL8",
  description="My main account",
)

{
  "id": "acc_32ExjlGaPrvG2AiNSU2lAmNiXL8",
  "object": "account",
  "mode": "test",
  "status": "active",
  "description": "My main account",
  "is_root": false,
  "root_account_number": "000000000000000001",
  "root_account_number_id": "acno_Kasf91034gj1AD",
  "available_balance": 0,
  "currency": "MXN",
  "entity": {
    "id": "ent_32ExjlGaPrvG2AiNSU2lAmNiXL8",
    "holder_id": "AAA010101AAA",
    "holder_name": "Test Entity 1",
    "is_root": true
  }
}

Create accounts for another entity (your clients)

Creating accounts for a client Entity is available in Mexico onlyCreating Account objects under your own entity works in Chile and Mexico.

If you manage funds for clients, you can open accounts under each client’s legal name.

Example use case

Consider a food delivery platform:

You keep one Account under your own entity to collect your platform fees.
You create one Account per restaurant under a new entity. When a customer pays, the transfer receipt shows the restaurant’s name instead of your platform’s name.

You manage balances and payouts between your Account object and your clients’ Account objects.

1. Create an entity

Create the entity from the Entities section of the Dashboard. Select Create Entity, then enter the entity’s legal name and Mexican tax ID (RFC).

2. Complete business verification

Complete the business verification form for your new entity in the Dashboard. Fintoc’s compliance team reviews your information within 5 business days and confirms when the entity is ready to use.

3. Start using Business Accounts

When Fintoc approves the business verification, Fintoc creates the client Entity’s main Account and root account number. Retrieve both with the List accounts endpoint, filtered by entity_id. From there you can:

Create Transfer objects from the entity’s main Account.
Receive transfers at its root account number or generate more account numbers.
Create more Account objects under this entity.

Test the integration

In test mode, use your test secret key to call the Create account endpoint. Set entity_id to your main test entity. The response returns an id prefixed with acc_ and a status of active, which confirms the Account is ready to use.

​Account activation

​Create more accounts for your organization’s entity

​Use the API

​Create accounts for another entity (your clients)

​Example use case

​1. Create an entity

​2. Complete business verification

​3. Start using Business Accounts

​Test the integration

Account activation

Create more accounts for your organization’s entity

Use the API

Create accounts for another entity (your clients)

Example use case

1. Create an entity

2. Complete business verification

3. Start using Business Accounts

Test the integration