Integration Guide

Learn how to verify users and ingest events into the Qwire Platform using our secure API.

1Authentication

All API requests must be authenticated using an API Key. You can generate a new API Key from your dashboard settings.

Include the key in the Authorization header:

Authorization: Bearer <YOUR_API_KEY>

2Create a Destination

Before you can receive events, you need to configure a Destination. This tells Qwire where to deliver valid events.

Navigate to the Destinations tab in your dashboard and click "New Destination". You'll need to provide the target URL (webhook endpoint) where you want to receive the events.

3Ingest Events

Send events to your destinations using the events endpoint. Events are processed asynchronously and delivered based on your configured rules.

Endpoint

POSThttps://qwire-api.servel.ink/v1/events

Parameters

event_typeRequired

The type of event (e.g., "payment.processed"). Used for routing rules.

source_idOptional

Identifier for the source system (e.g., "stripe_connect").

payloadRequired

The actual data of the event. Must be a valid JSON object.

Code Example

Terminal

curl -X POST https://qwire-api.servel.ink/v1/events \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "event_type": "payment.processed",
    "source_id": "stripe_connect_1",
    "payload": {
      "amount": 4900,
      "currency": "usd",
      "customer_id": "cus_123456"
    }
  }'