Gift cards - Givex and SVS

Adyen allows you to process payments for the Givex and SVS gift card platforms. These use the same structure and endpoints as other card payment methods. 

Here we explain how you can:

You can also check out our API reference for gift cards.

Make payment

To process a gift card payment, make an /authorise request.

You'll need to specify the brand of the gift card, either givex or svs, in the selectedBrand. Also include the expiryMonth, expiryYear, and number of the gift card.

If the gift cards have a PIN, provide this in the cvc field.

Enabling a PIN for gift cards requires additional configuration by the gift card platform and Adyen. Contact the Support Team for more information.

Example

{
   "amount":{
      "currency":"GBP",
      "value":0
   },
   "card":{
      "cvc":"1234",
      "expiryMonth":"12",
      "expiryYear":"2018",
      "holderName":"John Smith",
      "number":"6036283997595793321"
   },
   "deliveryDate":"2017-04-13T02:00:00+02:00",
   "merchantAccount":"TestMerchant",
   "selectedBrand":"givex"
}
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <soap:Body>
      <ns1:authorise xmlns:ns1="http://payment.services.adyen.com">
         <ns1:paymentRequest>
            <amount xmlns="http://payment.services.adyen.com">
               <currency xmlns="http://common.services.adyen.com">GBP</currency>
               <value xmlns="http://common.services.adyen.com">0</value>
            </amount>
            <billingAddress xmlns="http://payment.services.adyen.com" xsi:nil="true" />
            <card xmlns="http://payment.services.adyen.com">
               <billingAddress xsi:nil="true" />
               <cvc>1234</cvc>
               <expiryMonth>12</expiryMonth>
               <expiryYear>2018</expiryYear>
               <holderName>John Smith</holderName>
               <issueNumber xsi:nil="true" />
               <number>6036283997595793321</number>
               <startMonth xsi:nil="true" />
               <startYear xsi:nil="true" />
            </card>
            <deliveryDate xmlns="http://payment.services.adyen.com">2017-04-13T02:00:00+02:00</deliveryDate>
            <merchantAccount xmlns="http://payment.services.adyen.com">TestMerchant</merchantAccount>
            <merchantOrderReference xmlns="http://payment.services.adyen.com" xsi:nil="true" />
            <selectedBrand xmlns="http://payment.services.adyen.com">givex</selectedBrand>
         </ns1:paymentRequest>
      </ns1:authorise>
   </soap:Body>
</soap:Envelope>

Deactivate gift card

If you suspect that a card is lost or stolen, you can deactivate it by making a zero-value auth call with an additionalData object.

Example

{
   "amount":{
      "currency":"EUR",
      "value":0
   },
   "card":{
      "cvc":"1234",
      "expiryMonth":"12",
      "expiryYear":"2018",
      "holderName":"John Smith",
      "number":"6036283997595793321"
   },
   "additionalData":{
      "stored_value_redemption_type":"deactivate"
   },
   "merchantAccount":"TestMerchant",
   "reference":"Your Reference Here",
   "shopperEmail":"s.hopper@test.com",
   "shopperReference":"Simon Hopper"
}
<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema- instance">
   <soap:Body>
      <ns1:authorise xmlns:ns1="http://payment.services.adyen.com">
         <ns1:paymentRequest>
            <amount xmlns="http://payment.services.adyen.com">
               <currency xmlns="http://common.services.adyen.com">EUR</currency>
               <value xmlns="http://common.services.adyen.com">0</value>
            </amount>
            <card xmlns="http://payment.services.adyen.com">
               <cvc>1234</cvc>
               <expiryMonth>12</expiryMonth>
               <expiryYear>2018</expiryYear>
               <holderName>John Smith</holderName>
               <number>6036283997595793321</number>
            </card>
            <additionalData xmlns="http://payment.services.adyen.com">
               <entry>
                  <key xsi:type="xsd:string">stored_value_redemption_type</key>
                  <value xsi:type="xsd:string">deactivate</value>
               </entry>
            </additionalData>
            <merchantAccount xmlns="http://payment.services.adyen.com">TestMerchant</merchantAccount>
            <reference xmlns="http://payment.services.adyen.com">Your Reference Here</reference>
            <shopperEmail xmlns="http://payment.services.adyen.com">s.hopper@test.com</shopperEmail>
            <shopperReference xmlns="http://payment.services.adyen.com">Simon Hopper</shopperReference>
         </ns1:paymentRequest>
      </ns1:authorise>
   </soap:Body>
</soap:Envelope>