Lista consolidada e autoritativa dos tipos de evento que a Selectwin pode entregar aos seus
Lista consolidada e autoritativa dos tipos de evento que a Selectwin pode entregar aos seus
Webhook Endpoints. Ao criar/atualizar um endpoint, o campo
events[] aceita exatamente os valores listados aqui — um valor fora desta lista é rejeitado com
400 na criação/atualização do endpoint.
Cada entrega traz o envelope do evento e o cabeçalho X-Selectwin-Signature — sempre verifique a
assinatura (guia) antes de processar.
O objeto do recurso é entregue em payload.object (não em data):
{ "id": "wbh_01hqzvabc", "type": "transaction.approved", "source": "automatic", "payload": { "object": { "...": "objeto do recurso no momento do evento" } }, "correlationId": null, "updatedAt": "2026-06-20T17:56:33.000Z", "createdAt": "2026-06-20T17:56:33.000Z"}
type — o tipo do evento (uma das linhas acima).
source — origem do evento (automatic para eventos de plataforma; api para o ping de teste).
payload.object — o objeto do recurso (mesma forma da leitura do recurso).
correlationId — id de correlação da requisição originária, quando disponível.
Em fan-out de marketplace, o envelope entregue ao parent inclui também account (publicId da sub-conta).
Nota: ao ler um evento pela API (GET /v1/webhooks/events), o objeto do recurso aparece no campo
data da resposta da API — equivalente ao payload.object entregue ao seu endpoint.