Webhooks

Stay updated with real-time notifications about escrow events using LindaPay's webhook system.

Getting Started with Webhooks

Set up webhooks to receive real-time updates

  1. Log in to your LindaPay developer dashboard
  2. Navigate to the Webhooks section
  3. Click on “Add Webhook“ and enter your endpoint URL
  4. Select the events you want to subscribe to
  5. Save your webhook configuration

Webhook Events

escrow.created

Triggered when a new escrow is created

{
  "event": "escrow.created",
  "escrow_id": "esc_123456789",
  "timestamp": "2023-06-15T10:00:00Z",
  "data": {
    // Event-specific data
  }
}

escrow.funded

Triggered when an escrow is funded by the buyer

{
  "event": "escrow.funded",
  "escrow_id": "esc_123456789",
  "timestamp": "2023-06-15T10:00:00Z",
  "data": {
    // Event-specific data
  }
}

escrow.released

Triggered when funds are released to the seller

{
  "event": "escrow.released",
  "escrow_id": "esc_123456789",
  "timestamp": "2023-06-15T10:00:00Z",
  "data": {
    // Event-specific data
  }
}

escrow.cancelled

Triggered when an escrow is cancelled

{
  "event": "escrow.cancelled",
  "escrow_id": "esc_123456789",
  "timestamp": "2023-06-15T10:00:00Z",
  "data": {
    // Event-specific data
  }
}

escrow.disputed

Triggered when a dispute is raised on an escrow

{
  "event": "escrow.disputed",
  "escrow_id": "esc_123456789",
  "timestamp": "2023-06-15T10:00:00Z",
  "data": {
    // Event-specific data
  }
}

Best Practices

Security

Verify webhook signatures to ensure the authenticity of incoming requests.

Idempotency

Handle duplicate events gracefully by implementing idempotent event processing.

Retry Logic

Implement proper retry logic to handle temporary failures in your webhook endpoint.