Kadova is live for a limited number of customers. Registration for new customers opens soon. Contact us
Kadova
NLEN

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 and Online redemption under webshop settings (hosted/embed checkout).

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