Search

Are you looking for test card numbers?

Would you like to contact support?

Payment-method icon

Load funds to a gift card

Add an amount to a gift card or other stored-value card.

The /load endpoint of our Stored Value API lets you add funds to a gift card or other type of stored-value card. These funds are available to the shopper if the card has been activated. Virtual cards are activated automatically when you issue them. But for physical cards, it is necessary that you also activate them.

Not for refunds

Because the /load transaction is not related to a payment, you can't use it to make a refund. Refer to:

Transaction Link
Make a refund to a gift card Online Point of sale

Transaction per provider and channel

Online

Transaction Givex SVS ValueLink Intersolve
Load amount -white_check_mark- -white_check_mark- -white_check_mark- -white_check_mark-

Point of sale

Transaction Givex SVS ValueLink Intersolve
Load amount -white_check_mark- -white_check_mark- -white_check_mark- -white_check_mark-

Load an amount

When you add funds to a gift card or other stored-value card, the way to specify the card details depends on whether you tokenized a payment that the shopper made with this card.

To add funds to a gift card or other stored-value card that has not been tokenized:

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

    • amount: The currency and value of the funds you want to store on the card. The supported currencies differ per provider.
    • loadType: If not specified, defaults to load. Specify merchandiseReturn if the amount to add comes from goods that the shopper returned.
    • 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 object with:

      • type: Name or brand of the card. Accepted values: givex, svs, valuelink, any Intersolve supported card type.
      • number: Card number that identifies the card.
      • securityCode: If the card has a PIN code or other type of security code, obtain it from the shopper and provide it here.
      • expiryMonth: Optional Expiry month of the card.
      • expiryYear: Optional Expiry year of the card.
      • holderName: Optional Name of the shopper that the card belongs to.

    • reference: Your reference to uniquely identify the transaction. To provide multiple references for a transaction, separate them with hyphens ("-"). Maximum length: 80 characters.

    This request refunds 20 USD to an SVS gift card because the shopper returned goods to the store:

    {
        "amount": {
            "currency": "USD",
            "value": 2000
        },
        "loadType": "merchandiseReturn",
        "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
        "store":"YOUR_STORE_ID",
        "paymentMethod": {
            "type": "svs",
            "number": "6006491286999921374",
            "securityCode": "1111"
        },
        "reference": "YOUR_REFERENCE"
    }

Response

You receive a response containing:

  • currentBalance: The currency and total value of the funds stored on the card.
  • pspReference: Adyen's 16-character unique reference associated with the request.
  • resultCode: Indicates the state of the request. Success means the amount has been added. Refer to Result codes for the values that you can receive.

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 Account > API URLs > Additional data settings.

This response shows that after adding 20 USD, the SVS gift card now has a balance of 30 USD:

{
    "currentBalance": {
        "currency": "USD",
        "value": 30000
    },
    "pspReference": "851564654294247B",
    "resultCode": "Success"
}

To add funds to a gift card or other stored-value card that you tokenized:

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

    • amount: The currency and value of the funds you want to store on the card. The supported currencies differ per provider.
    • loadType: If not specified, defaults to load. Specify merchandiseReturn if the amount to add comes from goods that the shopper returned.
    • 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, valuelink, any Intersolve supported card type.
    • recurringDetailReference: The token that identifies the card. This was returned in the response when you tokenized the card.
    • shopperReference: Your unique ID for this shopper. This is the shopperReference that you used when you created the token.
    • shopperInteraction: Specifies the sales channel through which the shopper provided their details. Accepted values: Ecommerce (default for online transactions), ContAuth (online, using previously stored details), Moto (via email or telephone) or POS (using an in-store terminal).
    • reference: Your reference to uniquely identify the transaction. To provide multiple references for a transaction, separate them with hyphens ("-"). Maximum length: 80 characters.

    This request adds 25 EUR to a tokenized ValueLink gift card:

    {
        "amount": {
            "currency": "EUR",
            "value": 2500
        },
        "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
        "paymentMethod": {
            "type": "valuelink"
        },
        "recurringDetailReference": "7219687191761347",
        "shopperReference": "YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j",
        "shopperInteraction": "Ecommerce",
        "reference": "YOUR_REFERENCE"
    }

Response

You receive a response containing:

  • currentBalance: The currency and total value of the funds stored on the card.
  • pspReference: Adyen's 16-character unique reference associated with the request.
  • resultCode: Indicates the state of the request. Success means the amount has been added. Refer to Result codes for the values that you can receive.

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 Account > API URLs > Additional data settings.

This response shows that after adding 25 EUR, the ValueLink gift card now has a balance of 40 EUR:

{
    "currentBalance": {
        "currency": "EUR",
        "value": 40000
    },
    "pspReference": "851564654294247B",
    "resultCode": "Success"
}

Next steps

See also