Webhooks & APIIntegrations
Paystack
Receive Paystack payment events
Paystack signs webhooks with HMAC-SHA256 in the X-Paystack-Signature header (hex-encoded, no prefix). Wexio's Paystack preset under Generic HMAC-SHA256 handles this.
Provider docs: Setting up webhooks in Paystack
Setup
1. Create an inbound Wexio connection
New connection → Inbound → Paystack preset. Prefills:
| Field | Value |
|---|---|
| Auth mode | GENERIC_HMAC_SHA256 |
| Signature header name | X-Paystack-Signature |
| Encoding | Hex |
| Prefix | (empty) |
2. Configure the webhook in Paystack
Dashboard → Settings → API Keys & Webhooks → Webhook URL. Set it to the Wexio endpoint URL.
The signing secret is your Paystack Secret Key (sk_live_… or sk_test_…). Paste it into Wexio's Signing secret field.
3. Contact resolution
| Identifier type | JSON path |
|---|---|
$.data.customer.email |
4. Capture schema, bind a flow
Trigger a test event in Paystack (they support test payloads from the dashboard), capture the schema, attach a Webhook Received trigger.
Troubleshooting
| Symptom | Fix |
|---|---|
| Signature mismatch | Make sure you're using the right environment's secret key (test vs live) |
IDENTIFIER_NOT_FOUND | Customer hasn't been created in Wexio yet; branch on the event to create them first |