Acreditación de Bonos

Los endpoints para soportar el Acreditado de Bonos son necesarios para soportar la integración básica de Fast Track. Las instrucciones sobre cómo enviarlos se enumeran a continuación.

El Servicio de Bonos está diseñado con semántica de entrega "al menos una vez". Esto significa que el servicio siempre intentará enviar cada evento de bono al menos una vez. Por ejemplo, si la API del Operador responde con un error 500, el Servicio de Bonos reintentará enviar el evento hasta que tenga éxito.
Para garantizar la idempotencia en su extremo, recomendamos usar el encabezado x-fasttrack-id incluido en cada solicitud enviada por Fast Track.
Este encabezado proporciona un identificador único para cada evento de bono, permitiéndole manejar de forma segura los reintentos sin duplicar el procesamiento de bonos.

⬆️ POST /bonus/credit

El Operador necesita proporcionar a Fast Track el endpoint de Crédito de Bono para asegurar que FT CRM pueda automatizar el acreditado de bonos.
Esto debería activar inmediatamente o hacer al jugador elegible para el bono. Esto depende de cómo el Operador esté manejando las interacciones de bonos con sus jugadores.

Notas

  1. ej. Si el jugador necesita optar por participar en el sitio para el bono, este endpoint debería hacer al jugador elegible para optar. El resto de la lógica debería ser manejada por el Operador
  2. Nuevos campos pueden ser agregados para ser pasados al Operador (ej. validity_amount) desde el FT CRM.

Solicitud

Código de Respuesta

200 OK - FT recibió confirmación de la API del Operador que el bono ha sido aceptado.
40X ERROR - Esto significa que la api del operador ha respondido, sin embargo no pudo acreditar el bono al jugador. Esto se clasifica como Acciones Fallidas.
50X ERROR - Este es un error del servidor, la api del operador no está respondiendo. FT continuará intentando acreditar el bono con el mecanismo de reintento integrado de FT. Por favor referirse a la verificación de idempotencia descrita en la parte superior de la página.

⬇️ GET /bonus/list

Este endpoint puede ayudar a mejorar el flujo de configuración de campañas de bonos cargando una lista de los bonos disponibles del operador. Este menú desplegable puede ser agregado manualmente en el back-office en cualquier momento seleccionando Menú Desplegable Dinámico en las configuraciones de campo.

Respuesta

Los payloads son sensibles a mayúsculas y minúsculas, por favor asegúrese de que el payload se alinee con el ejemplo a continuación.
200 OK
ERROR

⬆️ POST /bonus/credit/funds

Este endpoint puede ser usado para acreditar fondos inmediatamente a las billeteras de los jugadores. Un ejemplo de uso es poder automatizar el acreditado de cashback.

Solicitud

Código de Respuesta

200 OK - FT recibió confirmación de la API del Operador que el bono ha sido aceptado.
40X ERROR - Esto significa que la api del operador ha respondido, sin embargo no pudo acreditar el bono al jugador. Esto se clasifica como Acciones Fallidas.
50X ERROR - Este es un error del servidor, la api del operador no está respondiendo. FT continuará intentando acreditar el bono con el mecanismo de reintento integrado de FT. Por favor referirse a la verificación de idempotencia descrita en la parte superior de la página.

​📈‍ Reportes de Bonos

Fast Track incluirá los siguientes encabezados en todas las solicitudes salientes contra su API del Operador. Estos deben ser almacenados y enviados de vuelta en los Eventos de Bono, lo que permitirá al usuario final ver reportes sobre el costo de bonos para cada campaña en Fast Track Data Studio.
Descripción de cada encabezado: X-Fasttrack-Actioncommunicationprofileid = Perfil de Comunicación (traducción) usado X-Fasttrack-Actiongroupid = El grupo de acción que contiene las acciones X-Fasttrack-Actionid = Id de la acción (ej. Enviar SMS o Acreditar Bono) X-Fasttrack-Activityid = Id de la actividad en sí X-Fasttrack-Id = Id único por disparador, por usuario X-Fasttrack-Triggerhash = El Triggerhash se usa para identificar un envío único del mismo evento. es decir, solo debe tener una acción recibida con el mismo: activity_id, action_id, user_id, y Triggerhash. Si usa una actividad basada en tiempo para dirigirse a digamos 100 jugadores, todos esos 100 jugadores tendrán el mismo activity_id, action_id, y Triggerhash.