Venue Authority

Verifica las instalaciones de servicio de alimentos contra los registros regulatorios compatibles.

Documentación

API de Venue Authority

Venue Authority verifica el nombre y la dirección de un comerciante de servicios de alimentación contra los registros regulatorios de EE. UU. compatibles. Cada decisión incluye la fuente coincidente y el límite de evidencia, para que los equipos de incorporación de comerciantes puedan mantener un recibo de auditoría en lugar de depender de un sí o no opaco.

Está diseñada para facilitadores de pagos, marketplaces, proveedores de KYB y plataformas de restaurantes que necesitan verificar ubicaciones durante la incorporación. Las operaciones de listas de vigilancia y webhooks están documentadas para espacios de trabajo compatibles. La expansión de monitoreo de pago aún no está disponible. Consulta la disponibilidad actual en las páginas de estado y precios.

Verifica la cobertura primero

El endpoint de cobertura no requiere una clave de API:

curl https://venueauthority.com/api/v1/coverage

La respuesta muestra las jurisdicciones, fuentes regulatorias, clases de fuentes y estado de actualización actualmente disponibles para la API. Verifícalo antes de enviar registros de comerciantes.

Consulta una decisión antes de registrarte

Abre el ejemplo público de Prueba de Portafolio para inspeccionar una decisión aceptada vinculada a la fuente, una decisión rechazada y el límite de evidencia. El ejemplo fijo no requiere una cuenta ni sube un archivo.

Prueba una decisión

Crea un espacio de trabajo verificado.
Crea una clave de prueba en el panel. Un espacio de trabajo verificado elegible recibe una asignación única de 25 unidades de prueba.
Envía un nombre de comerciante y una dirección con un ID de solicitud estable.

curl -X POST https://venueauthority.com/api/v1/resolve \
  -H 'Authorization: Bearer YOUR_ONE_TIME_KEY' \
  -H 'X-Request-Id: quickstart-000001' \
  -H 'Content-Type: application/json' \
  --data '{"name":"MERCHANT NAME","address":"STREET ADDRESS"}'

Una decisión válida devuelve la disposición, el motivo de la política, la identidad de la fuente, la clase de fuente, la atribución de la fuente, la instantánea y el límite de evidencia. Reenviar el mismo ID de solicitud con el mismo payload devuelve el resultado almacenado sin otro débito.

Archivos de integración

El contrato también cubre registros canónicos de instalaciones, portafolios, exportaciones de auditoría, webhooks e historial de entrega de webhooks.

Paquetes de cliente

El repositorio incluye tres integraciones revisadas y versionadas:

SDK de Node.js para Node 18 y versiones posteriores. No tiene dependencias de tiempo de ejecución.
SDK de Python para Python 3.9 y versiones posteriores. Usa solo la biblioteca estándar en tiempo de ejecución.
Servidor MCP para hosts MCP que necesiten cobertura pública, resolución de instalaciones o evidencia canónica de instalaciones.

El lanzamiento v0.1.0 incluye un paquete MCP de un clic y archivos descargables para los tres clientes. Los lanzamientos de npm y PyPI se documentarán aquí solo después de que la publicación correspondiente en el registro tenga éxito.

Límites del producto

Venue Authority resuelve una instalación enviada a un registro regulatorio compatible. No infiere el operador legal, no prueba que un negocio esté físicamente abierto ni busca fuera de la cobertura devuelta por la API. Las coincidencias inciertas se rechazan.

Enlaces

Este repositorio contiene artefactos públicos de integración. El uso de la API alojada se rige por los términos de Venue Authority.