Skip to main content
Gift cards are a form of prepaid card customers can use to purchase goods or services. You can hand them out as bonuses to build brand loyalty, or sell them as gift certificates.

Protecting gift cards with CVV

A CVV code adds an extra ownership check when a customer pays for an order with a gift card. It helps you:
  • Confirm that the order is being placed by the person who actually holds the card.
  • Reduce the risk of fraudulent redemptions if a card number leaks.
To use CVV:
  1. Import a gift card pool with the CVV requirement enabled: set true in the IsCvvRequired column.
  2. Provide CVV values when you import the gift cards.
When a customer pays for an order with a gift card from a CVV-required pool, the CVV must be passed in the operation. If an incorrect CVV is submitted, payment with the gift card will not go through.

How gift cards work

Storing cards

Gift cards are grouped into pools. Pools are stored as products, which are created automatically when you import a pool. You can open the list of cards from the pool page. In a card’s edit view you can see additional details about it.

Selling cards

Cards must be uploaded to the project before they can be issued. Only cards with the status Not Activated can be sold. When a customer buys a gift card, an order is created with the pool product on it: The card is activated. If a store issues a card directly, it still has to be activated. To do that, you can run its purchase through as an anonymous customer order.
Possible errors that can occur when selling gift cards are described in the developer documentation.

Redeeming a card

Only cards with the status Activated can be used on an order. The customer partially pays for the purchase with the card. Once the card’s full face value has been spent, it automatically moves to the status Redeemed.
Possible errors that can occur when paying for orders with gift cards are described in the developer documentation.

How to start using gift cards

To start working with cards, you need to:
  1. Create a gift card pool.
  2. Import the cards.
  3. Update the order save operations to account for the cards added to the project.
  4. Enable the loyalty program module.