No momento, esta página não está disponível em português
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 (except issuing) using our Terminal API because you already use that to make in-person 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 In-person payments
Cancel a gift card payment Online In-person payments
Make a refund to a gift card Online In-person payments

Supported cards

The Stored Value API currently supports:

  • Gift cards provided by Givex
  • Gift cards provided by Intersolve (see our overview page for a selection of the gift cards that can go over this connection)
  • Gift cards provided by SVS
  • Gift cards provided by Fiserv (formerly 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

TransactionGivexSVSFiserv (formerly ValueLink)Intersolve
Issue new
See note
-white_check_mark--x--white_check_mark--x-
Activate-x--white_check_mark--x--x-
Activate and load amount-x--white_check_mark--x--x-
Deactivate (without amount)-white_check_mark--x--x--x-
Load amount-white_check_mark--white_check_mark--white_check_mark--white_check_mark-
Check balance-white_check_mark--white_check_mark--white_check_mark--white_check_mark-
Merge balance-x--x--white_check_mark--x-
Void (undo) other transaction-white_check_mark--white_check_mark--white_check_mark--white_check_mark-

In-person payments

TransactionGivexSVSFiserv (formerly ValueLink)Intersolve
Issue new
-x--x--x--x-
Activate-white_check_mark--white_check_mark--white_check_mark--white_check_mark-
Activate and load amount-white_check_mark--white_check_mark--white_check_mark--white_check_mark-
Deactivate (without amount)-white_check_mark--x--x--x-
Load amount-white_check_mark--white_check_mark--white_check_mark--white_check_mark-
Check balance-white_check_mark--white_check_mark--white_check_mark--white_check_mark-
Merge balance-x--x--x--x-
Void (undo) other transaction-white_check_mark--white_check_mark--white_check_mark--white_check_mark-

Issuing SVS gift cards
If you are building a new Stored Value API integration, issuing SVS gift cards is not supported.

If you have an existing Stored Value API integration and have issued SVS gift cards, you can continue doing so.

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
    Fiserv (formerly ValueLink) gift card 7777182708544835 2329 12 2049

    Enter any value when the simulator asks for a Fiserv (formerly 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