---
title: "Stored Value API for managing gift cards"
description: "Use our Stored Value API to manage gift cards and other stored-value cards."
url: "https://docs.adyen.com/payment-methods/gift-cards/stored-value-api"
source_url: "https://docs.adyen.com/payment-methods/gift-cards/stored-value-api.md"
canonical: "https://docs.adyen.com/payment-methods/gift-cards/stored-value-api"
last_modified: "2022-05-10T16:19:00+02:00"
language: "en"
---

# Stored Value API for managing gift cards

Use our Stored Value API to manage gift cards and other stored-value cards.

[View source](/payment-methods/gift-cards/stored-value-api.md)

Here we describe how you can manage both online and point-of-sale gift cards and other stored-value cards with our JSON-only Stored Value API. This API lets you do the following transactions:

* [Issue](/payment-methods/gift-cards/stored-value-api/issue): issue a new gift card or other stored value card.
* [Change status](/payment-methods/gift-cards/stored-value-api/change-status): activate or deactivate a card.
* [Load](/payment-methods/gift-cards/stored-value-api/load): add funds to the balance of the card.
* [Check balance](/payment-methods/gift-cards/stored-value-api/check-balance): query the remaining balance of the card.
* [Merge balance](/payment-methods/gift-cards/stored-value-api/merge-balance): transfer all funds from a card to another one from the same provider.
* [Void transaction](/payment-methods/gift-cards/stored-value-api/void): undo a Stored Value API transaction from the last 24 hours.

With a point-of-sale integration, you may prefer to do the above transactions (except issuing) using our [Terminal API](/point-of-sale/gift-cards-terminal-api) because you already use that to make in-person gift card payments.

### Not for payments

The Stored Value API doesn't let you make, cancel, or refund payments. For these transactions, refer to the following table:

| Transaction                  | Integration type                      |                                                                                  |
| ---------------------------- | ------------------------------------- | -------------------------------------------------------------------------------- |
| Make a gift card payment     | [Online](/payment-methods/gift-cards) | [In-person payments](/point-of-sale/gift-cards-terminal-api/payment)             |
| Cancel a gift card payment   | [Online](/online-payments/cancel)     | [In-person payments](/point-of-sale/basic-tapi-integration/cancel-a-transaction) |
| Make a refund to a gift card | [Online](/online-payments/refund)     | [In-person payments](/point-of-sale/gift-cards-terminal-api/refund-gift-cards)   |

## Supported cards

The Stored Value API currently supports:

* Gift cards provided by [Intersolve](https://intersolve.nl/en/) (see [our overview page](/payment-methods/gift-cards#supported-gift-cards) for a selection of the gift cards that can go over this connection)
* Gift cards provided by [SVS](https://www.storedvalue.com)
* Gift cards provided by [Fiserv](https://merchants.fiserv.com/en-us/products/merchants/gift-and-payroll-card-solutions/gift-card-solutions/) (formerly ValueLink)

## Transactions per provider and channel

Whether a Stored Value API transaction is allowed, depends on the provider and the channel. Here is an overview:

#### Online

| Transaction                        | Givex                                                                                       | SVS                                                                                         | Fiserv (formerly ValueLink)                                                                 | Intersolve                                                                                  |
| ---------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| Issue new [See note](#issuing-svs) | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                |
| Activate                           | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | ![-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-")                                                |
| Activate and load amount           | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | ![-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-")                                                |
| Deactivate (without amount)        | ![-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-")                                                |
| Load 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-") |
| Check 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-") |
| Merge balance                      | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                |
| Void (undo) other transaction      | ![-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-") |

#### In-person payments

| Transaction                   | Givex                                                                                       | SVS                                                                                         | Fiserv (formerly ValueLink)                                                                 | Intersolve                                                                                  |
| ----------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| Issue new                     | ![-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-")                                                |
| Activate                      | ![-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-") |
| Activate and load 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-") |
| Deactivate (without amount)   | ![-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-")                                                |
| Load 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-") |
| Check 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-") |
| Merge balance                 | ![-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-")                                                |
| Void (undo) other transaction | ![-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-") |

[]()**Issuing SVS gift cards**\
If you are *building a new* Stored Value API integration, issuing SVS gift cards is not supported.

If you have an *existing* Stored Value API integration and have issued SVS gift cards, you can continue doing so.

## Endpoints

|      |                                                                             |
| ---- | --------------------------------------------------------------------------- |
| Test | https\://pal-**test**.adyen.com/pal/servlet/StoredValue/v4&#x36;**/method** |
| Live | https\://pal-**live**.adyen.com/pal/servlet/StoredValue/v4&#x36;**/method** |

The **`/method`** can be:

* [`/issue`](/payment-methods/gift-cards/stored-value-api/issue)
* [`/changeStatus`](/payment-methods/gift-cards/stored-value-api/change-status)
* [`/load`](/payment-methods/gift-cards/stored-value-api/load)
* [`/checkBalance`](/payment-methods/gift-cards/stored-value-api/check-balance)
* [`/mergeBalance`](/payment-methods/gift-cards/stored-value-api/merge-balance)
* [`/voidTransaction`](/payment-methods/gift-cards/stored-value-api/void)

## Result codes

These are the result codes you can receive from the Stored Value API.

* **Success**: The operation has been completed successfully.
* **Refused**: The operation was refused. The reason is given in the `refusalReason` field.
* **Error**: There was an error when the operation was processed. The reason is given in the `refusalReason` field.
* **NotEnoughBalance**: The amount on the gift card or other stored-value card is lower than the amount given in the request.

## Testing and going live

1. Before going live, use the following data to test Stored Value API transactions using the **Adyen simulator**:

   | Type                                  | Number                | Security code | Expiry month and yearOptional |
   | ------------------------------------- | --------------------- | ------------- | ----------------------------- |
   | Givex gift card                       | 603628672882001915092 | 5754          | 12 2020                       |
   | SVS gift card                         | 6006491286999921374   | 1111          | 12 2020                       |
   | Fiserv (formerly ValueLink) gift card | 7777182708544835      | 2329          | 12 2049                       |

   Enter any value when the simulator asks for a Fiserv (formerly ValueLink) promo code.

2. Apart from testing with our simulator, you should do **end-to-end testing**. Ask the provider of the gift card or other stored-value card for the test data you can use.

3. When you are ready to move to live, switch from test to [live endpoints](#sv-api-endpoints).

## Next steps

###### [Issue](/payment-methods/gift-cards/stored-value-api/issue)

[Issue a new gift card.](/payment-methods/gift-cards/stored-value-api/issue)

###### [Change status](/payment-methods/gift-cards/stored-value-api/change-status)

[Activate or deactivate a gift card.](/payment-methods/gift-cards/stored-value-api/change-status)

###### [Load](/payment-methods/gift-cards/stored-value-api/load)

[Add funds to a gift card.](/payment-methods/gift-cards/stored-value-api/load)

## See also

* [Check the value stored on a gift card](/payment-methods/gift-cards/stored-value-api/check-balance)
* [Transfer the value of one gift card to another one of the same type](/payment-methods/gift-cards/stored-value-api/merge-balance)
* [Undo a previous Stored Value API transaction from the last 24 hours](/payment-methods/gift-cards/stored-value-api/void)
