Enviar a atividade dos jogadores por API (depósitos, NGR, apostas)

As comissões de revshare e de CPA qualificado dependem do valor de cada jogador: depósitos, NGR, apostas. Em vez de exportar um relatório do CRM todos os meses, a marca pode enviar estes valores diretamente por API, todos os dias ou ao fim do mês.

O pedido

Um POST para /api/v1/players/activity, com uma chave de API da conta da marca (anunciante) com permissão de escrita. A chave cria-se no menu API do painel.

curl -X POST https://rastroaff.com/api/v1/players/activity \
  -H "Authorization: Bearer rst_..." \
  -H "Content-Type: application/json" \
  -d @activity.json

O corpo

Cada linha é um jogador num período. playerId e date são obrigatórios; o resto é opcional.

{
  "period": "MONTH",
  "rows": [
    { "playerId": "84731", "clickId": "01JC8Z5K9V3T6W2Q4R7Y1M0N8B", "date": "2026-10",
      "currency": "EUR", "deposits": 150, "depositCount": 3, "ngr": 62.5, "wager": 900 },
    { "playerId": "84732", "date": "2026-10", "deposits": 20, "ggr": 12 }
  ]
}

• playerId: o ID do jogador no CRM da marca.
• date: AAAA-MM-DD ou AAAA-MM. Com period MONTH (por defeito), passa ao dia 1 do mês.
• clickId: o click ID do RastroAff, que liga o jogador ao afiliado. Pode vir dentro de outro valor, como uma btag.
• deposits, depositCount, ngr, ggr, bonuses, withdrawals, chargebacks, wager: números, com ponto decimal.
• ftdDate, ftdAmount, registeredAt, country, currency (EUR por defeito).

A resposta

Diz quantas linhas ficaram ligadas a um afiliado, quantos jogadores são novos e quais as linhas sem afiliado, com o motivo.

{ "data": { "importId": "…", "rows": 2, "matched": 1, "newPlayers": 2, "unmatched": 1,
  "errors": [], "unmatchedSample": [{ "index": 1, "externalId": "84732", "clickId": null, "reason": "no_click_id" }] } }

Regras

• Até 5 000 linhas por pedido.
• Reenviar o mesmo jogador, período e moeda substitui os valores: podes enviar o mês em curso todos os dias.
• Linhas repetidas no mesmo pedido somam-se.
• Depois de ligado a um afiliado, o jogador continua ligado: as linhas seguintes podem vir sem clickId.
• Linhas inválidas vêm em errors, com o índice; as outras gravam-se.

Depois

Os valores entram no cálculo mensal das comissões, com revshare por escalões, deduções no NGR e CPA qualificado. Quem prefere ficheiros continua a poder importar o relatório do CRM: vê valor dos jogadores e revshare.