Eventos
Eventos
Os eventos do ciclo de vida do jogador que a marca envia para o zt-partners.
Todos os eventos são enviados para POST /v1/integration/events (ou em lote em /events/batch) e compartilham quatro campos: type, event_id, occurred_at e external_player_id.
player.registered
Cadastro com btag. Cria a atribuição.
deposit.confirmed
Depósito pago. Avalia CPA.
withdrawal.confirmed
Saque pago. Entra no depósito líquido.
bet.placed
Aposta aceita. Avalia Turnover.
bet.settled
Resultado da aposta. Avalia RevShare.
bet.cancelled
Aposta anulada. Estorna comissões.
player.status_changed
Bloqueio / desbloqueio.
Boas práticas
event_iddeterminístico: derive do id interno (dep-<tx>,bet-<id>,settle-<id>). Assim reenvios nunca duplicam comissão.- Envie em ordem por jogador: cadastro antes de depósito,
bet.placedantes debet.settled. - Envie de forma assíncrona: coloque os eventos numa fila na sua marca e reenvie em falha. A API responde rápido e processa em background.