POST
/
merchants
/
webhooks
/
update
cURL
curl -X POST "https://api.onekhusa.com/sandbox/v1/merchants/webhooks/update" \
  --header "Authorization: Bearer your-jwt-token" \
  --header "Content-Type: application/json" \
  --header "X-Organisation-Id: FYH0NTVW0DXK" \
  --header "X-Merchant-Account-Number: 35253486" \
  --header "Accept-Language: en"   -d '{
    "webhookId": 1,
    "merchantAccountNumber": 35253486,
    "eventCode": "payment.success",
    "callbackUrl": "https://merchant.example.com/webhooks/payment-updated",
    "capturedBy": "johndoe@example.com"
  }'
"Merchant webhook has been updated successfully"

Authorizations

ā€‹
Authorization
string
header
required

Bearer authentication header of the form Bearer <Token>, where <Token> is your access token.

Headers

ā€‹
X-Organisation-Id
string
required

The organization identifier

ā€‹
X-Merchant-Account-Number
string
required

The merchant account number

ā€‹
Accept-Language
string
default:en

Preferred language for the response

ā€‹
MerchantAccountNumber
integer
required

The unique identifier of the merchant account (must match request body)

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

35253486

Body

application/json
ā€‹
webhookId
integer
required

The unique identifier of the webhook to update

Example:

1

ā€‹
merchantAccountNumber
integer
required

The unique identifier of the merchant account

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

35253486

ā€‹
eventCode
string
required

The new or updated event code for the webhook (free-form string). See webhook events documentation for common codes.

Example:

"payment.success"

ā€‹
callbackUrl
string<uri>
required

The new or updated callback URL (must be reachable)

Example:

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

ā€‹
capturedBy
string<email>
required

Email address of the user updating the webhook

Example:

"admin@onekhusa.com"

Response

200 - application/json

OK - Webhook successfully updated

ā€‹
message
string
Example:

"Merchant webhook has been updated successfully"