Skip to main content

Developers: Webhooks

What It Is​

Webhooks provide async event delivery to your endpoint when subscribed events occur.

Where It Is Managed​

  • Settings -> Developers -> Webhooks

Endpoints​

  • GET /api/v1/merchant/webhooks
  • POST /api/v1/merchant/webhooks
  • POST /api/v1/merchant/webhooks/{webhookID}/rotate-secret
  • POST /api/v1/merchant/webhooks/{webhookID}/enable
  • POST /api/v1/merchant/webhooks/{webhookID}/disable
  • DELETE /api/v1/merchant/webhooks/{webhookID}
  • POST /api/v1/merchant/webhooks/{webhookID}/test
  • GET /api/v1/merchant/webhooks/{webhookID}/deliveries

Receiver Requirements​

  • Verify webhook signatures.
  • Enforce replay window by timestamp.
  • Process idempotently by event ID.
  • Return 2xx only after durable acceptance.