v3

latestOpenAPI 3.0.0raw.githubusercontent.com2026-06-10283986.5 KB

Webhooks

Update a webhook config

patch/api/v1/bila/webhooks/{id}

Path parameters

idstring required

Example:68f11209-451f-4a15-bfcd-d916eb8b09f4

Webhook config UUID

Request body

urlstring

Webhook endpoint URL

eventsstring[]

Event types to subscribe to

isActiveboolean

Whether the webhook is active

Example request

{
  "url": "https://example.com/webhooks",
  "events": [
    "payment.completed",
    "collection.completed"
  ],
  "isActive": true
}

Response

Webhook config updated

statusboolean required

Request success status

messagestring required

Response message

Example response

{
  "status": true,
  "message": "Operation completed successfully",
  "data": {
    "id": "68f11209-451f-4a15-bfcd-d916eb8b09f4",
    "merchantId": "68f11209-451f-4a15-bfcd-d916eb8b09f5",
    "url": "https://example.com/webhooks/bila",
    "secret": "a1b2****c3d4",
    "events": [
      "payment.completed",
      "collection.completed"
    ],
    "isActive": true,
    "createdAt": "2026-04-01T10:00:00.000Z",
    "updatedAt": "2026-04-15T14:30:00.000Z"
  }
}