GET
/
merchants
/
webhooks
/
getAll
cURL
curl -X GET "https://api.onekhusa.com/sandbox/v1/merchants/webhooks/getAll?MerchantAccountNumber=35253486" \
  --header "Authorization: Bearer your-jwt-token" \
  --header "Accept-Language: en"
[
  {
    "merchantAccountNumber": 35253486,
    "webhookId": 1,
    "eventCode": "payment.success",
    "eventName": "Payment Success Notification",
    "callbackUrl": "https://merchant.example.com/webhooks/payment",
    "webhookSignature": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6",
    "dateCreated": "2024-01-15T10:30:00Z",
    "createdBy": "user@example.com",
    "dateModified": "2024-01-16T14:20:00Z",
    "modifiedBy": "admin@example.com"
  },
  {
    "merchantAccountNumber": 35253486,
    "webhookId": 2,
    "eventCode": "payout.success",
    "eventName": "Successful Disbursement (Payout)",
    "callbackUrl": "https://merchant.example.com/webhooks/payout",
    "webhookSignature": "z6y5x4w3v2u1t0s9r8q7p6o5n4m3l2k1j0i9h8g7f6e5d4c3b2a1",
    "dateCreated": "2024-01-20T09:15:00Z",
    "createdBy": "admin@example.com",
    "dateModified": null,
    "modifiedBy": null
  }
]

Authorizations

ā€‹
Authorization
string
header
required

Bearer authentication header of the form Bearer Token, Where accessToken is the access token used to authenticate the request.

Headers

ā€‹
Accept-Language
string
default:en

Preferred language for the response

Query Parameters

ā€‹
MerchantAccountNumber
integer
required

The unique identifier of the merchant account

Required range: 10000000 <= x <= 99999999
Example:

35253486

Response

Success Response (200)

ā€‹
merchantAccountNumber
integer

The unique identifier of the merchant account

Example:

35253486

ā€‹
webhookId
integer<int64>

The unique identifier of the webhook

Example:

1

ā€‹
eventCode
string

The event code that triggers the webhook (free-form string)

Example:

"payment.success"

ā€‹
eventName
string

A description of the event

Example:

"Payment Success Notification"

ā€‹
callbackUrl
string<uri>

The URL that receives webhook notifications

Example:

"https://merchant.example.com/webhooks/payment"

ā€‹
webhookSignature
string

The signature used to verify the authenticity of webhook notifications

Example:

"a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6"

ā€‹
dateCreated
string<date-time>

The date and time when the webhook was created (ISO 8601)

Example:

"2024-01-15T10:30:00Z"

ā€‹
createdBy
string<email>

The email of the user who created the webhook

Example:

"admin@example.com"

ā€‹
dateModified
string<date-time> | null

The date and time when the webhook was last modified (ISO 8601)

Example:

"2024-01-16T14:20:00Z"

ā€‹
modifiedBy
string<email> | null

The email the user who last modified the webhook

Example:

"admin@example.com"