Error
A valid request URL is required to generate request examples{
"success": true,
"message": "Integrator webhook settings updated successfully.",
"data": {
"organization": "A&B Company",
"first_name": "John",
"last_name": "Doe",
"email": "ab@gmail.com",
"phone": "+xxx xxx xxx xxx",
"id": "xxxxxxxxxxxxxxxxxxxxxxxx",
"webhook_url": "https://example.com/kotani/webhooks",
"webhook_events": [
"transaction.deposit.status.updated",
"payment.confirmed"
],
"disable_webhooks": false
}
}{
"success": false,
"message": "Bad Request",
"data": {}
}{
"success": false,
"message": "Unauthorized",
"data": {}
}{
"success": false,
"message": "Not Found",
"data": {}
}Authentication & Setup
Update Webhook Configuration
Allows an integrator to update their default webhook URL, secret, and event subscriptions.
PATCH
/
api
/
v3
/
integrator
/
webhook
Error
A valid request URL is required to generate request examples{
"success": true,
"message": "Integrator webhook settings updated successfully.",
"data": {
"organization": "A&B Company",
"first_name": "John",
"last_name": "Doe",
"email": "ab@gmail.com",
"phone": "+xxx xxx xxx xxx",
"id": "xxxxxxxxxxxxxxxxxxxxxxxx",
"webhook_url": "https://example.com/kotani/webhooks",
"webhook_events": [
"transaction.deposit.status.updated",
"payment.confirmed"
],
"disable_webhooks": false
}
}{
"success": false,
"message": "Bad Request",
"data": {}
}{
"success": false,
"message": "Unauthorized",
"data": {}
}{
"success": false,
"message": "Not Found",
"data": {}
}Update your integrator’s webhook URL, secret, and event subscriptions for receiving real-time notifications.
Set
disable_webhooks to true to stop all outbound callbacks entirely and poll for status instead — useful for poll-only integrations. Defaults to false.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Default webhook callback URL
Example:
"https://example.com/kotani/webhooks"
Shared secret used to sign webhook payloads
Example:
"whsec_1234567890abcdef"
Webhook events this integrator should receive
Available options:
transaction.status.updated, transaction.deposit.status.updated, transaction.withdrawal.status.updated, transaction.onramp.status.updated, transaction.offramp.status.updated, payment.confirmed, kyc.status.changed, refund.lightning.invoice_needed, refund.completed, refund.failed, settlement.approved, settlement.rejected, settlement.processed, settlement.cancelled, settlement.paused, settlement.batch.approved, settlement.batch.rejected, settlement.batch.processed, settlement.batch.partial, settlement.batch.cancelled, settlement.batch.consolidated, system.event Example:
["transaction.deposit.status.updated"]
Set true to disable all callbacks (poll-only mode)
Example:
false