Webhook Stripe

Recebe notificações automáticas do Stripe.

URL para configurar no painel Stripe:

{sua_url}/api/v1/webhooks/stripe/{webhook_token}

Configuração no painel Stripe:

  1. Acesse Developers → Webhooks
  2. Clique em Add endpoint
  3. Informe a URL acima (substitua {webhook_token} pelo token retornado na criação da sua conta)
  4. Selecione os eventos desejados (ex: payment_intent.succeeded, charge.refunded)
  5. Copie o Signing secret (whsec_...) e salve nas credenciais:
    POST /api/v1/credentials
    { "gateway": "stripe", "credentials": { "secretKey": "sk_...", "webhookSecret": "whsec_..." } }

Validação: HMAC-SHA256 via header stripe-signature (com proteção anti-replay de 5 min).

Validação de assinatura: se o campo webhookSecret estiver nas suas credenciais cadastradas
(POST /api/v1/credentials), a assinatura do webhook será verificada automaticamente.
Se não estiver configurado, o webhook será aceito sem validação (com warning no log).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Token do webhook (retornado na criação do cliente)

Body Params
Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json