Merchant Management API Specification

Merchant Management API

Webhooks

Merchant Management Webhooks Section

Get All Webhook Subscriptions

get /merchant-management/webhooks/subscriptions

Retrieve all webhook subscriptions affiliated to the authenticated client.

Example Response

200 A list of webhook subscriptions was successfully returned.

401 Unauthorized - Error response.

403 Forbidden error response.

500 Internal Server Error - Error response.

Create a Webhook Subscription

post /merchant-management/webhooks/subscriptions

Create a new webhook subscription.

Request Schema

description required

Type

string

targetUrl required

Type

string

authorization required

Type

object

events required

Type

array

secret required

Type

string

Example Request

{
  "description": "Merchant Status Change Webhook",
  "targetUrl": "https://api.example.com/webhook",
  "authorization": {
    "authorizationType": "none",
    "authorizationData": null
  },
  "events": [
    "merchant.status.changed"
  ],
  "secret": "test-secret-12345"
}

Example Response

200 Webhook subscription was successfully created.

400 Bad Request - One or more of the provided webhook event names are invalid.

401 Unauthorized - Error response.

403 Forbidden error response.

422 Unprocessable Entity - Request body failed structural validation.

500 Internal Server Error - Error response.

Get Webhook Subscription by ID

get /merchant-management/webhooks/subscriptions/id/{subscriptionId}

Retrieve webhook subscription details by subscription ID.

Parameters

subscriptionId required

Type

string

Example Response

200 Webhook subscription details were successfully returned.

401 Unauthorized - Error response.

403 Forbidden error response.

404 Not Found - Error response.

422 Unprocessable Entity - Subscription ID failed validation.

500 Internal Server Error - Error response.

Update Webhook Subscription by ID

patch /merchant-management/webhooks/subscriptions/id/{subscriptionId}

Update a webhook subscription by subscription ID.

Parameters

subscriptionId required

Type

string

Request Schema

description

Type

string

targetUrl

Type

string

authorization

Type

object

events

Type

array

secret

Type

string

Example Request

{
  "description": "Updated Webhook Description",
  "targetUrl": "https://api.example.com/updated-webhook"
}

Example Response

200 Webhook subscription was successfully updated.

400 Bad Request - One or more of the provided webhook event names are invalid.

401 Unauthorized - Error response.

403 Forbidden error response.

404 Not Found - Error response.

422 Unprocessable Entity - Subscription ID or request body failed structural validation.

500 Internal Server Error - Error response.

Delete Webhook Subscription by ID

delete /merchant-management/webhooks/subscriptions/id/{subscriptionId}

Delete a webhook subscription by subscription ID.

Parameters

subscriptionId required

Type

string

Example Response

200 Webhook subscription was successfully deleted.

401 Unauthorized - Error response.

403 Forbidden error response.

404 Not Found - Error response.

422 Unprocessable Entity - Subscription ID failed validation.

500 Internal Server Error - Error response.