Skip to main content
POST
Register a webhook endpoint

Authorizations

Authorization
string
header
required

Scoped Bearer token from POST /merchant/api/auth.

Body

application/json
url
string<uri>
required
Example:

"https://example.com/webhooks/kori"

events
enum<string>[]
required
Available options:
payment_received,
payout_completed,
payout_failed,
bulk_pay_done,
payment_link_used,
team_login,
api_key_created,
security_alert

Response

Webhook registered. The secret is returned only on creation.

success
boolean
Example:

true

message
string
request_id
string<uuid>
data
object