Search

Are you looking for test card numbers?

Would you like to contact support?

Payment-method icon

Stored Value API for managing gift cards

Use our Stored Value API to manage gift cards and other stored-value cards.

Here we describe how you can manage both online and point-of-sale gift cards and other stored-value cards with our JSON-only Stored Value API. This API lets you do the following transactions:

  • Issue: Issue a new gift card or other stored value card.
  • Change status: Activate or deactivate a card.
  • Load: Add funds to the balance of the card.
  • Check balance: Query the remaining balance of the card.
  • Merge balance: Transfer all funds from a card to another one from the same provider.
  • Void transaction: Undo a Stored Value API transaction from the last 24 hours.

With a point-of-sale integration, you may prefer to do the above transactions using our Terminal API because you already use that to make in-store gift card payments.

Not for payments

The Stored Value API doesn't let you make, cancel, or refund payments. For these transactions, refer to the following table:

Transaction Integration type
Make a gift card payment Online: Web component or API-only Point of sale
Cancel a gift card payment Online Point of sale
Make a refund to a gift card Online Point of sale

Supported cards

The Stored Value API currently supports:

  • Gift cards provided by Givex
  • Gift cards provided by SVS
  • Gift cards provided by ValueLink

Transactions per provider and channel

Whether a Stored Value API transaction is allowed, depends on the provider and the channel. Here is an overview:

Online

Transaction Givex SVS ValueLink
Issue new -white_check_mark- -white_check_mark- -white_check_mark-
Activate -x- -x- -x-
Activate and load amount -x- -x- -x-
Deactivate (without amount) -white_check_mark- -x- -x-
Load amount -white_check_mark- -white_check_mark- -white_check_mark-
Check balance -white_check_mark- -white_check_mark- -white_check_mark-
Merge balance -x- -x- -white_check_mark-
Void (undo) other transaction -white_check_mark- -white_check_mark- -white_check_mark-

Point of sale

Transaction Givex SVS ValueLink
Issue new -x- -x- -x-
Activate -white_check_mark- -white_check_mark- -white_check_mark-
Activate and load amount -white_check_mark- -white_check_mark- -white_check_mark-
Deactivate (without amount) -white_check_mark- -x- -x-
Load amount -white_check_mark- -white_check_mark- -white_check_mark-
Check balance -white_check_mark- -white_check_mark- -white_check_mark-
Merge balance -x- -x- -x-
Void (undo) other transaction -white_check_mark- -white_check_mark- -white_check_mark-

Endpoints

Test https://pal-test.adyen.com/pal/servlet/StoredValue/v46/method
Live https://pal-live.adyen.com/pal/servlet/StoredValue/v46/method

The /method can be:

Result codes

These are the result codes you can receive from the Stored Value API.

  • Success: The operation has been completed successfully.
  • Refused: The operation was refused. The reason is given in the refusalReason field.
  • Error: There was an error when the operation was processed. The reason is given in the refusalReason field.
  • NotEnoughBalance: The amount on the gift card or other stored-value card is lower than the amount given in the request.

Testing and going live

  1. Before going live, use the following data to test Stored Value API transactions using the Adyen simulator:

    Type Number Security code Expiry month and year Optional
    Givex gift card 603628672882001915092 5754 12 2020
    SVS gift card 6006491286999921374 1111 12 2020
    ValueLink gift card 7777182708544835 2329 12 2049

    Enter any value when the simulator asks for a ValueLink promo code.

  2. Apart from testing with our simulator, you should do end-to-end testing. Ask the provider of the gift card or other stored-value card for the test data you can use.

  3. When you are ready to move to live, switch from test to live endpoints.

Next steps

See also