Account Number (CLABE)

An Account Number is the string of digits (CLABE in Mexico, traditional account number in Chile) that senders use to pay you. It points to an Account.

In Fintoc Account Numbers and Accounts are decoupled. One Account can have many Account Numbers. Balances live at the Account level; Account Numbers just route incoming money.

What you can do with them

• Reconcile payments. Attach metadata (e.g. customer_id, invoice_id) to an Account Number. When a transfer arrives, the webhook carries that metadata back to you.
• Filter incoming transfers. Set options.min_amount / options.max_amount to auto-reject over- or under-payments. See Add logic to CLABEs.
• Retire old ones. Disable or delete Account Numbers you no longer need. See Manage your CLABEs.

Root Account Number

Every Account is created with one default Account Number, flagged is_root: true. Outbound transfers you send always appear as coming from this root Account Number.

Rules

• No reassignment. Once an Account Number is bound to an Account, it cannot be moved to a different Account.
• Disabled Account Numbers auto-reject transfers. The sender gets the money back. See Add logic to CLABEs.
• Deleted Account Numbers and may eventually be reassigned to another Fintoc customer. See Manage your CLABEs.

Account Number Quota

By default, you can create up to 1,000,000 Account Numbers per organization.

Deleting an account number frees up quota. Deletion cannot be undone.

If you need to create more than 1,000,000 Account Numbers, contact your sales rep.