Gift cards for API only

Adyen allows you to process payments for gift cards provided by Givex, SVS, and ValueLink.

Here we explain how you can:

• Make a gift card payment.

Apart from making payments, you can manage gift cards using our JSON-only Stored Value API. For example, you can issue a new card, check the balance stored on a card, or deactivate a card.

Make a payment

To make a gift card payment:

• Make a POST request to the /authorise endpoint, specifying the following parameters:

  • amount: The currency and value (in minor units) of the transaction.

    A value of 0 will return additionalData.currentBalanceValue with the remaining balance stored on the gift card.

  • card.expiryMonth: Expiry month of the gift card. 
  • card.expiryYear: Expiry year of the gift card. 
  • card.number: Gift card number.
  • card.holderName: Optional. Name of the shopper that the gift card belongs to.

  • card.cvc: Optional. Specify this if the card has a PIN.

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

  • reference: Your unique reference for this payment.
  • selectedBrand: Brand of the gift card. Supported values: givex, svs, or valuelink.
  https://docs.adyen.com/payment-methods/gift-cards/api-only#1910163007

  • JSON
  • SOAP

  JSON SOAP

  {
     "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>

Response

You receive a response containing:

• resultCode: Use this to present the payment result to the shopper.
• pspReference: Our unique reference for the payment.
• authCode: Authorisation code for the payment.

{
  "pspReference": "8814689190961342",
  "resultCode": "Authorised",
  "authCode": "83152"
}

For other possible response codes and fields of the payment response, refer to the /authorise response parameters.

Next steps

See also