v3

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

Webhooks

Create a webhook config

post/api/v1/bila/webhooks

Request body

urlstring required

Webhook endpoint URL

eventsstring[] required

Event types to subscribe to

Example request

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

Response

Webhook config created (secret returned once)

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"
  }
}