Objeto Account Number
Los account numbers te permiten recibir y hacer seguimiento de transferencias entrantes en tiempo real usando la API de Business Accounts.{
"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": "000000000000000000",
"options": {
"max_amount": 400,
"min_amount": 300
},
"status": "enabled",
"updated_at": "2024-03-01T20:09:42.949787176Z"
}
| Campo | Tipo | Descripción |
|---|---|---|
id | string | Identificador único del Account Number. |
object | string | El tipo del objeto, que siempre es account_number. |
account_id | string | Cuenta a la que apunta el Account Number. |
created_at | string | Marca temporal en que se creó el Account Number (en formato ISO 8601). |
deleted_at | string | Marca temporal en que se eliminó el Account Number. null si no se ha eliminado. |
description | string | Una descripción que puedes usar para identificar fácilmente este Account Number (máx. 40 caracteres). |
is_root | bool | Indica si el Account Number es el Account Number principal de la cuenta. Los Account Numbers root aparecerán como el Account Number remitente en las transferencias salientes. |
last_transfer_at | string | Marca temporal de la última transferencia entrante recibida por este Account Number. null si nunca se ha recibido una transferencia entrante. |
metadata | object | Pares clave-valor opcionales asociados a este Account Number. |
mode | string | Modo de la API (test o live). |
number | string | Número de cuenta que recibe transferencias entrantes. En México, este valor es un número de cuenta bancaria mexicana estandarizado (CLABE). |
options | object | Configuraciones adicionales para los Account Numbers. |
status | string | Estado de este Account Number; puede ser enabled, disabled, blocked o deleted.Las transferencias entrantes dirigidas a Account Numbers deshabilitados, bloqueados o eliminados se devolverán ( returned) automáticamente. |
updated_at | string | Marca temporal de la última actualización del Account Number (en formato ISO 8601). |
Objeto Options (dentro del objeto Account Number)
| Campo | Tipo | Descripción |
|---|---|---|
max_amount | integer | Monto máximo aceptado para transferencias entrantes. Fintoc rechaza automáticamente las transferencias que superan este umbral. Los montos usan la unidad monetaria más pequeña del país de la cuenta: centavos para México, pesos para Chile. Debe ser un entero positivo o null. |
min_amount | integer | Monto mínimo aceptado para transferencias entrantes. Fintoc rechaza automáticamente las transferencias por debajo de este umbral. Los montos usan la unidad monetaria más pequeña del país de la cuenta: centavos para México, pesos para Chile. Debe ser un entero positivo o null. |