Sign in

v1

latestOpenAPI 3.1.02026-07-131991131.4 KB
Webhooks

Register a webhook

Creates a new webhook. Webhooks are registered per merchant_code and per environment: the environment is determined by the secret key you authorize the request with — a production key (sk_...) registers webhooks for production payments, a test key (sk_test_...) registers webhooks for test payments. Each merchant_code + key pair can have up to 4 webhooks.

post/api/v1/webhooks

Headers

X-Merchant-Codestring required
Example:code provided to you from Tabby side

Used for multi store/countries setup, please contact your Account manager to recognize that

Request body

urlstring uri required

HTTPS endpoint for notifications. The URL should be valid and accessible (not local).

Example request

{
  "url": "https://example.com/",
  "header": {
    "title": "Arbitrary header name to sign the request",
    "value": "Random string to sign the request"
  }
}

Response

Success. Webhook object is returned.

idstring

Unique webhook ID, assigned by Tabby.

is_testboolean required

Deprecated. The webhook environment is determined by the secret key used at registration (production sk_... or test sk_test_...), not by this field.

urlstring uri required

HTTPS endpoint for notifications. The URL should be valid and accessible (not local).

Example response

{
  "header": {
    "title": "Arbitrary header name to sign the request",
    "value": "Random string to sign the request"
  },
  "id": "unique webhook id",
  "url": "https://example.com/"
}