Webhooks

• Autenticação: API key (sk_test_...) ou sessão do app do seller
• Escopos: webhooks:write
• URL: https://api.v2.wolfpayteste.online/v1/webhooks/deliveries

Parâmetros

Resposta 200

Entregas, mais recentes primeiro.

{
  "data": [
    {
      "id": "whd_5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c",
      "endpoint_id": "whe_3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a",
      "event_id": "evt_7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e",
      "event_type": "webhook.test",
      "attempt": 1,
      "status": "pending",
      "response_status": null,
      "latency_ms": null,
      "created_at": "2026-11-06T12:00:00.000Z"
    }
  ]
}

Erros

• 401 — AUTHENTICATION_REQUIRED
• 403 — FORBIDDEN
• 409 — TENANT_SELECTION_REQUIRED
• 429 — RATE_LIMITED
• 500 — INTERNAL_ERROR

Nova tentativa do mesmo evento (mesmo event_id, attempt maior) para o mesmo endpoint. Endpoint desativado → 409 WEBHOOK_ENDPOINT_DISABLED.

• Autenticação: API key (sk_test_...) ou sessão do app do seller
• Escopos: webhooks:write
• URL: https://api.v2.wolfpayteste.online/v1/webhooks/deliveries/{id}/replay

Parâmetros

Corpo da requisição (opcional)

Objeto EmptyRequest

EmptyRequest

{}

Resposta 202

Nova entrega criada.

Objeto WebhookDelivery

{
  "id": "whd_5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c",
  "endpoint_id": "whe_3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a",
  "event_id": "evt_7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e",
  "event_type": "payment.paid",
  "attempt": 2,
  "status": "pending",
  "response_status": null,
  "latency_ms": null,
  "created_at": "2026-11-06T12:00:00.000Z"
}

Erros

• 400 — IDEMPOTENCY_KEY_REQUIRED,VALIDATION_FAILED
• 401 — AUTHENTICATION_REQUIRED
• 403 — FORBIDDEN
• 404 — RESOURCE_NOT_FOUND
• 409 — IDEMPOTENCY_CONFLICT,IDEMPOTENCY_IN_PROGRESS,TENANT_SELECTION_REQUIRED,WEBHOOK_ENDPOINT_DISABLED
• 429 — RATE_LIMITED
• 500 — INTERNAL_ERROR

Lista os endpoints do seller, sem os excluídos.

• Autenticação: API key (sk_test_...) ou sessão do app do seller
• Escopos: webhooks:write
• URL: https://api.v2.wolfpayteste.online/v1/webhooks/endpoints

Parâmetros

Resposta 200

Endpoints.

{
  "data": [
    {
      "id": "whe_3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a",
      "url": "https://example.com/wolf/webhooks",
      "enabled": true,
      "status": "active",
      "disabled_reason": null,
      "consecutive_failures": 0,
      "selected_events": [
        "payment.paid",
        "payment.canceled"
      ],
      "product_ids": [],
      "payment_methods": [],
      "delivery_mode": "live",
      "secret_rotated_at": null,
      "deleted_at": null,
      "created_at": "2026-11-06T12:00:00.000Z"
    }
  ]
}

Erros

• 401 — AUTHENTICATION_REQUIRED
• 403 — FORBIDDEN
• 409 — TENANT_SELECTION_REQUIRED
• 429 — RATE_LIMITED
• 500 — INTERNAL_ERROR

Cadastra uma URL HTTPS. live (padrão recomendado) exige sessão humana do seller e devolve o signing_secret uma única vez; em produção simulated é recusado (400). URLs da própria Wolf e destinos privados são recusados. Repetir a requisição com a mesma Idempotency-Key e o mesmo corpo devolve a mesma resposta com idempotent-replayed: true; corpo diferente → 409 IDEMPOTENCY_CONFLICT.

• Autenticação: API key (sk_test_...) ou sessão do app do seller
• Escopos: webhooks:write
• URL: https://api.v2.wolfpayteste.online/v1/webhooks/endpoints

Parâmetros

Corpo da requisição

Objeto CreateWebhookEndpointRequest

{
  "url": "https://example.com/wolf/webhooks",
  "selected_events": [
    "payment.paid",
    "payment.canceled"
  ],
  "delivery_mode": "live"
}

Resposta 201

Endpoint criado (live com o segredo, replay sem ele, ou simulated).

Um destes formatos:

• CreatedLiveWebhookEndpoint | ReplayedLiveWebhookEndpoint
• WebhookEndpoint

{
  "id": "whe_3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a",
  "url": "https://example.com/wolf/webhooks",
  "enabled": true,
  "status": "active",
  "disabled_reason": null,
  "consecutive_failures": 0,
  "selected_events": [
    "payment.paid",
    "payment.canceled"
  ],
  "product_ids": [],
  "payment_methods": [],
  "delivery_mode": "live",
  "secret_rotated_at": null,
  "deleted_at": null,
  "created_at": "2026-11-06T12:00:00.000Z",
  "signing_secret": "whsec_live_EXEMPLO_nao_use_em_producao"
}

Erros

• 400 — IDEMPOTENCY_KEY_REQUIRED,VALIDATION_FAILED
• 401 — AUTHENTICATION_REQUIRED
• 403 — FORBIDDEN
• 409 — IDEMPOTENCY_CONFLICT,IDEMPOTENCY_IN_PROGRESS,TENANT_SELECTION_REQUIRED
• 429 — RATE_LIMITED
• 500 — INTERNAL_ERROR
• 503 — SERVICE_UNAVAILABLE

status: disabled grava disabled_reason: "manual"; active limpa o motivo e zera consecutive_failures. product_ids (produtos da própria conta) e payment_methods (card, pix) substituem os filtros de entrega; lista vazia = todos. A entrega respeita os três filtros (eventos, produtos e métodos). Eventos de uma venda (payment.*, refund.*, dispute.*, order.*, checkout.session.*) só passam por um filtro não vazio quando o produto ou o método é conhecido e está na lista; eventos da conta (payout.*, settlement.*, …) ignoram os filtros de produto e método. Informe ao menos um campo; repetir os valores atuais não muda nada.

• Autenticação: API key (sk_test_...) ou sessão do app do seller
• Escopos: webhooks:write
• URL: https://api.v2.wolfpayteste.online/v1/webhooks/endpoints/{id}

Parâmetros

Corpo da requisição

Objeto UpdateWebhookEndpointRequest

{
  "product_ids": [
    "prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e"
  ],
  "payment_methods": [
    "pix"
  ]
}

Resposta 200

Endpoint.

Objeto WebhookEndpoint

{
  "id": "whe_3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a",
  "url": "https://example.com/wolf/webhooks",
  "enabled": true,
  "status": "active",
  "disabled_reason": null,
  "consecutive_failures": 0,
  "selected_events": [
    "payment.paid",
    "payment.canceled"
  ],
  "product_ids": [
    "prd_7e6d5c4b3a2918f7e6d5c4b3a2918f7e"
  ],
  "payment_methods": [
    "pix"
  ],
  "delivery_mode": "live",
  "secret_rotated_at": null,
  "deleted_at": null,
  "created_at": "2026-11-06T12:00:00.000Z"
}

Erros

• 400 — VALIDATION_FAILED
• 401 — AUTHENTICATION_REQUIRED
• 403 — FORBIDDEN
• 404 — RESOURCE_NOT_FOUND
• 409 — INVALID_STATE_TRANSITION,TENANT_SELECTION_REQUIRED
• 429 — RATE_LIMITED
• 500 — INTERNAL_ERROR

Exclusão lógica e terminal: o endpoint some da listagem e responde 404 depois.

• Autenticação: API key (sk_test_...) ou sessão do app do seller
• Escopos: webhooks:write
• URL: https://api.v2.wolfpayteste.online/v1/webhooks/endpoints/{id}

Parâmetros

Resposta 200

Endpoint excluído.

Objeto WebhookEndpoint

{
  "id": "whe_3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a",
  "url": "https://example.com/wolf/webhooks",
  "enabled": false,
  "status": "deleted",
  "disabled_reason": null,
  "consecutive_failures": 0,
  "selected_events": [
    "payment.paid",
    "payment.canceled"
  ],
  "product_ids": [],
  "payment_methods": [],
  "delivery_mode": "live",
  "secret_rotated_at": null,
  "deleted_at": "2026-11-06T12:10:00.000Z",
  "created_at": "2026-11-06T12:00:00.000Z"
}

Erros

• 401 — AUTHENTICATION_REQUIRED
• 403 — FORBIDDEN
• 404 — RESOURCE_NOT_FOUND
• 409 — INVALID_STATE_TRANSITION,TENANT_SELECTION_REQUIRED
• 429 — RATE_LIMITED
• 500 — INTERNAL_ERROR

Só endpoint live e só sessão humana do seller (API key → 403). O segredo novo vale na hora e é exibido uma única vez; um replay devolve secret_already_revealed: true.

• Autenticação: sessão do app do seller
• Escopos: webhooks:write
• URL: https://api.v2.wolfpayteste.online/v1/webhooks/endpoints/{id}/rotate-secret

Parâmetros

Corpo da requisição (opcional)

Objeto EmptyRequest

EmptyRequest

{}

Resposta 200

Endpoint com o novo segredo (ou replay sem ele).

Um destes formatos:

• RotatedWebhookEndpointSecret
• ReplayedRotatedWebhookEndpointSecret

{
  "id": "whe_3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a",
  "url": "https://example.com/wolf/webhooks",
  "enabled": true,
  "status": "active",
  "disabled_reason": null,
  "consecutive_failures": 0,
  "selected_events": [
    "payment.paid",
    "payment.canceled"
  ],
  "product_ids": [],
  "payment_methods": [],
  "delivery_mode": "live",
  "secret_rotated_at": "2026-11-06T12:05:00.000Z",
  "deleted_at": null,
  "created_at": "2026-11-06T12:00:00.000Z",
  "signing_secret": "whsec_live_EXEMPLO_novo_segredo"
}

Erros

• 400 — IDEMPOTENCY_KEY_REQUIRED,VALIDATION_FAILED
• 401 — AUTHENTICATION_REQUIRED
• 403 — FORBIDDEN
• 404 — RESOURCE_NOT_FOUND
• 409 — IDEMPOTENCY_CONFLICT,IDEMPOTENCY_IN_PROGRESS,INVALID_STATE_TRANSITION,TENANT_SELECTION_REQUIRED
• 429 — RATE_LIMITED
• 500 — INTERNAL_ERROR
• 503 — SERVICE_UNAVAILABLE

Enfileira um evento webhook.test (uma tentativa, assinada como os eventos de domínio). Endpoint desativado → 409 WEBHOOK_ENDPOINT_DISABLED.

• Autenticação: API key (sk_test_...) ou sessão do app do seller
• Escopos: webhooks:write
• URL: https://api.v2.wolfpayteste.online/v1/webhooks/endpoints/{id}/test

Parâmetros

Corpo da requisição (opcional)

Objeto EmptyRequest

EmptyRequest

{}

Resposta 202

Entrega de teste criada.

Objeto WebhookDelivery

{
  "id": "whd_5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c",
  "endpoint_id": "whe_3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a",
  "event_id": "evt_7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e",
  "event_type": "webhook.test",
  "attempt": 1,
  "status": "pending",
  "response_status": null,
  "latency_ms": null,
  "created_at": "2026-11-06T12:00:00.000Z"
}

Erros

• 400 — IDEMPOTENCY_KEY_REQUIRED,VALIDATION_FAILED
• 401 — AUTHENTICATION_REQUIRED
• 403 — FORBIDDEN
• 404 — RESOURCE_NOT_FOUND
• 409 — IDEMPOTENCY_CONFLICT,IDEMPOTENCY_IN_PROGRESS,TENANT_SELECTION_REQUIRED,WEBHOOK_ENDPOINT_DISABLED
• 429 — RATE_LIMITED
• 500 — INTERNAL_ERROR