Search docs

Are you looking for test card numbers?

Would you like to contact support?

Start searching Adyen's documentation...

  Documentation

Givex and SVS gift cards

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, specifying:

    • amount: The currency and value of the transaction.
    • card.expiryMonth: Expiry month of the gift card. 
    • card.expiryYear: Expiry year of the gift card. 
    • card.number: Gift card number.
    • reference: Your unique reference for this payment.
    • selectedBrand: Brand of the gift card, either givex or svs
    • card.cvcOptional: Specify this if the card has a PIN.

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

    {
       "amount":{
          "currency":"GBP",
          "value":1000
       },
       "card":{
          "cvc":"1234",
          "expiryMonth":"10",
          "expiryYear":"2020",
          "holderName":"John Smith",
          "number":"6036283997595793321"
       },
       "reference":"Your Reference Here",
       "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">1000</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>10</expiryMonth>
                   <expiryYear>2020</expiryYear>
                   <holderName>John Smith</holderName>
                   <issueNumber xsi:nil="true" />
                   <number>6036283997595793321</number>
                   <startMonth xsi:nil="true" />
                   <startYear xsi:nil="true" />
                </card>
                <reference xmlns="http://payment.services.adyen.com">Your Reference Here</reference>
                <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>

Check balance

To check the balance of a gift card:

  • Make a /authorise request for a normal gift card payment, but specify:

    • amount: Value of 0
    {
       "amount":{
          "currency":"GBP",
          "value":0
       },
       "card":{
          "cvc":"1234",
          "expiryMonth":"10",
          "expiryYear":"2020",
          "holderName":"John Smith",
          "number":"6036283997595793321"
       },
       "reference":"Your Reference Here",
       "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>10</expiryMonth>
                   <expiryYear>2020</expiryYear>
                   <holderName>John Smith</holderName>
                   <issueNumber xsi:nil="true" />
                   <number>6036283997595793321</number>
                   <startMonth xsi:nil="true" />
                   <startYear xsi:nil="true" />
                </card>
                <reference xmlns="http://payment.services.adyen.com">Your Reference Here</reference>
                <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>

The response contains an additionalData.currentBalanceValue value. This indicates the remaining balance of the gift card.

{
  "additionalData": {
    "currentBalanceValue": "1000"
  },
  "pspReference": "8515500935686981",
  "resultCode": "Authorised"
}

Deactivate gift card

If you suspect that a card is lost or stolen, you can deactivate it.

To deactivate a gift card:

  • Make a /authorise request for a normal gift card payment, but specify:

    • amount: Value of 0
    • additionalData.stored_value_redemption_type: deactivate
    {
       "amount":{
          "currency":"EUR",
          "value":0
       },
       "card":{
          "cvc":"1234",
          "expiryMonth":"10",
          "expiryYear":"2020",
          "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>10</expiryMonth>
                   <expiryYear>2020</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>