Acknowledge a mobile retention message handoff
Requiere retention:view y retention:edit. Es idempotente y se limita al proyecto, entrega y receiptToken. Informa ACCEPTED cuando el proveedor acepte la notificación, DELIVERED solo con evidencia del proveedor o dispositivo, FAILED si no se ha entregado, OPENED cuando el usuario abra realmente la notificación y CLICKED después de una interacción deliberada. Envía los recibos desde el servidor del comercio; nunca incluyas la clave secreta ni receiptToken en la aplicación móvil. La apertura y el clic implican entrega. Los recibos repetidos o desordenados conservan las primeras fechas y no revierten DELIVERED. Bitelio nunca repite automáticamente una entrega incierta. Si el seguimiento está desactivado o el cliente lo ha retirado, no se registran fechas de interacción. Límite de 120 solicitudes/minuto compartido por proyecto.
Authorization
ApiKeyAuth Autenticación mediante clave de API. Las claves secretas (sk_*) son obligatorias en todos los endpoints excepto /v1/track. Las claves públicas (pk_*) solo funcionan con el endpoint /v1/track para el seguimiento de eventos desde el cliente. El proyecto se deriva automáticamente de la clave.
In: header
Path Parameters
length <= 100Request Body
application/json
uuid"ACCEPTED" | "DELIVERED" | "FAILED" | "OPENED" | "CLICKED"Response Body
application/json
curl -X POST "https://bitelio-api.heltia.com/v1/retention/messages/string/receipt" \ -H "Content-Type: application/json" \ -d '{ "receiptToken": "f7b0d1df-daa1-490a-b9fc-05372d34c946", "status": "ACCEPTED" }'{
"acknowledged": true
}