Estados de origen e invitaciones seguras

La API 2026-10 permite informar del estado original del pedido sin decidir si Revi envía una solicitud de reseña. Esa política la configura el comercio en Revi.

Secuencia

1. Obtén un grant para la tienda y otro para la conexión.
2. Sustituye el catálogo completo con una catalog_revision creciente.
3. Envía cada transición con event_id estable, revision creciente, fecha de origen, dimensiones y etiquetas.
4. Consulta la política efectiva y el histórico de elegibilidad sin PII sensible cuando sea necesario.

Los estados desconocidos quedan en espera (wait). Reutilizar una revisión, evento o clave idempotente con contenido distinto devuelve 409; tras un timeout, repite exactamente la misma solicitud.

Las etiquetas usan coincidencia exacta sin distinguir mayúsculas. Los clientes las sincronizan, pero solo el comercio puede configurarlas como bloqueo desde Revi.

Backfills

Los backfills refresh_state_only devuelven 202 y no pueden crear ni reencolar invitaciones. Sí pueden cancelar trabajo aún no aceptado por Mailer. Envía siempre Idempotency-Key.

Añadirlo a una integración 2026-10 existente

Estos recursos son una parte aditiva de 2026-10: el resto de recursos, scopes y respuestas de 2026-10 no cambia, así que una integración que funciona sigue funcionando sin tocar nada. No hay migración de versión que hacer.

1. Solicita solo los scopes nuevos que necesite la integración. No se conceden automáticamente a credenciales existentes.
2. Lista las conexiones de la tienda y conserva los connection_id concedidos.
3. Publica un catálogo completo y versionado de estados para cada conexión.
4. Envía eventos monotónicos de estado fuente por pedido. Reutiliza un event_id únicamente con un payload idéntico.
5. Usa backfills refresh_state_only para refrescar el histórico.
6. Consulta la política efectiva y la auditoría para explicar por qué un pedido está esperando, es elegible o está cancelado.

Conserva las escrituras legacy de pedidos durante el handover coordinado del módulo.

Garantías de seguridad

• Reutilizar una revisión o clave de idempotencia con otro payload devuelve 409 y no sobrescribe el estado almacenado.
• Los estados fuente desconocidos quedan en espera de forma segura.
• Los clientes de API pública no pueden modificar políticas ni usar un backfill para crear invitaciones.
• Las respuestas de auditoría y elegibilidad nunca exponen IP, user agent, email ni otros datos personales sensibles.

Consulta la referencia 2026-10.