Create more accounts

Create more accounts under your own Entity, or under 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

Activation depends on which Entity owns the account:

• For your main Entity, accounts activate immediately.
• For a new Entity, accounts stay in pending until Fintoc completes business verification for the Entity, within 5 business days.

Create more accounts for your Organization's Entity

Your Organization in Fintoc starts out with one Account, and you can instantly create more accounts for your main Entity. Multiple accounts improve your reconciliation, because you keep a separate balance for each account.

Use the API

Call the Create Account endpoint with the entity_id of your main Entity, or create the account from the Dashboard. To retrieve this ID, call the List Entities endpoint.

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",
  "entity_id": "ent_32ExjlGaPrvG2AiNSU2lAmNiXL8",
  "description": "My main account",
  "status": "active",
  "balance": 0,
  "currency": "mxn"
}

Create accounts for another Entity (your clients)

If you manage funds on behalf of your clients, you can also open accounts under their 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, each under a new Entity, so that when a customer pays, the transfer receipt shows the restaurant's name rather than your platform's name.

Behind the scenes, you manage balances and payouts between your Account and your clients' Accounts.

1. Create an Entity

Create the Entity from your Fintoc Dashboard. This step is available only in the Dashboard. Go to Entities, then select Create Entity.

Enter the Entity's legal name and tax ID: a Mexican Federal Taxpayer Registry number (RFC) for Mexico, or a Chilean tax ID (RUT) for Chile.

2. Complete know-your-business verification

You receive a URL to complete the know-your-business (KYB) form for your new Entity. Within 5 business days after you submit the form, Fintoc's compliance team reviews your information and confirms the Entity is ready to use.

3. Start using Transfers

Once Fintoc confirms the compliance check, you can immediately:

• Create Transfers from your new Entity's main Account.
• Receive Transfers at your main account number, or generate new account numbers.
• Create more Accounts instantly under this Entity.

Test the integration

In test mode, call the Create Account endpoint with entity_id set to your main test Entity. The response returns an id prefixed with acc_ and status set to active, which confirms the Account is ready to use.