Account numbers enable you to receive and track realtime Inbound Transfers using the Transfer API.
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. |