Documentação

Español

Português
English

Español

Português
English

Appearance

Órdenes de la cola de pago ​

Requisitos previos de acceso

  • Permiso (módulo): processPaymentQueue (controla los botones en la UI) + manageToken (requerido por el backend de las rutas de cola)
  • Licencia/Feature: Ninguna específica.
  • Contenedor del menú: GENERAL → grupo Cobros (ruta /manage-payment-queues-timelines)

Relación con "Órdenes de Pago" (pagos judiciales)

Esta pantalla (etiqueta interna "Órdenes de Pago", ruta /manage-payment-queues-timelines) es la ejecución de las Colas de Pago — la cola de recompra de NFTs por prioridad. No confundir con la pantalla Órdenes de Pago (/manage-orders), del grupo Operaciones, que trata solicitudes/asignaciones de pagos judiciales.

Qué es / cuándo usar ​

Esta pantalla lista, en el orden de prioridad definido por las colas, cada NFT individual que está en la cola de pago y permite al operador liquidar (aprobar) el pago de cada una. Es el paso operativo que da vida a la configuración realizada en Colas de Pago.

Al aprobar una orden, el sistema:

  1. Paga al tenedor actual del NFT el monto price_paid (lo que pagó por el NFT), desde la billetera de la plataforma, en la moneda fiduciaria del tenant;
  2. Transfiere el NFT de vuelta al TKN_OWNER (el tenedor deja de poseerlo);
  3. Marca la orden como pagada y reordena las entradas restantes de la cola.

Requisitos previos ​

  • Permiso: processPaymentQueue para los botones en la UI; el backend valida manageToken en las rutas (getPaymentQueuesTimelines, executePaymentQueue). Permiso doble — enum CPM + módulo en DB.
  • Licencia/Feature: Ninguna específica.
  • Dependencias de otras pantallas: las Colas de Pago deben estar configuradas y tener NFTs seleccionados (por colección/atributo/valor). El tenedor del NFT debe tener una billetera válida y estar APPROVED.

Paso a paso ​

  1. Accede a Cobros → Órdenes de la cola de pago (ruta /manage-payment-queues-timelines).
  2. La lista viene ordenada (campo order) — de mayor a menor prioridad. Cada fila es un NFT.
  3. Identifica el NFT a pagar por el Nombre del activo y el NFT ID.
  4. Para las órdenes no pagadas, haz clic en el ícono de check (Aprobar) en la fila.
  5. El sistema ejecuta el pago al tenedor, devuelve el NFT al TKN_OWNER, marca la orden como Pagado = Sí y recarga la página.

Filtros y columnas ​

ColumnaQué muestraOrigen del dato
NombreNombre del activo/colección del NFTassetName (resuelto a partir del asset_id)
OrdenPosición del NFT en la cola (prioridad efectiva)order
NFT IDIdentificador on-chain del NFTblockchain_token_id
PagadoSi la orden ya fue liquidada (Sí/No)paid
AcciónBotón Aprobar (check), visible solo cuando paid = false—

La propia lista es la "línea de tiempo": el orden de visualización refleja la prioridad configurada en las colas. Las órdenes ya pagadas permanecen visibles con Pagado = Sí, pero sin acción.

Acciones y modales ​

  • Aprobar (check): llama a POST /v1/assets/executePaymentQueue con el id de la orden. No hay modal de confirmación — la acción es inmediata. En caso de éxito, muestra un snackbar y recarga la página.

Reglas de negocio / precauciones ​

Atención

  • La aprobación es inmediata y sin confirmación — un clic ya dispara el pago. Verifica el NFT (Nombre + NFT ID) antes de proceder.
  • El backend bloquea el repago: si la orden ya está pagada, executePaymentQueue lanza "It was already paid". Si el NFT o el usuario no se encuentran, la operación falla sin pagar.
  • El monto pagado es el price_paid del NFT (lo que pagó el tenedor), no un valor ingresado en pantalla.

Movimiento financiero efectivo

Aprobar una orden paga dinero real al tenedor y elimina el NFT de su posesión (vuelve al TKN_OWNER). Es una liquidación — trátala como irreversible desde el punto de vista operativo.

  • Valores financieros: el price_paid se trata como BigNumber — sin redondeo. El pago sale de la billetera de la plataforma en la moneda fiduciaria del tenant.
  • Idempotencia: un NFT ya pagado no se vuelve a pagar (guarda explícita paid); las transacciones al FinLib siguen la idempotencia por externalId (E00021 = ya procesado = éxito).
  • Estado APPROVED: el tenedor debe estar aprobado para recibir el pago en su billetera.

Pantallas relacionadas ​