Search

Are you looking for test card numbers?

Would you like to contact support?

Payment-method icon

Issue a new gift card

Learn how to issue a new gift card or other stored-value card.

With an /issue call to our Stored Value API, you can issue a new gift card or other type of stored-value card. Some providers automatically preload the newly issued card with a certain amount.

The newly issued card will be a virtual gift card that is activated automatically.

Support

Not all transactions are applicable for all providers and channels.

You can't issue plastic gift cards with this call.

Web channel

Transaction Givex SVS ValueLink
Issue new -x- -white_check_mark- -white_check_mark-

POS channel

Transaction Givex SVS ValueLink
Issue new -x- -x- -x-

Issue a new card

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

  • Make a POST request to the https://pal-test.adyen.com/pal/servlet/StoredValue/v46/issue endpoint, specifying:

    • merchantAccount: ID 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: svs and valuelink. Do not use any other paymentMethod fields.
    • giftCardPromoCode: Conditional Promotional code for a ValueLink gift card. 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 SVS gift card:

    {
        "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
        "store": "YOUR_STORE_ID",
        "paymentMethod": {
            "type": "svs"
        },
        "reference": "YOUR_REFERENCE" 
    }

    This request issues a new 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 the Customer Area, you'll find these settings under Account > API URLs.

Sample response for a newly issued SVS gift card:

{
    "currentBalance": {
        "currency": "EUR",
        "value": 0
    },
    "pspReference": "851564651069192J",
    "resultCode": "Success",
    "paymentMethod": {
        "number": "6006491286999921374",
        "type": "svs"
    }
}

Next steps

See also