Classic-integration icon

Gift cards (classic)

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

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 integration. To use this newer integration, you must also migrate to the Checkout API.

Adyen allows you to process payments for gift cards provided by Givex, SVS, and Fiserv (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:

For other gift card transactions 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 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.

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