Account number object

The Account Number object

An AccountNumber represents a bank account number tied to one of your accounts that can receive inbound transfers. In Mexico, it corresponds to a standardized Mexican bank account number (CLABE). Fintoc returns an AccountNumber object when you create one for an account, or when you list or retrieve the account numbers you own.

{
  "id": "acno_Kasf91034gj1AD",
  "object": "account_number",
  "account_id": "acc_Lq7dP901xZgA2B",
  "created_at": "2024-03-01T20:09:42.949787176Z",
  "deleted_at": null,
  "description": "My payins",
  "is_root": false,
  "last_transfer_at": "2026-03-15T14:22:01.000Z",
  "metadata": {
    "order_id": "12343212"
  },
  "mode": "test",
  "number": "738969123456789120",
  "options": {
    "max_amount": 400,
    "min_amount": 300
  },
  "status": "enabled",
  "updated_at": "2024-03-01T20:09:42.949787176Z"
}

Field	Type	Description
`id`	string	Unique identifier for the account number.
`object`	string	The type of the object, which is always account_number.
`account_id`	string	Account the Account Number points to.
`created_at`	string	Timestamp when the account number was created (in ISO 8601 format).
`deleted_at`	string	Timestamp when the account number was deleted. `null` if the account number has not been deleted.
`description`	string	A description you can use to easily identify this Account Number (40 chars max.).
`is_root`	bool	Indicates if the Account Number is the main Account Number of the Account. Root Account Numbers will appear as the sender Account Number for Outbound Transfers.
`last_transfer_at`	string	Timestamp of the last inbound transfer received by this account number. `null` if no inbound transfer has ever been received.
`metadata`	object	Optional key-value pairs associated with this account number.
`mode`	string	Mode of the API (test or live).
`number`	string	The account number (for Mexico: CLABE) of the sender.
`options`	object	Additional configurations for Account Numbers.
`status`	string	Account number status. One of `enabled`, `disabled`, `blocked`, or `deleted`. Fintoc automatically returns inbound transfers directed to disabled, blocked, or deleted account numbers.
`updated_at`	string	Timestamp when the account number was last updated (in ISO 8601 format).

The Options object (within the Account Number object)

The Options object holds the minimum and maximum amount thresholds that filter inbound Transfers. It appears in the options field of the AccountNumber object.

Field	Type	Description
`max_amount`	integer	Maximum amount accepted for inbound transfers. Transfers exceeding this threshold will be automatically rejected. Amount is specified in the base currency unit for the account’s country: centavos for Mexico, pesos for Chile. Must be a positive integer or null.
`min_amount`	integer	Minimum amount accepted for inbound transfers. Transfers below this threshold will be automatically rejected. Amount is specified in the base currency unit for the account’s country: centavos for Mexico, pesos for Chile. Must be a positive integer or null.

Fintoc API

Main Resources

Payments API

Transfers API

Movements API

Direct Debit (Legacy)

Fiscal API

Account number object

The Account Number object

The Options object (within the Account Number object)

​The Account Number object

​The Options object (within the Account Number object)

The Account Number object

The Options object (within the Account Number object)