{"title":"Issue a new gift card","category":"default","creationDate":1682034480,"content":"<p>The <code>\/issue<\/code> endpoint of our <a href=\"\/pt\/payment-methods\/gift-cards\/stored-value-api\">Stored Value API<\/a> lets you issue a new virtual gift card or other stored-value card. The card is activated automatically, and some providers automatically preload the newly issued card with a certain amount.<\/p>\n<h3>Transaction per provider and channel<\/h3>\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<\/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><\/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<\/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><\/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 class=\"sc-notice note\"><div><p>You cannot issue plastic gift cards with the Stored Value API.<\/p><\/div><\/div><\/div><\/div>\n<h2 id=\"issue-request\">Issue a new card<\/h2>\n<p>To request a new gift card or other stored-value card:<\/p>\n<ul>\n<li>\n<p>Make a POST request to the <a href=\"\/pt\/payment-methods\/gift-cards\/stored-value-api#sv-api-endpoints\"><code>\/issue<\/code> endpoint<\/a>, specifying:<\/p>\n<ul>\n<li><code>merchantAccount<\/code>: Name of the merchant account that you want to process the transaction with.<\/li>\n<li><code>store<\/code>: <div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;success&quot;>\n        Optional\n    <\/tag>\n<\/div>\n For transactions flagged as in-store, the ID of the physical store that you want to process the transaction for. Maximum length: 16 characters.<\/li>\n<li><code>paymentMethod.type<\/code>: Name or brand of the card. Accepted values: <span translate=\"no\"><strong>givex<\/strong><\/span>, <span translate=\"no\"><strong>svs<\/strong><\/span> and <span translate=\"no\"><strong>valuelink<\/strong><\/span>. Do not use any other <code>paymentMethod<\/code> fields.<\/li>\n<li><code>amount<\/code>: The <code>currency<\/code> and <code>value<\/code> of the funds the card needs to be issued with. Optional for Givex gift cards. Must be greater than zero for SVS. Do not use for other cards.<\/li>\n<li><code>giftCardPromoCode<\/code>: Promotional code of the gift card. Required for Fiserv (formerly ValueLink) gift cards. Do not use for other cards.<\/li>\n<li><code>reference<\/code>: Your reference to uniquely identify this transaction. To provide multiple references for a transaction, separate them with hyphens (\"-\"). Maximum length: 80 characters.<\/li>\n<\/ul>\n<p>This request issues a new virtual Givex gift card with a value of EUR&nbsp;10:<\/p>\n<pre><code class=\"language-json\">{\n    \"merchantAccount\": \"ADYEN_MERCHANT_ACCOUNT\",\n    \"store\": \"YOUR_STORE_ID\",\n    \"paymentMethod\": {\n        \"type\": \"givex\"\n    },\n    \"amount\": {\n        \"currency\": \"EUR\",\n        \"value\": 1000\n    },\n    \"reference\": \"YOUR_REFERENCE\"\n}<\/code><\/pre>\n<p>This request issues a new virtual Fiserv (formerly ValueLink) gift card:<\/p>\n<pre><code class=\"language-json\">{\n    \"merchantAccount\": \"ADYEN_MERCHANT_ACCOUNT\",\n    \"store\": \"YOUR_STORE_ID\",\n    \"paymentMethod\": {\n        \"type\": \"valuelink\"\n    },\n    \"giftCardPromoCode\": \"1324\",\n    \"reference\": \"YOUR_REFERENCE\"\n}<\/code><\/pre>\n<\/li>\n<\/ul>\n<h4 id=\"response\">Response<\/h4>\n<p>You receive a response containing:<\/p>\n<ul>\n<li><code>currentBalance<\/code>: The <code>currency<\/code> and <code>value<\/code> of the funds stored on the card.<\/li>\n<li><code>pspReference<\/code>: Adyen's 16-character unique reference associated with the transaction.<\/li>\n<li><code>resultCode<\/code>: Indicates the state of the request. Refer to <a href=\"\/pt\/payment-methods\/gift-cards\/stored-value-api#result-codes\">Result codes<\/a> for the values that you can receive.<\/li>\n<li><code>paymentMethod.number<\/code>: Card number that identifies the newly issued card.<\/li>\n<li><code>paymentMethod.type<\/code>: Name or brand of the card you issued.<\/li>\n<\/ul>\n<p>The response may include additional fields, depending on the additional data settings for your merchant account. In your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, you'll find these settings under <strong>Developers<\/strong> &gt; <strong>Additional data<\/strong>.<\/p>\n<p>Sample response for a newly issued SVS gift card:<\/p>\n<pre><code class=\"language-json\">{\n    \"currentBalance\": {\n        \"currency\": \"EUR\",\n        \"value\": 1000\n    },\n    \"pspReference\": \"851564651069192J\",\n    \"resultCode\": \"Success\",\n    \"paymentMethod\": {\n        \"number\": \"7219627091701347\",\n        \"securityCode\": \"0140\",\n        \"type\": \"givex\"\n    }\n}<\/code><\/pre>\n<h2>Next steps<\/h2>\n<div class=\"next-steps\" id=\"next-steps\" >\n<a href=\"\/payment-methods\/gift-cards\/stored-value-api\/load\" class=\"next-steps__step\" style=\"width:45%;\" 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><a href=\"\/payment-methods\/gift-cards\/stored-value-api\/check-balance\" class=\"next-steps__step\" style=\"width:45%;\" target=\"_self\"><p class=\"next-steps__body\"><div style=\"text-align: center;\"><h6 class=\"next-steps__title\">Check balance<\/h6><p>Check the value stored on 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\/change-status\"\n                        target=\"_self\"\n                        >\n                    Activate or deactivate 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 from one gift card to another 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><li><a href=\"\/payment-methods\/gift-cards\/stored-value-api\"\n                        target=\"_self\"\n                        >\n                    Stored Value API\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/gift-cards\/stored-value-api\/issue","articleFields":{"description":"Issue a new gift card or other stored-value card.","last_edit_on":"21-04-2023 01:49","feedback_component":true,"filters_component":false},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/payment-methods\/gift-cards\/stored-value-api\/issue","title":"Issue a new gift card","content":"The \/issue endpoint of our Stored Value API lets you issue a new virtual gift card or other stored-value card. The card is activated automatically, and some providers automatically preload the newly issued card with a certain amount.\nTransaction per provider and channel\n\nOnlineTransactionGivexSVSFiserv (formerly ValueLink)IntersolveIssue newIn-person paymentsTransactionGivexSVSFiserv (formerly ValueLink)IntersolveIssue new\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.You cannot issue plastic gift cards with the Stored Value API.\nIssue a new card\nTo request a new gift card or other stored-value card:\n\n\nMake a POST request to the \/issue endpoint, specifying:\n\nmerchantAccount: Name of the merchant account that you want to process the transaction with.\nstore: \n    \n        Optional\n    \n\n For transactions flagged as in-store, the ID of the physical store that you want to process the transaction for. Maximum length: 16 characters.\npaymentMethod.type: Name or brand of the card. Accepted values: givex, svs and valuelink. Do not use any other paymentMethod fields.\namount: The currency and value of the funds the card needs to be issued with. Optional for Givex gift cards. Must be greater than zero for SVS. Do not use for other cards.\ngiftCardPromoCode: Promotional code of the gift card. Required for Fiserv (formerly ValueLink) gift cards. Do not use for other cards.\nreference: Your reference to uniquely identify this transaction. To provide multiple references for a transaction, separate them with hyphens (\"-\"). Maximum length: 80 characters.\n\nThis request issues a new virtual Givex gift card with a value of EUR&nbsp;10:\n{\n    \"merchantAccount\": \"ADYEN_MERCHANT_ACCOUNT\",\n    \"store\": \"YOUR_STORE_ID\",\n    \"paymentMethod\": {\n        \"type\": \"givex\"\n    },\n    \"amount\": {\n        \"currency\": \"EUR\",\n        \"value\": 1000\n    },\n    \"reference\": \"YOUR_REFERENCE\"\n}\nThis request issues a new virtual Fiserv (formerly ValueLink) gift card:\n{\n    \"merchantAccount\": \"ADYEN_MERCHANT_ACCOUNT\",\n    \"store\": \"YOUR_STORE_ID\",\n    \"paymentMethod\": {\n        \"type\": \"valuelink\"\n    },\n    \"giftCardPromoCode\": \"1324\",\n    \"reference\": \"YOUR_REFERENCE\"\n}\n\n\nResponse\nYou receive a response containing:\n\ncurrentBalance: The currency and value of the funds stored on the card.\npspReference: Adyen's 16-character unique reference associated with the transaction.\nresultCode: Indicates the state of the request. Refer to Result codes for the values that you can receive.\npaymentMethod.number: Card number that identifies the newly issued card.\npaymentMethod.type: Name or brand of the card you issued.\n\nThe response may include additional fields, depending on the additional data settings for your merchant account. In your Customer Area, you'll find these settings under Developers &gt; Additional data.\nSample response for a newly issued SVS gift card:\n{\n    \"currentBalance\": {\n        \"currency\": \"EUR\",\n        \"value\": 1000\n    },\n    \"pspReference\": \"851564651069192J\",\n    \"resultCode\": \"Success\",\n    \"paymentMethod\": {\n        \"number\": \"7219627091701347\",\n        \"securityCode\": \"0140\",\n        \"type\": \"givex\"\n    }\n}\nNext steps\n\nLoadAdd funds to a gift card.Check balanceCheck the value stored on a gift card.\n\nSee also\n\n\n                    Activate or deactivate a gift card.\n                \n                    Transfer the value from one gift card to another of the same type\n                \n                    Undo a previous Stored Value API transaction from the last 24 hours\n                \n                    Stored Value API\n                \n","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Payment methods","lvl2":"Gift cards","lvl3":"Stored Value API for managing gift cards","lvl4":"Issue a new gift card"},"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":"https:\/\/docs.adyen.com\/pt\/payment-methods\/gift-cards\/stored-value-api","lvl4":"\/pt\/payment-methods\/gift-cards\/stored-value-api\/issue"},"levels":5,"category":"Payment method","category_color":"green","tags":["Issue"]}}