Integrar

Entregas de prêmios

Creditar bônus, giros e saldo no seu sistema e confirmar.

Prêmios do tipo client_delivered (bônus, giros grátis, saldo, cashback) só existem no seu sistema. O clube cria uma entrega pendente e pede para você creditar.

Chega o webhook reward.delivery_requested (ou o delivery_id volta na resposta da ação, no modo servidor).
Você credita no seu sistema, de forma idempotente pelo `delivery.id` (o mesmo aviso pode chegar de novo).
Você confirma: POST /v1/deliveries/{id}/confirm. O participante vê “Entregue”.
Não deu? POST /v1/deliveries/{id}/fail com o motivo. O Studio mostra a falha.

data de reward.delivery_requested

{
  "participant": { "id": "part_…", "external_id": "user_123" },
  "reward": {
    "id": "rwd_…",
    "code": "giros-20",
    "title": "20 giros grátis",
    "type": "client_delivered",
    "payload": { "kind": "free_spins", "spins": 20, "game": "fortune-tiger" }
  },
  "source": "redemption:giros-20",
  "delivery": {
    "id": "dlv_…",
    "confirm_url": "https://api.iclubing.com/v1/deliveries/dlv_…/confirm",
    "fail_url": "https://api.iclubing.com/v1/deliveries/dlv_…/fail"
  }
}

`payload.kind`	O que creditar
`cash`	`amount_cents` em saldo (cashback usa este).
`bonus`	`amount_cents` em bônus, com `rollover` quando houver.
`free_spins`	`spins` giros no jogo `game` (se vier).
outro	O que você configurar no prêmio, no Studio.

bash

curl -X POST https://api.iclubing.com/v1/deliveries/dlv_…/confirm \
  -H "Authorization: Bearer $ICLUBING_KEY" -H "Content-Type: application/json" \
  -d '{ "external_ref": "bonus_555", "details": { "game": "Fortune Tiger", "game_code": "fortune-tiger", "spins": 20 } }'

external_ref (até 200): o ID do crédito no seu sistema, para conciliar.
details (opcional, giros): spins, game, game_code, game_image, play_url — o clube mostra a capa e o botão “Jogar”.
Confirmar de novo devolve 200. Confirmar uma entrega que falhou: 409 already_closed.
Pendentes: GET /v1/deliveries?status=pending (até 200). Útil para uma rotina que confere se nada ficou para trás.
Sem confirmação em 48 h, o Studio avisa.