Issue a new gift card

The /issue endpoint of our Stored Value API lets you issue a new virtual gift card or other stored-value card. The card is activated automatically, and some providers automatically preload the newly issued card with a certain amount.

Transaction per provider and channel

Issue a new card

To request a new gift card or other stored-value card:

• Make a POST request to the /issue endpoint, specifying:

  • merchantAccount: Name of the merchant account that you want to process the transaction with.
  • store: Optional For transactions flagged as in-store, the ID of the physical store that you want to process the transaction for. Maximum length: 16 characters.
  • paymentMethod.type: Name or brand of the card. Accepted values: givex, svs and valuelink. Do not use any other paymentMethod fields.
  • amount: The currency and value of the funds the card needs to be issued with. Optional for Givex gift cards. Must be greater than zero for SVS. Do not use for other cards.
  • giftCardPromoCode: Promotional code of the gift card. Required for Fiserv (formerly ValueLink) gift cards. Do not use for other cards.
  • reference: Your reference to uniquely identify this transaction. To provide multiple references for a transaction, separate them with hyphens ("-"). Maximum length: 80 characters.

  This request issues a new virtual Givex gift card with a value of 10 EUR:

  {
      "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
      "store": "YOUR_STORE_ID",
      "paymentMethod": {
          "type": "givex"
      },
      "amount": {
          "currency": "EUR",
          "value": 1000
      },
      "reference": "YOUR_REFERENCE"
  }

  This request issues a new virtual Fiserv (formerly ValueLink) gift card:

  {
      "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
      "store": "YOUR_STORE_ID",
      "paymentMethod": {
          "type": "valuelink"
      },
      "giftCardPromoCode": "1324",
      "reference": "YOUR_REFERENCE"
  }

Response

You receive a response containing:

• currentBalance: The currency and value of the funds stored on the card.
• pspReference: Adyen's 16-character unique reference associated with the transaction.
• resultCode: Indicates the state of the request. Refer to Result codes for the values that you can receive.
• paymentMethod.number: Card number that identifies the newly issued card.
• paymentMethod.type: Name or brand of the card you issued.

The response may include additional fields, depending on the Additional data settings for your merchant account. In your Customer Area, you'll find these settings under Developers > Additional data settings.

Sample response for a newly issued SVS gift card:

{
    "currentBalance": {
        "currency": "EUR",
        "value": 1000
    },
    "pspReference": "851564651069192J",
    "resultCode": "Success",
    "paymentMethod": {
        "number": "7219627091701347",
        "securityCode": "0140",
        "type": "givex"
    }
}

Next steps

See also