Agrega lógica a los Account Numbers

Asigna un Account Number a los pagos de un usuario, o crea un Account Number de un solo uso para una orden de pago. Usa esta guía para deshabilitar un Account Number y para establecer límites mínimos y máximos de monto. Estos controles permiten que Fintoc rechace transferencias entrantes no deseadas. Los dos controles difieren en dónde aplican:

Deshabilitar un Account Number funciona en Chile y México.
Los límites de monto aplican a los Account Numbers mexicanos, que usan el formato de número de cuenta bancaria mexicano estandarizado (CLABE).

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 paga dos veces, Fintoc devuelve el segundo pago.

Deshabilitar un Account Number con la API

Envía una solicitud PATCH con status en disabled. La API devuelve el Account Number actualizado:

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"
)

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

Los límites de monto están disponibles para los Account Numbers mexicanos. 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

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

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,
  },
)

{
  "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 un Account Number de prueba. 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.

​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