---
title: "Gift cards (classic)"
description: "Add gift card payments to an existing API-only integration."
url: "https://docs.adyen.com/online-payments/classic-integrations/classic-api-integration/classic-gift-cards"
source_url: "https://docs.adyen.com/online-payments/classic-integrations/classic-api-integration/classic-gift-cards.md"
canonical: "https://docs.adyen.com/online-payments/classic-integrations/classic-api-integration/classic-gift-cards"
last_modified: "2021-05-07T13:00:00+02:00"
language: "en"
---

# Gift cards (classic)

Add gift card payments to an existing API-only integration.

[View source](/online-payments/classic-integrations/classic-api-integration/classic-gift-cards.md)

**Adyen is no longer developing the Classic API integration**

This page is for the Classic API (`/authorise`) integration, which we no longer accept new integrations with.

We strongly recommend migrating to the newer [Gift cards](/payment-methods/gift-cards) integration. To use this newer integration, you must also [migrate to the Checkout API](/online-payments/upgrade-your-integration/migrate-to-checkout-api).

Adyen allows you to process payments for gift cards provided by [Givex](https://www.givex.com), [SVS](http://www.storedvalue.com/), and [Fiserv](https://merchants.fiserv.com/en-us/products/merchants/gift-and-payroll-card-solutions/gift-card-solutions/) (formerly ValueLink).\
We also support gift cards from key local gift card providers in several countries/regions. You can process payments with these gift cards, but no other transactions.

Here we explain how you can:

* [Make a gift card payment](#make-payment) using the [/authorise](https://docs.adyen.com/api-explorer/#/Payment/authorise) endpoint.

For [other gift card transactions](/payment-methods/gift-cards/stored-value-api) you can use 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](https://docs.adyen.com/api-explorer/#/Payment/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**. The PIN code or other type of security code of the gift card. Not all virtual gift cards have a PIN.

  * `reference`: Your unique reference for this payment.

  * `selectedBrand`: Brand of the gift card.

  #### JSON

  ```json
  {
     "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"
  }
  ```

  #### Soap

  ```xml
  <?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`: When the payment is authorised successfully, this field holds the authorisation code for the payment. When the payment is not authorised, this field is empty.

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

For other possible response codes and fields of the payment response, refer to the `/authorise` [response parameters](https://docs.adyen.com/api-explorer/#/Payment/v50/authorise__section_resParams).

## Next steps

[required](/payment-methods/gift-cards/stored-value-api)

###### [Manage gift cards](/payment-methods/gift-cards/stored-value-api)

[Learn about other gift card transactions.](/payment-methods/gift-cards/stored-value-api)

###### [Check balance](/payment-methods/gift-cards/stored-value-api/check-balance)

[Check the value stored on a gift card.](/payment-methods/gift-cards/stored-value-api/check-balance)

## See also

* [Payment methods](/payment-methods)