Cómo monitorear transferencias a partir de un importe mínimo
Configura un importe mínimo para un activo en Monitoreo: unidades base, umbral inclusivo y comprobación con datos artificiales.
Actualizado:
En Monitoreo puedes registrar transferencias a partir de un importe definido: configura el campo «Mínimo cantidad» en «Filtros avanzados» para una dirección del proyecto seleccionado. El umbral es un número entero en las unidades mínimas del activo elegido. La condición es inclusiva: una transferencia cuyo importe sea igual al umbral cumple el criterio; una inferior, no.
Empieza con un activo en una sola red. Por ejemplo, puedes querer monitorear transferencias entrantes de un token concreto a tu dirección. Esta regla se aplica al importe de una transferencia, no a su precio en dólares, a la suma de ingresos de un día ni a los mensajes de un proveedor externo.
Prepara el activo y las unidades
Selecciona un proyecto con el servicio «Monitoreo» disponible, una dirección pública y permiso para modificar sus ajustes. Asegúrate de que la red necesaria esté disponible para el monitoreo operativo. Añadir una dirección pública no requiere clave privada ni frase de recuperación.
Identifica el activo exacto y su número de decimales. El nombre del token no basta: la red y el identificador deben coincidir con el método de monitoreo elegido. Si recibes USDT, no trates distintas redes o tokens de aspecto similar como un mismo activo. La elección se explica en «En qué se diferencian una red y un token».
Convierte el importe legible por una persona a unidades base multiplicándolo por diez elevado al número de decimales del activo. No utilices un equivalente redondeado en dólares. Para un activo con seis decimales, un umbral de 10 unidades se escribe como 10000000. Es un ejemplo de escala, no un umbral universal para todas las monedas.
Paso 1. Abre el formulario para añadir una dirección
Abre «Monitoreo», selecciona el proyecto y la sección «Direcciones». Pulsa «Agregar direcciones». En la pestaña «Manualmente», elige la red e introduce la dirección pública. Espera el resultado de la comprobación de formato; verifica por separado la titularidad de la dirección y si la conexión está preparada.
En el bloque de uso de la dirección, selecciona «Un activo». Para la moneda nativa de la red deja vacío el campo «Activo»; para un token introduce el identificador compatible con la red elegida. En este ejemplo, deja habilitada la opción de entradas, «Entrando». Si necesitas salidas, comprueba por separado su compatibilidad y la configuración de dirección del movimiento.
No selecciones todos los activos en la primera regla: un mismo umbral numérico en distintas unidades mínimas no representa el mismo valor económico. Configurar un par concreto de red y activo permite comprobar el cálculo sin mezclar escalas.
Paso 2. Define el importe mínimo
Despliega «Filtros avanzados». En el campo de importe mínimo, «Mínimo cantidad», con la indicación «Base de unidades de red», introduce el entero calculado, por ejemplo 10000000 para la escala descrita arriba. Este valor corresponde al parámetro min_amount.
No introduzcas aquí una fracción decimal, un símbolo de moneda ni separadores de miles. Un valor vacío significa que no se ha definido un mínimo de importe específico. El número no se convierte automáticamente desde dólares ni se ajusta al tipo de cambio.
«Confirmaciones mínimas» es una condición distinta. No la cambies para compensar un error en el importe. El umbral se comprueba para cada transferencia evaluada: varios ingresos menores no se suman automáticamente para formar un pago que cumpla el criterio.
Paso 3. Guarda y comprueba la regla
Pulsa «Añadir dirección» y completa la comprobación de seguridad que se muestre si la cuenta la requiere. Después de guardar, abre la dirección, busca la regla del proyecto correcto y comprueba el activo, la dirección del movimiento y el mínimo registrado. Asegúrate de que la conexión esté activa; introducir un número correctamente no lo demuestra por sí solo.
Si una dirección se utiliza en varios proyectos, comprueba específicamente la regla seleccionada. Otro proyecto puede tener un umbral diferente y recibir otros eventos. Que una transferencia aparezca en otro proyecto no significa que se haya ignorado tu mínimo.
Paso 4. Comprueba el límite sin realizar una transferencia real
Para un umbral de 10000000, estos son los resultados esperados en unidades mínimas:
| Importe de la transferencia | Comprobación del importe |
|---|---|
| 9999999 | Inferior al umbral, no cumple |
| 10000000 | Igual al umbral, cumple |
| 10000001 | Superior al umbral, cumple |
Comprueba estos casos con datos artificiales preparados en una prueba local de tu integración. Todos los ejemplos deben tener la misma red, activo, dirección y sentido del movimiento; de lo contrario, estarás comprobando otra condición. No necesitas enviar criptomonedas para verificar la aritmética del filtro. Esta comprobación del límite no confirma la entrega de una notificación al destinatario elegido: la ruta de notificación se comprueba por separado.
Si el resultado difiere de lo esperado
Compara primero las unidades mínimas y la escala; después, el activo, la dirección del movimiento, el proyecto y si la regla está activa. Comprueba el importe real de la transferencia, no su estimación actual en la moneda de visualización. El TXID ayudará a investigar el registro. Un evento de Monitoreo por sí solo no confirma que un pedido esté pagado: hace falta vincularlo a una factura y comprobar su estado.