Gift cards
Gift cards
Configuring gift cardsEVA supports all the gift cards you could possibly ever want. We support them: we are not a gift card provider.
When it comes to gift cards, we make a very clear distinction between physical gift cards and digital gift cards.
Physical gift cards keep stock and require a serial number Digital gift cards are sent out via mail.
When describing gift cards, we emphasize the difference between physical and digital gift cards.
Additionally, we also distinguish between selling gift cards and using them as a payment method. You may want to sell gift cards, but not accept them as a form of payment. In any case, both situations require gift card configuration, which will be covered here.
In order to be able to access this chapter, you need the GiftCardConfigurations permission.
Gift card configurations
A gift card configuration essentially describes your gift card using the following properties:
| Property | Description |
|---|---|
| Name | Name for your gift card. |
| Handler | Explained later on. |
| Card type | Some handlers support multiple card types. |
| Usage type | Whether you want to sell cards, or use them as payment. |
Handlers
Your handler is like your gift card 'provider'. We've set up a generic gift card implementation that can be used to connect any gift card you want – you just have to do it yourself. This handler is called APIGIFTCARD.
Available gift card configurations
If you want to view the currently available configurations in your EVA environment, navigate to the Gift card configuration chapter in the Financials module in Admin Suite.
Creating configurations
Start off by clicking the '+' icon on the overview page.
- Allow refund without transaction: Checking this will enable POS to display a button for emptying a gift card when checking its balance (accessed through More options). Using that button will subsequently initiate the creation and checkout process for a new refund order.
- Allow currency conversion: Checking this will allow for the gift card to be used in OUs with a different default currency.
APIGIFTCARD
To use the APIGIFTCARD handler, you need to build an integration with a gift card provider that can receive certain requests and send the correct responses. The only difference between physical and digital gift cards is that physical gift cards are 'activated' and digital gift cards are 'issued'.
If you selected the APIGIFTCARD option in the creation window in Admin Suite, the window will expand to give you the needed options to connect with your gift card handler.
| Option | Description |
|---|---|
| Base URL | The URL that EVA will use for the various giftcard operations. |
| Username | The 'username' used for the authentication at the handler. |
| Password | The 'password' used for the authentication at the handler. |
| Timeout (Seconds) | The time the call is valid before timing out. |
Configuring alternative handlers
When setting up Adyen payments, many of the configurations for the Adyen SVS gift card are already established.
| Setting | Description |
|---|---|
| App:GiftCard:DefaultType | AdyenStoredValue |
| AdyenStoredValue:ApiUrl | This is the URL required for the activation of gift cards. |
The use of these settings assumes that you will be using the CheckoutAPI for refunds and captures. However, you can read more about the basic Adyen integration and the CheckoutAPI in the following docs: Payments using Adyen