API
Auditoría, privacidad y retención
Qué guarda el servicio por cada validación#
| Registro | Contenido | Datos personales |
|---|---|---|
| Auditoría (inmutable: no se puede modificar ni borrar desde la aplicación) | audit_ref, validation_ref, identificadores internos del comercio y de la integración, canal, huella criptográfica (SHA-256) de la solicitud normalizada, estado, decisión del motor, categoría y versión de Huella, estado de evidencia, puerta de dirección, efecto de política, next_action, estado de consumo y fecha. | No guarda el teléfono, la dirección, el valor ni tu referencia de pedido en claro. La huella de solicitud es un dato seudonimizado: un teléfono tiene poca entropía, así que trátala como dato personal. |
| Respuesta sellada (para idempotencia y readback) | La respuesta JSON (incluye tu external_order_ref, la decisión y las referencias) y la huella de la solicitud. | No guarda teléfono ni dirección en claro; sí tu referencia de pedido. |
| Cuenta de cupo | Una clave por comprador, día y comercio, derivada con un hash del teléfono (no el teléfono). | Seudonimizada. |
| Límite de solicitudes | Contadores por integración y por comercio. | No. |
El servicio no escribe en sus registros de operación los cuerpos ni las cabeceras de las solicitudes.
Para calcular la decisión, el motor consulta la Huella del número (evidencia de historial). La retención y el origen de esos datos no se describen aquí y están pendientes de documentar.
Retención#
| Dato | Plazo configurado |
|---|---|
| Respuestas selladas | 7 días. Pasado ese plazo, reutilizar la misma Idempotency-Key vuelve a ejecutar la validación y el readback devuelve 404: usa una clave nueva por pedido. |
| Ejecuciones abandonadas | 24 horas tras vencer el plazo de la operación. |
| Contadores de límite | 24 horas. |
| Secretos rotados vencidos | 30 días tras vencer. |
| Auditoría | Sin plazo definido para la API de canales. La política vigente fija 12 meses para los resultados de validación de la app de Shopify; alinear la auditoría de la API con ese plazo está pendiente de decisión. |
| Cuenta de cupo | Sin plazo definido (es la base de la facturación). |
Eliminación#
- No hay eliminación por API ni autoservicio.
- La auditoría es inmutable por diseño; borrarla sería un procedimiento excepcional del operador, que aún no está definido.
- La política vigente indica que las solicitudes de eliminación de compradores se atienden en un plazo de 30 días y describe cómo ejercer tus derechos. Para los datos de la API de canales ese procedimiento está pendiente de confirmar Por verificar.
- Mientras tanto, escribe por Contacto.
Qué datos acepta la API#
Solo lo necesario para validar: el teléfono del comprador, los datos de entrega, el valor del pedido y referencias opacas tuyas. La API rechaza nombres, correos, documentos de identidad y textos de conversación (FORBIDDEN_FIELD).
- No pongas datos personales en
external_order_ref,sku_refnitrace.conversation_ref. - No pegues el texto de la conversación del comprador en ningún campo.
Pendiente de definir Por verificar#
Actualización de la política de privacidad para cubrir la API de canales (roles, finalidades, conservación); base legal; términos de encargado del tratamiento; plazo de retención de la auditoría y de la cuenta de cupo; retención en el motor de Huella; procedimiento de eliminación; ubicación del almacenamiento. Esta documentación no los afirma.