Creditação de Bônus

Endpoints para suportar Creditação de Bônus são necessários para suportar a integração básica do Fast Track. As instruções sobre como enviá-los estão listadas abaixo.

O Serviço de Bônus é projetado com semântica de entrega "pelo menos uma vez". Isso significa que o serviço sempre tentará enviar cada evento de bônus pelo menos uma vez. Por exemplo, se a API do Operador responder com um erro 500, o Serviço de Bônus tentará reenviar o evento até que seja bem-sucedido.
Para garantir idempotência do seu lado, recomendamos usar o cabeçalho x-fasttrack-id incluído em cada solicitação enviada pelo Fast Track.
Este cabeçalho fornece um identificador único para cada evento de bônus, permitindo que você trate com segurança as tentativas sem duplicar o processamento de bônus.

⬆️ POST /bonus/credit

O Operador precisa fornecer ao Fast Track o endpoint de Creditação de Bônus para garantir que o FT CRM possa automatizar a creditação de bônus.
Isso deve imediatamente ativar ou tornar o jogador elegível para o bônus. Isso depende de como o Operador está lidando com as interações de bônus com seus jogadores.

Notas

  1. ex. Se o jogador precisar optar pelo bônus no site, este endpoint deve tornar o jogador elegível para optar. O resto da lógica deve ser tratado pelo Operador
  2. Novos campos podem ser adicionados para serem passados ao Operador (ex. validity_amount) do FT CRM.

Solicitação

Código de Resposta

200 OK - FT recebeu confirmação da API do Operador de que o bônus foi aceito.
40X ERROR - Isso significa que a API do operador respondeu, porém não conseguiu creditar o bônus ao jogador. Isso é classificado como Ações Falhadas.
50X ERROR - Este é um erro do servidor, a API do operador não está respondendo. FT continuará tentando creditar o bônus com o mecanismo de retry incorporado do FT. Consulte a verificação de idempotência descrita no topo da página.

⬇️ GET /bonus/list

Este endpoint pode ajudar a melhorar o fluxo de configuração de campanhas de bônus carregando uma lista dos bônus disponíveis do operador. Este dropdown pode ser adicionado manualmente no back-office a qualquer momento selecionando Dynamic Dropdown nas configurações do campo.

Resposta

As cargas úteis são sensíveis a maiúsculas e minúsculas, por favor certifique-se de que a carga útil está alinhada com o exemplo abaixo.
200 OK
ERROR

⬆️ POST /bonus/credit/funds

Este endpoint pode ser usado para creditar fundos imediatamente às carteiras dos jogadores. Um exemplo de uso é poder automatizar a creditação de cashback.

Solicitação

Código de Resposta

200 OK - FT recebeu confirmação da API do Operador de que o bônus foi aceito.
40X ERROR - Isso significa que a API do operador respondeu, porém não conseguiu creditar o bônus ao jogador. Isso é classificado como Ações Falhadas.
50X ERROR - Este é um erro do servidor, a API do operador não está respondendo. FT continuará tentando creditar o bônus com o mecanismo de retry incorporado do FT. Consulte a verificação de idempotência descrita no topo da página.

​📈‍ Relatórios de Bônus

O Fast Track incluirá os cabeçalhos abaixo em todas as solicitações de saída contra sua API do Operador. Estes devem ser armazenados e enviados de volta nos Eventos de Bônus, o que permitirá ao usuário final visualizar relatórios sobre o custo de bônus para cada campanha no Fast Track Data Studio.
Descrição de cada cabeçalho: X-Fasttrack-Actioncommunicationprofileid = Perfil de Comunicação (tradução) usado X-Fasttrack-Actiongroupid = O grupo de ação contendo as ações X-Fasttrack-Actionid = Id da ação (ex. Enviar SMS ou Creditar Bônus) X-Fasttrack-Activityid = Id da própria atividade X-Fasttrack-Id = Id único por trigger, por usuário X-Fasttrack-Triggerhash = O Triggerhash é usado para identificar um envio único do mesmo evento. ou seja, você deve ter apenas uma ação recebida com o mesmo: activity_id, action_id, user_id, e Triggerhash. Se você usar uma atividade baseada em tempo para atingir digamos 100 jogadores, todos esses 100 jogadores terão o mesmo activity_id, action_id, e Triggerhash.