--- 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/v46**/method** | | Live | https\://pal-**live**.adyen.com/pal/servlet/StoredValue/v46**/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)