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

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. Verification takes up to 5 business days.

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"
}
'

Node SDK

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

Python SDK

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

Response

{
  "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 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 Transfers

After Fintoc completes business verification, you can:

Create Transfer objects from your new entity’s main Account.
Receive transfers at your main account number or generate new 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.

Home

Resources

Payments

Transfers

Movements

Create more accounts

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 Transfers

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 Transfers

​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 Transfers

Test the integration