Search

Are you looking for test card numbers?

Would you like to contact support?

Payment-method icon

Gift cards for API only

Add gift cards to an existing API-only integration.

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

Here we explain how you can:

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.cvcOptional. 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: givexsvs, or valuelink.
    {
       "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