Skip to content

Webhooks

Webhooks allow you to receive real-time notifications about events occurring for your sub-merchants. When an event occurs for any of your sub-merchants, Resolve sends an HTTP POST request to your configured webhook endpoint with details about the event.

Webhook Event Structure

All webhook events follow a consistent structure:

{
  "id": "4ecbe7f9e8c1c9092c000027",
  "object": "invoice",
  "type": "invoice.created",
  "occurred_at": "2021-05-20T09:23:53+00:00",
  "data": {
    "id": "RH5fF9aeQ",
    "merchant_id": "MER456789"
  }
}

The data.id field contains the ID of the object related to the event. You can use this ID to fetch the full object via the corresponding API endpoint.

The data.merchant_id field indicates the ID of the sub-merchant the event occurred for. This allows you to identify which sub-merchant's data triggered the webhook.