SETSimple Easy Transactions
SET DocsAPI reference and complianceUpdated 2026-11-10
Browse: SET Merchant API

SET Merchant API · Events & webhooks

Add a webhook endpoint

POST/v1/webhook_endpoints

Key scope: write · Success: 201

A further endpoint with its own URL, event filter and signing secret (in this answer, shown with the endpoint). It receives events recorded from now on. Each delivery carries SET-Webhook-Endpoint with the endpoint's id, and GET /v1/events/{id} lists each endpoint's delivery.

Headers

Idempotency-Key string
Optional. The same key and body run once; a replay answers with Idempotent-Replayed: true. Kept 24 hours.

Body

url https URLrequired
A public https URL on your own server.
events string[]
Event types or families (payout.*); [] or absent for every event.

Errors

  • 400 body_invalid
  • 400 url_invalid
  • 400 events_invalid
  • 409 endpoint_limit
  • 401 api_key_required
  • 401 api_key_invalid
  • 401 api_key_wrong_mode
  • 403 scope_missing
  • 429 rate_limited

All codes: Errors.