Cassino
Os eventos de casino devem idealmente ser enviados na API de Integração FT CRM quando o Operador trabalha com um produto de casino.
♣️ Eventos em Tempo Real que Pode Enviar
O FT CRM processará o feed de dados brutos de eventos e construirá rondas de jogo, sessões de jogo e dados de segmentação relevantes com base nisso.
Conector RabbitMQ
Conector Kafka
REST API
Propriedades da Mensagem RabbitMQ
| key | value |
|---|---|
type | CASINO |
O tipo é esperado como uma propriedade (mas não no payload) da Mensagem RabbitMQ. Qualquer header será ignorado.
Headers da Mensagem Kafka
type | CASINO |
⬆️ POST /v1/integration/casino
Regras de Negócio:
- O evento Bet é enviado uma vez que uma aposta é colocada.
- O evento Win é enviado quando ocorre uma vitória.
- Os eventos Bet e Win devem ser enviados como eventos separados.
- Se uma aposta não resultar numa vitória, pode enviar um evento de perda ou uma vitória com um montante de 0 para fechar a ronda.
Exemplo de Payload - Aposta
Exemplo de Payload - Vitória
Exemplo de Payload - Perda (Greco)
Tipo de Dados
amount = wager_amount + bonus_wager_amount + locked_wager_amount
As propriedades obrigatórias estão marcadas com *
Chave | Tipo | Descrição |
activity_id * | string | ID único para cada evento |
amount * | float | O montante total (bonus_wager_amount + wager_amount + locked_wager_amount) |
balance_after | float | Saldo do jogador depois da ronda terminar |
balance_before | float | Saldo do jogador antes da ronda começar |
bonus_wager_amount | float | Montante (seja aposta ou vitória) se a ronda foi jogada usando dinheiro de bónus |
currency * | string
Formato: ISO 4217 | Moeda da transação |
exchange_rate * | float | Taxa de câmbio |
game_id * | string | game_id identifica o jogo de casino específico onde a aposta ou ronda teve lugar. Permite aos operadores rastrear a atividade do jogador por jogo e analisar padrões ou comportamentos associados a jogos específicos. O Fast Track associará este game_id com o comportamento do jogador, por isso é importante que seja enviado num formato consistente e único. |
game_name * | string | game_name representa o nome do jogo de casino onde a aposta ou ronda ocorreu.
O Fast Track mapeará todos os valores game_name recebidos nos eventos, por isso é importante que sejam enviados num formato consistente e único, seguindo a nomenclatura padrão da indústria para o jogo. |
game_type * | string Valores Aceites:
| Se "Live Casino", "Table" ou "Slots" estão sendo usados, certifique-se de enviar os valores como especificado. Se qualquer outro tipo de jogo estiver sendo usado, qualquer outra string é aceite. |
is_round_end | boolean | A ronda terminou? |
locked_wager_amount | float | Montante (seja aposta ou vitória) se a ronda foi jogada usando dinheiro de uma carteira "bloqueada" (quando dinheiro de bónus e real são combinados) |
origin * | string | A origem do utilizador |
round_id * | string | Enviar o mesmo para Aposta e Vitória |
status * | string
Valores Aceites:
| Indica se o evento deve ser revertido ou não. |
timestamp * | date
Formato: RFC3339 | Timestamp |
type * | string
Valores Aceites:
| O tipo de aposta colocada |
user_id * | string | O id do utilizador |
vendor_id * | string | vendor_id identifica o fornecedor de jogos ou estúdio que fornece o jogo de casino. Por favor certifique-se que é enviado num formato consistente e único em todos os eventos. |
vendor_name * | string | vendor_name representa o nome do fornecedor de jogos ou estúdio que fornece o jogo de casino. O Fast Track mapeará todos os valores vendor_name recebidos nos eventos, por isso é importante que sejam enviados num formato consistente e único, seguindo a nomenclatura padrão da indústria para o fornecedor. |
wager_amount | float | Montante (seja aposta ou vitória) se a ronda foi jogada usando dinheiro real. |
user_bonus_id ⚠️ | string | Identificador único do bónus creditado a um jogador. É obrigatório quando há aposta de bónus nesta ronda. Envie vazio ou omita o campo se não envolver um bónus. |
is_free_money | boolean | Indica se a transação é feita usando uma carteira gratuita, como Gold Coins ou qualquer outra moeda virtual.
Se a propriedade não estiver incluída no payload, será predefinida como false |
meta | object | Usado para valores diversos/auxiliares específicos da marca. |
Implementação Crypto
Ao implementar Eventos de Casino para transações de casino crypto, os seguintes campos devem ser enviados dentro da tag meta:
Sequência de Eventos
Os eventos são sensíveis à sequência. Abaixo encontrará diferentes cenários sobre como a sequência de eventos deve acontecer.
Cenário A - Eventos de Casino (ronda completa)
Evento de Casino - Aposta
Primeiro devemos receber um Evento de Casino com Tipo Bet com round_id definido como 12345
Evento de Casino - Vitória / Perda
Devemos então receber um Evento de Casino com Tipo Win ou Loss com round_id definido como 12345
Cenário B - Evento de Casino com Creditação de Bónus
**Evento de Bónus - Criado**
Primeiro devemos receber um evento de bónus com Status como Created e user_bonus_id definido como ABCD . É importante que o Timestamp deste evento seja o mais antigo. {% end