Os webhooks avisam o seu servidor sobre cada mudança em pagamentos, compras e saques. Adicione um endereço por projeto e verifique a assinatura em cada chamada.
Adicione o endereço
- Abra o projeto e preencha URL do webhook. Ela precisa ser um endereço https público.
- Clique em Salvar configurações e depois em Enviar test.ping. O painel mostra se o seu servidor aceitou.
O que enviamos
Um POST com corpo JSON: o tipo de evento (por exemplo deposit.in_hold, deposit.success, deposit.hold_returned, purchase.accepted ou payout.paid), se é live ou teste, e o próprio objeto. Todos os tipos de evento estão na referência da API.
Verifique a assinatura
Cada chamada traz um cabeçalho SkinPlata-Signature com um timestamp e uma assinatura HMAC-SHA256 feita com o seu segredo de assinatura do webhook. Calcule a partir do corpo bruto e compare antes de confiar em qualquer coisa. A referência da API tem exemplos prontos.
Responda rápido
Responda com qualquer status 2xx em poucos segundos e faça o trabalho demorado depois. Outras respostas contam como falha, e tentamos de novo por cerca de dois dias.
Credite com segurança
- Processe cada evento uma vez só: o mesmo evento pode chegar mais de uma vez.
- Leia o pagamento de novo pela API antes de liberar valor do seu lado.
- Retire o valor quando um pagamento for revertido, veja Proteção de troca e liberação antecipada.
Cada entrega, a resposta e as novas tentativas aparecem em Webhooks no painel. Se nada chegar, veja Webhooks não chegam: o que verificar.