Bono
El evento de bono te dará la capacidad de ver los costos reales de bonos asociados a tus campañas. También te permitirá activar actividades en cambios de estado de bonos, por ejemplo, si se pierde muy
REST API
RabbitMQ Connector
Kafka Connector
⬆️ POST /v1/integration/bonus
Propiedades del Mensaje de RabbitMQ
| clave | valor |
|---|---|
type | BONUS |
El tipo se espera como una propiedad (pero no en la carga útil) del Mensaje de RabbitMQ. Cualquier encabezado será ignorado.
Encabezados del Mensaje de Kafka
| clave | valor |
|---|---|
type | BONUS |
Reglas de Negocio:
- Cada bono creado necesita tener su conclusión [Completed, AutoCompleted, Forfeited, Expired o Lost].
- Un user_bonus_id dentro de un status debe ser único.
- Es importante que solo se envíe un evento cuando el estado del bono cambie. Múltiples eventos del mismo estado resultarán en que los datos de segmentación sean incorrectos.
Solicitud
Cuando se envíen bonos de 'giros gratis', esperamos que el primer evento de bono se envíe una vez que las rondas de giros gratis hayan sido completadas y con el "amount" correspondiente que se ganó.
Si deseas enviar datos cuando se han emitido los giros gratis, podrías enviar esto como un 'Evento Personalizado'.
Las propiedades requeridas están marcadas con *
Clave | Tipo | Descripción |
amount * | float | La cantidad asignada al bono. |
bonus_code | string | Indicación sobre la naturaleza de la promoción, ej. "WELCOME100" |
bonus_id * | string | Identificador único para cada campaña de bonos. |
bonus_turned_real | float | Cantidad del bono convertida a dinero real, si las apuestas están terminadas |
currency * | string
Formato: ISO4217 | Moneda del jugador |
exchange_rate * | float | La tasa de cambio en el timestamp |
locked_amount | float | Cantidad del bono bloqueada para las apuestas |
meta | object | Si se requiere enviar meta datos |
origin * | string | Este valor puede usarse para identificar la marca o jurisdicción en la que está jugando el jugador |
product * | string
Valores Aceptados:
"Casino"
"Sportsbook"
"Lotto"
"Poker"
"Live Casino" | Define el producto asociado al bono |
required_wagering_amount | float | Cantidad de apuesta requerida del bono |
status * | string
Valores Aceptados:
"Created"
"Completed"
"AutoCompleted"
"Forfeited"
"Expired"
"Lost" | El estado asignado al bono al momento de enviar el evento en tiempo real. |
timestamp * | string
Formato: RFC3339 | Timestamp del evento siendo enviado. Se requiere tiempo exacto a milisegundos aquí para asegurar precisión. |
type * | string
Valores Aceptados: "NoDeposit"
"WelcomeBonus"
"CashbackBonus"
"ReloadBonus" "WagerFree"
"FreeSpins" "RiskFreeBet" "Undefined" | Debe ser uno de los valores especificados en la lista. Si no, por favor envía "Undefined". Podemos ayudar a mapear tus tipos de bonos actuales a la lista definida aquí. |
user_bonus_id | string | Identificador único del bono acreditado a un jugador. Puede establecerse como un valor aleatorio, la sugerencia es ser id de usuario + id de bono. |
user_id * | string | Id de usuario del jugador al que se le ha acreditado el bono. |
is_free_money | boolean | Indica si la transacción se realiza o no usando una billetera de juego gratuito, como Monedas de Oro o cualquier otra moneda virtual.
Si la propiedad no está incluida en la carga útil, por defecto será false |
fasttrack_references | object | Datos proporcionados por Fast Track en cualquier solicitud de acreditación de bonos. Estos datos se utilizan para actualizar la cantidad de bono otorgada y la cantidad de bono convertida a real en los informes de conversión de actividades. |
Buenas Prácticas - Tipo de Bono
Al mapear tu tipo de bono a uno de los valores aceptados por Greco, puede ser una tarea desafiante. Ten en cuenta que Greco opera a través de varios operadores, y trabajamos con los tipos más comunes en la industria.
Trata de evitar enviar un tipo de bono "Undefined".
Descripciones de estados
Estado | Descripción |
Created | Cuando el bono ha sido reclamado y los fondos se agregan a la cuenta del jugador. |
Completed | Si se cumple el requisito de apuesta y los fondos del bono se convierten en fondos reales. |
AutoCompleted | Si tu sistema automáticamente remueve el bono con una configuración general.
ej. Los bonos se autocompletar si el saldo llega a menos de €0.10 |
Forfeited | Si el bono ha sido perdido. |
Expired | Si el período de validez del bono ha expirado. |
Lost | Si el jugador se ha quedado sin saldo de bono. |
Secuencia de Eventos
El bonus_id y el user_bonus_id juntos forman una clave única. Cada bono Created necesita tener su conclusión: Completed, AutoCompleted, Forfeited, Expired o Lost. Así que si se envía un {bonus_id:1, user_bonus_id:1, status:Created}, en algún punto debe enviarse un {bonus_id:1, user_bonus_id:1, status:Completed}.
Escenario A - Bono Creado y Completado
Evento de Bono - Creado
Primero, deberíamos recibir un Evento de Bono con su bonus_id y user_bonus_id teniendo su estado como Created
&#xNAN;{bonus_id:1, user_bonus_id:1, status:Created, ...}
Evento de Bono - Completado
Una vez que el bono esté completado, entonces deberíamos recibir un Evento de Bono con su bonus_id y user_bonus_id teniendo su estado como Completed
&#xNAN;{bonus_id:1, user_bonus_id:1, status:Completed, ...}
Escenario A - Bono Creado y Expirado
Evento de Bono - Creado
Primero, deberíamos recibir un Evento de Bono con su bonus_id y user_bonus_id teniendo su estado como Created
&#xNAN;{bonus_id:1, user_bonus_id:1, status:Created, ...}
Evento de Bono - Expirado
Una vez que el bono esté completado, entonces deberíamos recibir un Evento de Bono con su bonus_id y user_bonus_id teniendo su estado como Expired
&#xNAN;{bonus_id:1, user_bonus_id:1, status:Expired, ...}
Lo mismo debe seguirse para AutoCompleted, Forfeited o Lost status
Si el user_bonus_id se envía con el mismo status, incluso con un bonus_id y cantidades diferentes, será considerado un evento duplicado, y el último será descartado, ya que el user_bonus_id es la identificación de acreditación de bono del usuario.