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

SET Direct Deposit API · Events & webhooks

Rotate the webhook signing secret

POST/api/partner/webhook_secret/rotate

Key scope: partner key

A new signing secret for your first endpoint (version + 1), returned once. For 24 hours every delivery carries a second v1 signature under the previous secret, SET-Signature: t=…,v1=<new>,v1=<previous>: accept either while you deploy the new one. One rotation a day. Needs a key that can write.

Headers

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

Errors

  • 409 rotation_in_progress
  • 403 scope_missing
  • 503 webhooks_unconfigured
  • 401 partner_key_required
  • 401 partner_key_invalid
  • 401 api_key_expired
  • 403 scope_missing
  • 403 ip_not_allowed
  • 403 merchant_no_direct_deposit
  • 429 rate_limited
  • 503 direct_deposit_disabled

All codes: Errors.