v1

latestOpenAPI 3.1.02026-07-132363652.9 MB
Webhook

Register or update a merchant webhook URL

Register or update a merchant webhook URL

post/api/v1/webhooks

Request body

merchant_idstring uuid

Merchant ID. Defaults to the logged-in merchant if not provided. Required for admin tokens.

webhook_urlstring uri required

The URL where webhook notifications will be sent

Example request

{
  "merchant_id": "550e8400-e29b-41d4-a716-446655440000",
  "webhook_url": "https://example.com/webhook"
}

Response

Success

successboolean required

Indicates if the request was successful

Example response

{
  "success": true,
  "data": {
    "webhook_url": "https://example.com/webhook",
    "message": "Webhook URL successfully configured"
  }
}