Skip to main content
POST
http://localhost:8080/v0
/
v0
/
webhooks
/
bridge
Receive Bridge Webhook
curl --request POST \
  --url http://localhost:8080/v0/v0/webhooks/bridge \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "event_id": "<string>",
  "event_type": "<string>"
}
'
{
  "data": {
    "received": true,
    "event_id": "<string>",
    "message": "<string>"
  }
}
Authentication: None (public endpoint for Bridge)
Bridge sends webhook events to notify you about transaction status changes and other important events. The Karma Business API receives these webhooks and forwards them to your business customers.

​
How It Works

This endpoint receives webhook events from Bridge. It is called by Bridge, not by your business customers. To receive webhook events, configure a webhook URL for your customer using the Update Webhook URL endpoint. When Bridge sends an event to this endpoint, it will be automatically forwarded to the customer’s configured webhook URL.

​
Request Body

​
event_id
string
required
Bridge event ID
​
event_type
string
required
Event type (e.g., “virtual_account.payment.received”)
Additional event-specific data from Bridge will be included in the request body.

​
Response

​
data
object
​
received
boolean
Confirmation that event was received
​
event_id
string
The Bridge event ID
​
message
string
Status message

​
Example Response

{
  "data": {
    "received": true,
    "event_id": "wh_123abc456def",
    "message": "Webhook event processed and forwarded successfully"
  }
}