Kadova

Gift cards

Redeem online in the webshop

Explain to customers when the card number, online redemption code, and PIN are used — and how staff manage credentials.

Redeem online

To pay in the hosted webshop, embed, or WooCommerce, the customer uses an online redemption code + PIN. The card number/barcode stays for the store. Technically the card must be ONLINE_READY (Online ready).

Which detail when?

| Detail | Use |

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

| Card number / barcode | In-store checkout, scanning, support |

| Balance token (QR/link) | Show balance only |

| Redemption code + PIN | Webshop checkout (hosted, embed, WooCommerce, custom API) |

Customer journey

  1. Recipient receives the card (email/PDF or claim link).
  2. For physical/migrated cards: activate via claim link or staff (Enable directly).
  3. Status becomes Online ready (ONLINE_READY) — redemption code + PIN are available.
  4. At checkout the customer enters redemption code + PIN (not the card number).
  5. Optional: partial payment — gift card + remainder via iDEAL/card.
  6. If payment fails before completion, balance is not held permanently (release).

Activate and claim

  1. On the card detail, check whether Online ready is active.
  2. For physical or migrated cards: Enable directly or send a claim link (only with a verified email address).
  3. Rotate credentials only on loss; the PIN cannot be read afterwards.
  4. Security history on the card detail shows rotations and PIN resets.

Webshop (hosted/embed)

Enable Gift card payment in webshop under webshop settings AND Online redemption in security settings.

Partial payment and zero-total

  • Partial payment (gift card + PSP remainder) is supported.
  • Gift-card-only (zero-total): immediate single capture after authorize.
  • Cancel/refund after capture: reverse (never more than the captured amount).

Common problems

| Problem | Check |

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

| Code/PIN rejected | Status Online ready? Correct redemption code (not card number)? |

| Field missing at checkout | Both toggles on? Correct shop channel active? |

| Balance “stuck” after failed payment | Release/timeout — wait or check card detail/transactions |

| WooCommerce not working | Wizard: connection test ≠ go-live; see WooCommerce article |

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