Integrations and webhooks
Two screens solve almost everything: Administration › Incoming Webhooks (what IncentIA receives) and Integrations › Webhooks (what it sends to your system).
Orders from your shop that give no points
First look for the delivery in Administration › Incoming Webhooks: filter by Source (Shopify or WooCommerce) and open Details.
| Symptom | Likely cause | What to do |
|---|---|---|
| The notification doesn't appear in Incoming Webhooks | The address was copied wrongly in the shop, or the connector is inactive | Check the address in the shop and that the connector is Active in Integrations › Connectors |
| The notification appears as rejected | API secret differs from the shop's | Copy the secret again, identical on both sides, and save the connector |
| The order is skipped and adds nothing | The connector has no Loyalty Program | Edit the connector and choose one |
| The order is skipped | There is no active member with that email or phone | The customer must use the same email as in the programme. See Import and invite members |
| Failed status | An error occurred during processing | Click Replay (permission Replay Webhook) and refresh |
| Sync Status: Failed | The connector's last synchronisation did not finish properly | Check the connector's details and save it again |
| NeverSynced (untranslated) | There has been no synchronisation yet | This is normal on a newly created connector |
Step-by-step guides: Connect Shopify · Connect WooCommerce.
Outgoing webhooks that don't reach your system
Look at Consecutive Failures in Integrations › Webhooks.
| Symptom | Likely cause | What to do |
|---|---|---|
| Consecutive Failures goes up | Your destination doesn't respond 2xx within 30 seconds | Respond 200 immediately and process in the background |
| The subscription stops sending (Is Active unchecked) | It disables itself after 10 consecutive failures, or 50 consecutive overload responses | Fix the destination, edit the subscription and tick Is Active |
The destination returns 3xx | IncentIA doesn't follow redirects | Put the final address in Target URL |
| The subscription is rejected | The URL is not public (internal address) | Use a URL reachable from the internet |
| An event you expected doesn't arrive | A subscription listens to a single Event Type | Create one subscription per event |
| Your system rejects the signature | Secret differs or the verification is wrong | See Webhooks: format and signature. When editing, an empty Secret keeps the current one |
Other integrations
| Symptom | Likely cause | What to do |
|---|---|---|
| Your platform is neither Shopify nor WooCommerce | There is no native connector | Use the public API or webhooks |
| OCR doesn't read receipts | Provider or key misconfigured | See Evidence and OCR |
| A member paid for a membership and can't see it | The Stripe notification wasn't processed, or the Stripe configuration is missing on the platform | Look for the payment in Incoming Webhooks with Source Stripe. See Payments (Stripe) |