---
title: "Gift cards and other stored value cards"
description: "Use Terminal API for transactions with stored value cards like gift cards and mall cards."
url: "https://docs.adyen.com/point-of-sale/alternative-payment-methods/gift-cards-terminal-api"
source_url: "https://docs.adyen.com/point-of-sale/alternative-payment-methods/gift-cards-terminal-api.md"
canonical: "https://docs.adyen.com/point-of-sale/alternative-payment-methods/gift-cards-terminal-api"
last_modified: "2025-09-22T10:17:00+02:00"
language: "en"
---

# Gift cards and other stored value cards

Use Terminal API for transactions with stored value cards like gift cards and mall cards.

[View source](/point-of-sale/alternative-payment-methods/gift-cards-terminal-api.md)

Gift cards are prepaid payment cards with a stored monetary value. They can be used for making payments and, depending on the provider, can also be loaded with more funds, cashed out, or are disabled.

## Requirements

Before you begin, take into account the following requirements, limitations, and preparations.

| Requirement          | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| -------------------- |   |
| **Integration type** | A [Terminal API](/point-of-sale/design-your-integration/terminal-api) integration with payment terminals.                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| **Limitations**      | Refer to [Supported gift cards and transactions](/point-of-sale/gift-cards-terminal-api#supported-gift-cards-and-transactions) for an overview of all supported gift cards and transactions.                                                                                                                                                                                                                                                                                                                                                            |
| **Setup steps**      | Before you begin:- [Add the payment method to your Adyen account](/point-of-sale/what-we-support/payment-methods#add-payment-methods-to-your-account). We will contact you if there are additional requirements before we can configure your account for gift card functionality.
- Complete the onboarding process with the gift card provider.
- Contact our [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other) if you want to enable the specific [PIN options](/point-of-sale/gift-cards-terminal-api#pin-options). |

## Terminal API or Stored Value API

Many gift card management operations can also be done using our [Stored Value API](/payment-methods/gift-cards/stored-value-api) instead of using Terminal API. You cannot make payments using the Stored Value API, but you can use this API as an alternative for any Terminal API request with a `MessageCategory` of `StoredValue`.

For example, instead of sending a Terminal API Activation request, you could use the Stored Value API `/changeStatus` endpoint.

With a point-of-sale integration, you already know the structure of the Terminal API and thus may prefer to do all point-of-sale gift card transactions using Terminal API.\
If you also have an ecommerce integration, you may prefer to do these operations for both channels using the Stored Value API. You then use the Terminal API only for gift card payments, including cash-outs, and refunds.

## Card entry methods

To process a gift card transaction, we need to know the card details. There are several methods to obtain these, and in your gift card transaction request you need to specify the card entry method used:

* **Scan**: you scan the gift card using a barcode scanner linked to the POS system. Then you specify the gift card details in the API request that you send to the terminal.
* **Swipe**: when you send a request to the payment terminal, the shopper is prompted to swipe their card on the terminal. The terminal combines the request and the swiped card details to process the transaction, and sends the transaction result to the POS app.
* **Manual keyed entry (MKE)**: when you send a request to the payment terminal, the shopper is prompted to manually enter the gift card details on the terminal. The terminal combines the request and the entered details to process the transaction, and sends the transaction result to the POS app.

## PIN options

If the gift card has a PIN code or another type of security code, the terminal will prompt the shopper to enter their PIN. Contact our [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other) if you want to enable the following PIN options:

* **PIN entry override**: customize whether to prompt for a PIN or not, depending on the type of interaction, the entry mode, and the brand of the gift card. For example, you can choose to always have the shopper enter the PIN for a gift card payment, and never for a balance inquiry.
* **Store PIN**: after the first gift card PIN entry, the terminal stores the PIN in the cache. For a limited amount of time, the terminal no longer prompts the shopper to enter the PIN when the card is used again, for example, to load funds. The terminal clears the PIN from the cache after a configurable time of 25 seconds to 30 minutes or as soon as any other payment or gift card is presented.

## Mall cards

Payment providers like Adyen process mall card or one4all card payments through the card scheme that the card is co-badged with, like Mastercard or Visa. To ensure that these payments are not refused, you must provide the card issuer with the scheme merchant ID (MID) that we use for your store. The card issuer then adds your MID to the list of allowed MIDs in their system.

You should reach out to the gift card issuer to find out what details they specifically need in order for your store to accept their cards. They may require more details about your stores than just the MID.

### Send MIDs to the card issuer

To view the MIDs of your stores in the Customer Area, your user must have the **View Acquiring Details** [role](/account/user-roles):

The MIDs are store-specific and are different for Mastercard and Visa.

1. Get the card scheme:

   * Contact the card issuer and ask what card scheme the mall card is co-badged with.

   If there are multiple types of cards you want to accept, you must onboard with each card issuer separately.

2. Get the MIDs:

   1. In your [live Customer Area](https://ca-live.adyen.com/), go to **Settings** > **Payment methods**.

      If you do not see the **MID** column, select the settings icon **and then enable the **MID** column.

   2. Filter the list to show your stores and the card scheme (Mastercard or Visa).

   3. For every store you want to include in the card program, get the MID that matches the card scheme.

3. Send the MIDs to the card issuer.\
   They will add the MIDs to the list of allowed stores, so that the mall card payments don't get refused.

## Supported gift cards and transactions

With a Terminal API integration you can accept gift cards issued by Givex, [Intersolve](https://intersolve.nl/en/), [Stored Value Solutions (SVS)](http://www.storedvalue.com), and [Fiserv](https://merchants.fiserv.com/en-us/products/merchants/gift-and-payroll-card-solutions/gift-card-solutions/) (formerly ValueLink), and make the following gift card transactions:

| Transaction                                                                                   | Givex                                                                                       | SVS                                                                                         | Fiserv                                                                                      | Intersolve                                                                                  | Local gift cards [1](<#local gift cards>)                                                   |
| --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| [Activate](/point-of-sale/gift-cards-terminal-api/activate) with or without loading an amount | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                |
| [Make a payment](/point-of-sale/gift-cards-terminal-api/payment)                              | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |
| [Check balance](/point-of-sale/gift-cards-terminal-api/query-the-balance)                     | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                |
| [Load an amount](/point-of-sale/gift-cards-terminal-api/load-a-balance)                       | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                |
| [Undo load transaction](/point-of-sale/gift-cards-terminal-api/void)                          | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                |
| [Refund](/point-of-sale/gift-cards-terminal-api/refund-gift-cards)                            | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                |
| [Cash out](/point-of-sale/gift-cards-terminal-api/deactivate)                                 | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                |
| [Deactivate](/point-of-sale/gift-cards-terminal-api/deactivate)                               | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                |

[]()1 We support gift cards from local gift card providers in Denmark, France, The Netherlands, Norway, Sweden, and the United Kingdom. You can process payments with these gift cards, but you cannot do other gift card transactions.

## Next steps

[required](/point-of-sale/gift-cards-terminal-api/activate)

###### [Activate gift card](/point-of-sale/gift-cards-terminal-api/activate)

[Activate a gift card, so it can be used by a shopper.](/point-of-sale/gift-cards-terminal-api/activate)

###### [Make gift card payment](/point-of-sale/gift-cards-terminal-api/payment)

[Make a point-of-sale gift card payment.](/point-of-sale/gift-cards-terminal-api/payment)

###### [Load funds](/point-of-sale/gift-cards-terminal-api/load-a-balance)

[Add funds to a gift card at the point of sale.](/point-of-sale/gift-cards-terminal-api/load-a-balance)

###### [Refund](/point-of-sale/gift-cards-terminal-api/refund-gift-cards)

[Make a refund to a gift card.](/point-of-sale/gift-cards-terminal-api/refund-gift-cards)
