Integrations and API

Connect CCV Shop

Sell Kadova gift cards via CCV Shop (issue-only beta) with API key and SHA-512 webhooks.

CCV Shop connector (issue-only)

Connect CCV Shop to issue Kadova gift cards after paid orders. Checkout redeem via App Payment Service Provider stays gated.

Who does what

| Role | Owns |

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

| You (Kadova) | Tier, installation, shop ref, go-live |

| CCV admin / agency | API app, API key, product mapping, staging orders |

| Platform / IT | Webhooks (HMAC-SHA512), secrets, revoke |

Wizard steps

  1. Tierissue-only first. Full-redeem needs App PSP POC (partial + zero-total).
  2. InstallWebshop → Settings → CCV wizard → ccv_shop:issue_only.
  3. API key — encrypted; optional per-install webhook secret.
  4. Product mapping — gift-card order rows.
  5. Go-live — staging paid order → ledger ccv:{orderId}; no double-issue on replay.

Forbidden shortcut

Do not treat CCV Pay Payment API alone as the Shop checkout path. Redeem must use App PSP when unlocked.

Webhooks

HMAC-SHA512 of body + public webhook address + secret.

Manuals

docs/connectors/manuals/platforms/ccv-shop.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