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
- 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
- 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.