Agrega lógica a los Account Numbers

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 --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"
}
'

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

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:

{
  "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 --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
  }
}
'

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

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:

{
  "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.

Inicio

Recursos

Pagos

Transferencias

Movimientos

Agrega lógica a los Account Numbers

Deshabilitar un Account Number

Ejemplos de casos de uso

Deshabilitar un Account Number con la API

Establecer límites de monto para transferencias entrantes

Establecer límites con la API

Probar la integración

​Deshabilitar un Account Number

​Ejemplos de casos de uso

​Deshabilitar un Account Number con la API

​Establecer límites de monto para transferencias entrantes

​Establecer límites con la API

​Probar la integración

Deshabilitar un Account Number

Ejemplos de casos de uso

Deshabilitar un Account Number con la API

Establecer límites de monto para transferencias entrantes

Establecer límites con la API

Probar la integración