Skip to main content
DICT gestiona el directorio de claves Pix y los flujos de disputa relacionados. Usa la API pública para las acciones del cliente; el plugin coordina las llamadas al proveedor y el estado local.

​
Registra y resuelve una clave

  1. Crea una entrada con Crear entrada. Envía el ámbito de la cuenta, el motivo obligatorio y los headers de idempotencia.
  2. Guarda el identificador de la entrada y léela con Obtener entrada.
  3. Resuelve una clave con Consultar clave antes de un pago basado en una clave, o usa Comprobar existencia de claves para una comprobación por lote.
  4. Actualiza o elimina solo mediante las rutas públicas del ciclo de vida de la entrada. No trates una consulta como prueba de propiedad de otra cuenta.
La creación y actualización de entradas pueden fallar de forma segura cuando su almacén de repeticiones no está disponible. Un 503 en esa situación no es una señal segura para repetir la acción de negocio con una clave nueva.

​
Mueve una clave mediante una reclamación

Las reclamaciones cubren la propiedad y la portabilidad. Un flujo del cliente es el siguiente:
  1. Abre la reclamación con Crear reclamación.
  2. Léela con Obtener reclamación.
  3. Usa la transición que corresponda al rol y al estado de la reclamación: confirmar, completar, reconocer o cancelar.
La mayoría de las mutaciones de reclamaciones no están disponibles mientras VSync concilia el ámbito afectado. La cancelación de una reclamación es deliberadamente independiente: sigue siendo una salida para una reclamación activa y no una nueva fuente de deriva del directorio.

​
Gestiona un caso MED 2.0

Una recuperación de fondos abre un caso seguido; por sí sola no demuestra que los fondos hayan regresado.
  1. Ábrelo con Crear recuperación de fondos y conserva el identificador interno devuelto.
  2. Lee el caso, sus informes de infracción relacionados y su grafo de seguimiento mediante las operaciones de referencia correspondientes.
  3. Actualiza solo los campos mutables de contacto o informe con el contrato documentado de merge patch.
  4. Cuando el caso alcance el estado que lo permite, inicia su devolución mediante la operación documentada de devolución de recuperación de fondos. Lee el caso otra vez para observar el nuevo estado.
  5. Cancela solo cuando su estado actual permita la cancelación.
El plugin limita las recuperaciones de fondos al participante autenticado. Una respuesta de no encontrado no debe usarse para distinguir el recurso de otro participante de un identificador desconocido.

​
Registra y cancela un marcador de fraude

Usa Crear marcador de fraude con una identidad de solicitud creada por el cliente. Una repetición con la misma identidad y payload devuelve el mismo marcador; un payload diferente se rechaza. Usa Listar marcadores de fraude o Obtener marcador de fraude para inspeccionarlo, y Cancelar marcador de fraude cuando el marcador ya no deba aplicarse.

​
Deja que VSync proteja la coherencia de las claves

VSync concilia el estado local de las claves con el directorio por ámbito. Avanza desde la verificación hasta la sincronización de eventos y, cuando hace falta, la conciliación de archivos. VSync es una superficie operativa interna en v1.0.0; las aplicaciones cliente observan su efecto mediante el bloqueo 503 sobre mutaciones protegidas y no llaman a sus rutas de estado, trabajos, registros ni acciones de conciliación. Mientras un ámbito se concilia, DICT rechaza las mutaciones protegidas con 503 en lugar de aceptar un cambio que podría añadir nueva deriva. Espera a que el ámbito vuelva a estar disponible; pide al operador que inspeccione el estado de VSync si el bloqueo persiste. No evites el bloqueo mediante callbacks del adaptador ni cambios directos en el almacenamiento. Para las retenciones y devoluciones de pagos disputados, continúa con SPI y el Block Balancer.