Integrations and API

Connect Lightspeed eCom

Sell Kadova gift cards via Lightspeed eCom (issue-only beta) with API key and order-event webhooks.

Lightspeed eCom connector (issue-only)

Connect your Lightspeed eCom shop to issue Kadova gift cards after payment. Full redeem via External Payment Service stays capability-gated.

Who does what

| Role | Owns |

|------|------|

| You (Kadova) | Choose tier, installation, shop ID, go-live sign-off |

| Lightspeed admin / agency | API key, product mapping, staging paid orders |

| Platform / IT | Webhooks (lowercase headers), secrets, revoke |

Wizard steps

  1. Tier — start with issue-only (issue after paid order events). Full-redeem only after EPS POC.
  2. InstallWebshop → Settings → Lightspeed wizard → lightspeed_ecom:issue_only.
  3. API key — store encrypted shop API key; never paste secrets into tickets.
  4. Product mapping — map gift-card lines (title / product ids).
  5. Go-live — connection alone is not enough. Staging: paid order → ledger lightspeed:{orderId}; webhook replay must not double-issue.

Webhooks & limits

Prefer lowercase x-signature / x-shop-id (HTTP/2). Rate limit ~300 req/5 min — prefer webhooks over Admin API polls.

Manuals

docs/connectors/manuals/platforms/lightspeed-ecom.md.

Was this article helpful?

Still stuck?

Email us with a short description, expected outcome and any error message.

Email support@kadova.nl

Tips for a complete request are on Contact support