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. Las transferencias que superen este umbral se rechazarán automáticamente. El monto se especifica en la unidad base de la moneda 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. Las transferencias por debajo de este umbral se rechazarán automáticamente. El monto se especifica en la unidad base de la moneda del país de la cuenta: centavos para México, pesos para Chile. Debe ser un entero positivo o null. |