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.
          "holderName":"John Smith",
       "reference":"Your Reference Here",
    <?xml version="1.0" encoding="UTF-8"?>
    <soap:Envelope xmlns:soap="" xmlns:xsd="" xmlns:xsi="">
          <ns1:authorise xmlns:ns1="">
                <amount xmlns="">
                   <currency xmlns="">GBP</currency>
                   <value xmlns="">1000</value>
                <billingAddress xmlns="" xsi:nil="true" />
                <card xmlns="">
                   <billingAddress xsi:nil="true" />
                   <holderName>John Smith</holderName>
                   <issueNumber xsi:nil="true" />
                   <startMonth xsi:nil="true" />
                   <startYear xsi:nil="true" />
                <reference xmlns="">Your Reference Here</reference>
                <merchantAccount xmlns="">TestMerchant</merchantAccount>
                <merchantOrderReference xmlns="" xsi:nil="true" />
                <selectedBrand xmlns="">givex</selectedBrand>


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