{"title":"Stored Value API for managing gift cards","category":"default","creationDate":1776961628,"content":"<p>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:<\/p>\n<ul>\n<li><a href=\"\/pt\/payment-methods\/gift-cards\/stored-value-api\/issue\">Issue<\/a>: issue a new gift card or other stored value card.<\/li>\n<li><a href=\"\/pt\/payment-methods\/gift-cards\/stored-value-api\/change-status\">Change status<\/a>: activate or deactivate a card.<\/li>\n<li><a href=\"\/pt\/payment-methods\/gift-cards\/stored-value-api\/load\">Load<\/a>: add funds to the balance of the card.<\/li>\n<li><a href=\"\/pt\/payment-methods\/gift-cards\/stored-value-api\/check-balance\">Check balance<\/a>: query the remaining balance of the card.<\/li>\n<li><a href=\"\/pt\/payment-methods\/gift-cards\/stored-value-api\/merge-balance\">Merge balance<\/a>: transfer all funds from a card to another one from the same provider.<\/li>\n<li><a href=\"\/pt\/payment-methods\/gift-cards\/stored-value-api\/void\">Void transaction<\/a>: undo a Stored Value API transaction from the last 24 hours.<\/li>\n<\/ul>\n<div class=\"notices blue\">\n<p>With a point-of-sale integration, you may prefer to do the above transactions (except issuing) using our <a href=\"\/pt\/point-of-sale\/gift-cards-terminal-api\">Terminal API<\/a> because you already use that to make in-person gift card payments.<\/p>\n<\/div>\n<h3>Not for payments<\/h3>\n<p>The Stored Value API doesn't let you make, cancel, or refund payments. For these transactions, refer to the following table:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Transaction<\/th>\n<th style=\"text-align: left;\">Integration type<\/th>\n<th style=\"text-align: left;\"><\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Make a gift card payment<\/td>\n<td style=\"text-align: left;\"><a href=\"\/pt\/payment-methods\/gift-cards\">Online<\/a><\/td>\n<td style=\"text-align: left;\"><a href=\"\/pt\/point-of-sale\/gift-cards-terminal-api\/payment\">In-person payments<\/a><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Cancel a gift card payment<\/td>\n<td style=\"text-align: left;\"><a href=\"\/pt\/online-payments\/cancel\">Online<\/a><\/td>\n<td style=\"text-align: left;\"><a href=\"\/pt\/point-of-sale\/basic-tapi-integration\/cancel-a-transaction\">In-person payments<\/a><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Make a refund to a gift card<\/td>\n<td style=\"text-align: left;\"><a href=\"\/pt\/online-payments\/refund\">Online<\/a><\/td>\n<td style=\"text-align: left;\"><a href=\"\/pt\/point-of-sale\/gift-cards-terminal-api\/refund-gift-cards\">In-person payments<\/a><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"supported-cards\">Supported cards<\/h2>\n<p>The Stored Value API currently supports:<\/p>\n<ul>\n<li>Gift cards provided by <a href=\"https:\/\/intersolve.nl\/en\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Intersolve<\/a> (see <a href=\"\/pt\/payment-methods\/gift-cards#supported-gift-cards\">our overview page<\/a> for a selection of the gift cards that can go over this connection)<\/li>\n<li>Gift cards provided by <a href=\"https:\/\/www.storedvalue.com\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">SVS<\/a><\/li>\n<li>Gift cards provided by <a href=\"https:\/\/merchants.fiserv.com\/en-us\/products\/merchants\/gift-and-payroll-card-solutions\/gift-card-solutions\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Fiserv<\/a> (formerly ValueLink)<\/li>\n<\/ul>\n<h2 id=\"supported-transactions\">Transactions per provider and channel<\/h2>\n<p>Whether a Stored Value API transaction is allowed, depends on the provider and the channel. Here is an overview:<\/p>\n<div class=\"row\" style=\"align-items: center;justify-content: center;\">\n<div class=\"col col-12 col-md-6\" style=\"background-color:transparent;;\"><h4>Online<\/h4><table><thead><tr><th style=\"text-align: left;\">Transaction<\/th><th style=\"text-align: center;\">Givex<\/th><th style=\"text-align: center;\">SVS<\/th><th style=\"text-align: center;\">Fiserv (formerly ValueLink)<\/th><th style=\"text-align: center;\">Intersolve<\/th><\/tr><\/thead><tbody><tr><td style=\"text-align: left;\">Issue new <br><a href=\"#issuing-svs\">See note<\/a><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><\/tr><tr><td style=\"text-align: left;\">Activate<\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><\/tr><tr><td style=\"text-align: left;\">Activate and load amount<\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><\/tr><tr><td style=\"text-align: left;\">Deactivate (without amount)<\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><\/tr><tr><td style=\"text-align: left;\">Load amount<\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><\/tr><tr><td style=\"text-align: left;\">Check balance<\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><\/tr><tr><td style=\"text-align: left;\">Merge balance<\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><\/tr><tr><td style=\"text-align: left;\">Void (undo) other transaction<\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><\/tr><\/tbody><\/table><\/div><div class=\"col col-12 col-md-6\" style=\"background-color:transparent;;\"><h4>In-person payments<\/h4><table><thead><tr><th style=\"text-align: left;\">Transaction<\/th><th style=\"text-align: center;\">Givex<\/th><th style=\"text-align: center;\">SVS<\/th><th style=\"text-align: center;\">Fiserv (formerly ValueLink)<\/th><th style=\"text-align: center;\">Intersolve<\/th><\/tr><\/thead><tbody><tr><td style=\"text-align: left;\">Issue new <br><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><\/tr><tr><td style=\"text-align: left;\">Activate<\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><\/tr><tr><td style=\"text-align: left;\">Activate and load amount<\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><\/tr><tr><td style=\"text-align: left;\">Deactivate (without amount)<\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><\/tr><tr><td style=\"text-align: left;\">Load amount<\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><\/tr><tr><td style=\"text-align: left;\">Check balance<\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><\/tr><tr><td style=\"text-align: left;\">Merge balance<\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><td style=\"text-align: center;\"><img title=\"-x-\" alt=\"-x-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/x.png\"><\/td><\/tr><tr><td style=\"text-align: left;\">Void (undo) other transaction<\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\"><\/td><\/tr><\/tbody><\/table><\/div><\/div>\n<div class=\"row\" style=\"align-items: center;justify-content: center;\">\n<div class=\"col col-12 col-md-6\" style=\"background-color:transparent;;\"><div class=\"sc-notice note\"><div><p><a id=\"issuing-svs\"><\/a><strong>Issuing SVS gift cards<\/strong><br>\nIf you are <em>building a new<\/em> Stored Value API integration, issuing SVS gift cards is not supported.<\/p><p>If you have an <em>existing<\/em> Stored Value API integration and have issued SVS gift cards, you can continue doing so.<\/p><\/div><\/div><\/div><div class=\"col col-12 col-md-6\" style=\"background-color:transparent;;\"><\/div><\/div>\n<h2 id=\"sv-api-endpoints\">Endpoints<\/h2>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\"><\/th>\n<th style=\"text-align: left;\"><\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Test<\/td>\n<td style=\"text-align: left;\">https&#58;\/\/pal-<span translate=\"no\"><strong>test<\/strong><\/span>.adyen.com\/pal\/servlet\/StoredValue\/v46<strong>\/method<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Live<\/td>\n<td style=\"text-align: left;\">https&#58;\/\/pal-<span translate=\"no\"><strong>live<\/strong><\/span>.adyen.com\/pal\/servlet\/StoredValue\/v46<strong>\/method<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>The <strong><code>\/method<\/code><\/strong> can be:<\/p>\n<ul>\n<li><a href=\"\/pt\/payment-methods\/gift-cards\/stored-value-api\/issue\">\n  <code>\/issue<\/code>\n<\/a><\/li>\n<li><a href=\"\/pt\/payment-methods\/gift-cards\/stored-value-api\/change-status\">\n  <code>\/changeStatus<\/code>\n<\/a><\/li>\n<li><a href=\"\/pt\/payment-methods\/gift-cards\/stored-value-api\/load\">\n  <code>\/load<\/code>\n<\/a><\/li>\n<li><a href=\"\/pt\/payment-methods\/gift-cards\/stored-value-api\/check-balance\">\n  <code>\/checkBalance<\/code>\n<\/a><\/li>\n<li><a href=\"\/pt\/payment-methods\/gift-cards\/stored-value-api\/merge-balance\">\n  <code>\/mergeBalance<\/code>\n<\/a><\/li>\n<li><a href=\"\/pt\/payment-methods\/gift-cards\/stored-value-api\/void\">\n  <code>\/voidTransaction<\/code>\n<\/a><\/li>\n<\/ul>\n<h2 id=\"result-codes\">Result codes<\/h2>\n<p>These are the result codes you can receive from the Stored Value API.<\/p>\n<ul>\n<li><span translate=\"no\"><strong>Success<\/strong><\/span>: The operation has been completed successfully.<\/li>\n<li><span translate=\"no\"><strong>Refused<\/strong><\/span>: The operation was refused. The reason is given in the <code>refusalReason<\/code> field.<\/li>\n<li><span translate=\"no\"><strong>Error<\/strong><\/span>: There was an error when the operation was processed. The reason is given in the <code>refusalReason<\/code> field.<\/li>\n<li><span translate=\"no\"><strong>NotEnoughBalance<\/strong><\/span>: The amount on the gift card or other stored-value card is lower than the amount given in the request.<\/li>\n<\/ul>\n<h2 id=\"testing\">Testing and going live<\/h2>\n<ol>\n<li>\n<p>Before going live, use the following data to test Stored Value API transactions using the <strong>Adyen simulator<\/strong>:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Type<\/th>\n<th style=\"text-align: left;\">Number<\/th>\n<th style=\"text-align: left;\">Security code<\/th>\n<th style=\"text-align: left;\">Expiry month and year <div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;success&quot;>\n        Optional\n    <\/tag>\n<\/div>\n<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Givex gift card<\/td>\n<td style=\"text-align: left;\">603628672882001915092<\/td>\n<td style=\"text-align: left;\">5754<\/td>\n<td style=\"text-align: left;\">12 2020<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">SVS gift card<\/td>\n<td style=\"text-align: left;\">6006491286999921374<\/td>\n<td style=\"text-align: left;\">1111<\/td>\n<td style=\"text-align: left;\">12 2020<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Fiserv (formerly ValueLink) gift card<\/td>\n<td style=\"text-align: left;\">7777182708544835<\/td>\n<td style=\"text-align: left;\">2329<\/td>\n<td style=\"text-align: left;\">12 2049<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>Enter any value when the simulator asks for a Fiserv (formerly ValueLink) promo code.<\/p>\n<\/li>\n<li>\n<p>Apart from testing with our simulator, you should do <strong>end-to-end testing<\/strong>. Ask the provider of the gift card or other stored-value card for the test data you can use.<\/p>\n<\/li>\n<li>\n<p>When you are ready to move to live, switch from test to <a href=\"#sv-api-endpoints\">live endpoints<\/a>.<\/p>\n<\/li>\n<\/ol>\n<h2>Next steps<\/h2>\n<div class=\"next-steps\" id=\"next-steps\" >\n<a href=\"\/payment-methods\/gift-cards\/stored-value-api\/issue\" class=\"next-steps__step\" style=\"width:29%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Issue<\/h6><p>Issue a new gift card.<\/p><\/div><\/p><\/a><a href=\"\/payment-methods\/gift-cards\/stored-value-api\/change-status\" class=\"next-steps__step\" style=\"width:29%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Change status<\/h6><p>Activate or deactivate a gift card.<\/p><\/div><\/p><\/a><a href=\"\/payment-methods\/gift-cards\/stored-value-api\/load\" class=\"next-steps__step\" style=\"width:29%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Load<\/h6><p>Add funds to a gift card.<\/p><\/div><\/p><\/a><\/div>\n\n<h2 id=\"see-also\">See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/payment-methods\/gift-cards\/stored-value-api\/check-balance\"\n                        target=\"_self\"\n                        >\n                    Check the value stored on a gift card\n                <\/a><\/li><li><a href=\"\/payment-methods\/gift-cards\/stored-value-api\/merge-balance\"\n                        target=\"_self\"\n                        >\n                    Transfer the value of one gift card to another one of the same type\n                <\/a><\/li><li><a href=\"\/payment-methods\/gift-cards\/stored-value-api\/void\"\n                        target=\"_self\"\n                        >\n                    Undo a previous Stored Value API transaction from the last 24 hours\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/gift-cards\/stored-value-api","articleFields":{"description":"Use our Stored Value API to manage gift cards and other stored-value cards.","feedback_component":true,"last_edit_on":"10-05-2022 16:19","page_id":"f5611997-3162-4e55-8bbe-48041a6b4ccb","filters_component":false,"decision_tree":"[]"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/gift-cards\/stored-value-api","title":"Stored Value API for managing gift cards","content":"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:\n\nIssue: issue a new gift card or other stored value card.\nChange status: activate or deactivate a card.\nLoad: add funds to the balance of the card.\nCheck balance: query the remaining balance of the card.\nMerge balance: transfer all funds from a card to another one from the same provider.\nVoid transaction: undo a Stored Value API transaction from the last 24 hours.\n\n\nWith a point-of-sale integration, you may prefer to do the above transactions (except issuing) using our Terminal API because you already use that to make in-person gift card payments.\n\nNot for payments\nThe Stored Value API doesn't let you make, cancel, or refund payments. For these transactions, refer to the following table:\n\n\n\nTransaction\nIntegration type\n\n\n\n\n\nMake a gift card payment\nOnline\nIn-person payments\n\n\nCancel a gift card payment\nOnline\nIn-person payments\n\n\nMake a refund to a gift card\nOnline\nIn-person payments\n\n\n\nSupported cards\nThe Stored Value API currently supports:\n\nGift cards provided by Intersolve (see our overview page for a selection of the gift cards that can go over this connection)\nGift cards provided by SVS\nGift cards provided by Fiserv (formerly ValueLink)\n\nTransactions per provider and channel\nWhether a Stored Value API transaction is allowed, depends on the provider and the channel. Here is an overview:\n\nOnlineTransactionGivexSVSFiserv (formerly ValueLink)IntersolveIssue new See noteActivateActivate and load amountDeactivate (without amount)Load amountCheck balanceMerge balanceVoid (undo) other transactionIn-person paymentsTransactionGivexSVSFiserv (formerly ValueLink)IntersolveIssue new ActivateActivate and load amountDeactivate (without amount)Load amountCheck balanceMerge balanceVoid (undo) other transaction\n\nIssuing SVS gift cards\nIf 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.\nEndpoints\n\n\n\n\n\n\n\n\n\nTest\nhttps&#58;\/\/pal-test.adyen.com\/pal\/servlet\/StoredValue\/v46\/method\n\n\nLive\nhttps&#58;\/\/pal-live.adyen.com\/pal\/servlet\/StoredValue\/v46\/method\n\n\n\nThe \/method can be:\n\n\n  \/issue\n\n\n  \/changeStatus\n\n\n  \/load\n\n\n  \/checkBalance\n\n\n  \/mergeBalance\n\n\n  \/voidTransaction\n\n\nResult codes\nThese are the result codes you can receive from the Stored Value API.\n\nSuccess: The operation has been completed successfully.\nRefused: The operation was refused. The reason is given in the refusalReason field.\nError: There was an error when the operation was processed. The reason is given in the refusalReason field.\nNotEnoughBalance: The amount on the gift card or other stored-value card is lower than the amount given in the request.\n\nTesting and going live\n\n\nBefore going live, use the following data to test Stored Value API transactions using the Adyen simulator:\n\n\n\nType\nNumber\nSecurity code\nExpiry month and year \n    \n        Optional\n    \n\n\n\n\n\n\nGivex gift card\n603628672882001915092\n5754\n12 2020\n\n\nSVS gift card\n6006491286999921374\n1111\n12 2020\n\n\nFiserv (formerly ValueLink) gift card\n7777182708544835\n2329\n12 2049\n\n\n\nEnter any value when the simulator asks for a Fiserv (formerly ValueLink) promo code.\n\n\nApart 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.\n\n\nWhen you are ready to move to live, switch from test to live endpoints.\n\n\nNext steps\n\nIssueIssue a new gift card.Change statusActivate or deactivate a gift card.LoadAdd funds to a gift card.\n\nSee also\n\n\n                    Check the value stored on a gift card\n                \n                    Transfer the value of one gift card to another one of the same type\n                \n                    Undo a previous Stored Value API transaction from the last 24 hours\n                \n","type":"page","locale":"pt","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"Payment methods","lvl2":"Gift cards","lvl3":"Stored Value API for managing gift cards"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/payment-methods","lvl2":"https:\/\/docs.adyen.com\/pt\/payment-methods\/gift-cards","lvl3":"\/pt\/payment-methods\/gift-cards\/stored-value-api"},"levels":4,"category":"Payment method","category_color":"green","tags":["Stored","Value","managing","cards"]}}