Skip to main content
An Account Number is the string of digits that senders use to pay you. In Mexico, it is a standardized Mexican bank account number (CLABE). In Chile, it is a traditional bank account number. An Account Number points to an Account. This page explains how Account Numbers relate to Account objects, what you can configure on them, and the rules that govern them. For the API fields, see the Account Number object reference. In Fintoc, Account Numbers and Account objects are decoupled. One Account can have many Account Numbers. Balances live at the Account level. Account Numbers route incoming money.

​
What you can do with them

  • Reconcile payments. Attach metadata, such as customer_id and 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 Account Numbers.
  • Retire old ones. Disable or delete Account Numbers you no longer need. See Manage your Account Numbers.

​
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 Account Numbers.
  • Deletion releases the Account Number. Once you delete an Account Number, Fintoc can later reassign it to another Fintoc customer. See Manage your Account Numbers.

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