Saltar al contenido principal
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.
Una cuenta salario (SLRY) no puede recibir una clave nueva: la API la rechaza con 422 (PIX-0176). Si el directorio tiene la clave registrada a nombre de otra persona, la API responde 409 (PIX-0177), y una reclamación de propiedad es el siguiente paso habitual. Si el directorio tiene la clave registrada a nombre del mismo titular en otro participante, la API responde 409 (PIX-0178), y una reclamación de portabilidad es el siguiente paso habitual. 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.
Las mutaciones de reclamaciones distintas de la cancelación no están disponibles mientras VSync concilia. 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 de seguimiento. Por sí sola no demuestra que los fondos hayan regresado.
  1. Ábrelo con Crear recuperación de fondos y conserva el identificador interno devuelto. Envía userComplaintAt, el momento en que se registró la reclamación del usuario pagador en tu canal de atención. El campo es obligatorio, y un momento posterior a la apertura de la recuperación se rechaza con 422 (PIX-0100). Una respuesta 202 significa que BACEN aún no resolvió la creación, y la recuperación queda en PENDING. Vuelve a leerla más tarde: pasa a CREATED o responde 404 (PIX-0110) cuando BACEN no aplicó la creación.
  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. No debes usar una respuesta de no encontrado para distinguir el recurso de otro participante de un identificador desconocido.

​
Retén el saldo para un reporte de infracción

Crear un bloqueo de saldo en un reporte de infracción retiene un monto contra el reporte. Repetir el mismo requestRef repite el bloqueo. Liberar un bloqueo de saldo de un reporte de infracción lo libera.

​
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. Léelo con Listar estados de VSync, Listar trabajos de conciliación y Listar registros de conciliación. Inicia una verificación con Activar una verificación de sincronización o Activar la conciliación de archivos. 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 y lee 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.