> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agrega lógica a los Account Numbers

> Rechaza todas las transferencias dirigidas a un Account Number específico.

Puedes usar un Account Number de Fintoc, llamado CLABE (Clave Bancaria Estandarizada) en México, de distintas maneras. Puedes asignar un Account Number a los pagos de un usuario específico o crear un Account Number de un solo uso para una orden de pago específica. Al terminar esta guía, podrás deshabilitar un Account Number y establecer límites mínimos y máximos de monto. Estos controles permiten que Fintoc rechace transferencias entrantes no deseadas.

## Deshabilitar un Account Number

Cuando deshabilitas un Account Number, Fintoc rechaza automáticamente cada transferencia entrante dirigida a ese Account Number y la devuelve al remitente. Si un Account Number ya no debe recibir pagos, deshabilítalo para evitar tener que gestionar transferencias entrantes inesperadas.

### Ejemplos de casos de uso

* Tu empresa asigna un Account Number por usuario y un usuario ha completado el proceso de baja de tu aplicación. Deshabilita el Account Number de ese usuario para que los pagos hechos a su nombre se devuelvan automáticamente y no consuman tus recursos operativos.
* Tu empresa asigna un Account Number por orden y un cliente compró un producto en tu tienda. Deshabilita el Account Number de esa orden una vez que el cliente haya pagado para evitar recibir un pago doble. Si el cliente no ve el aviso de confirmación de pago y paga dos veces, Fintoc devuelve el dinero automáticamente.

### Deshabilitar un Account Number con la API

```curl theme={null}
curl --request PATCH \
     --url https://api.fintoc.com/v2/account_numbers/acno_test_a1b2c3d4e5f6 \
     --header 'Authorization: sk_test_jKaHdEa3mfmP0D105H' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "status": "disabled"
}
'
```

```node theme={null}
const accountNumber = await fintoc.v2.accountNumbers.update(
  "acno_test_a1b2c3d4e5f6",
  { status: "disabled" }
);
```

```python theme={null}
account_number = client.v2.account_numbers.update(
  "acno_test_a1b2c3d4e5f6",
  status="disabled"
)
```

La API devuelve el Account Number actualizado con su `status` establecido en `disabled`:

```json theme={null}
{
  "id": "acno_test_a1b2c3d4e5f6",
  "object": "account_number",
  "account_id": "acc_test_b2c3d4e5f6g7",
  "created_at": "2026-06-22T12:00:00.000Z",
  "deleted_at": null,
  "description": "My payins",
  "is_root": false,
  "last_transfer_at": null,
  "metadata": {},
  "mode": "test",
  "number": "000000000000000000",
  "options": null,
  "status": "disabled",
  "updated_at": "2026-06-22T12:00:00.000Z"
}
```

## Establecer límites de monto para transferencias entrantes

Puedes restringir qué transferencias entrantes acepta un Account Number. Si una transferencia no cumple con los criterios que defines, Fintoc la rechaza. Las transferencias rechazadas no aparecen en tus estados de cuenta y no generan comisiones. Establece `min_amount` y `max_amount` en la unidad mínima de la moneda. Por ejemplo, `30000` equivale a 300.00 MXN. Fintoc admite tres tipos de límites de monto:

| Límite       | Descripción                                                                                                                              |
| :----------- | :--------------------------------------------------------------------------------------------------------------------------------------- |
| Monto mínimo | Establece `min_amount` para rechazar cualquier transferencia cuyo monto sea menor a este valor.                                          |
| Monto máximo | Establece `max_amount` para rechazar cualquier transferencia cuyo monto sea mayor a este valor.                                          |
| Monto exacto | Establece `min_amount` y `max_amount` con el mismo valor para rechazar cualquier transferencia que no coincida con ese monto específico. |

### Establecer límites con la API

```curl theme={null}
curl --request POST \
     --url https://api.fintoc.com/v2/account_numbers \
     --header 'Authorization: sk_test_jKaHdEa3mfmP0D105H' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "account_id": "acc_test_b2c3d4e5f6g7",
  "options": {
    "min_amount": 30000,
    "max_amount": 40000
  }
}
'
```

```node theme={null}
const accountNumber = await fintoc.v2.accountNumbers.create({
  account_id: "acc_test_b2c3d4e5f6g7",
  options: {
    min_amount: 30000,
    max_amount: 40000,
  },
});
```

```python theme={null}
account_number = client.v2.account_numbers.create(
  account_id="acc_test_b2c3d4e5f6g7",
  options={
    "min_amount": 30000,
    "max_amount": 40000,
  },
)
```

La API devuelve el nuevo Account Number con los límites de monto bajo `options`:

```json theme={null}
{
  "id": "acno_test_a1b2c3d4e5f6",
  "object": "account_number",
  "account_id": "acc_test_b2c3d4e5f6g7",
  "created_at": "2026-06-22T12:00:00.000Z",
  "deleted_at": null,
  "description": "My payins",
  "is_root": false,
  "last_transfer_at": null,
  "metadata": {},
  "mode": "test",
  "number": "000000000000000000",
  "options": {
    "max_amount": 40000,
    "min_amount": 30000
  },
  "status": "enabled",
  "updated_at": "2026-06-22T12:00:00.000Z"
}
```

## Probar la integración

Confirma el comportamiento de deshabilitación y de los límites de monto en modo `test` antes de salir a producción. Usa una clave secreta de API `test` (`sk_test_...`) y el Account Number de prueba que creaste arriba.

Para probar un Account Number deshabilitado, deshabilítalo con la solicitud anterior y luego simula una transferencia entrante a su `number`. Fintoc rechaza la transferencia y la devuelve al remitente. La transferencia no aparece en tu estado de cuenta y no genera comisión.

Para probar los límites de monto, crea un Account Number con `min_amount` igual a `30000` y `max_amount` igual a `40000`, y luego simula dos transferencias entrantes:

* Una transferencia de `35000` (350.00 MXN) está dentro de los límites, por lo que Fintoc la acepta.
* Una transferencia de `20000` (200.00 MXN) está por debajo de `min_amount`, por lo que Fintoc la rechaza y la devuelve al remitente.

Puedes simular transferencias entrantes en modo `test` desde el endpoint [Simular recepción de una transferencia](/es/reference/transfers-api/simulation/transfers-simulate-receive).