--- title: "Load funds to a gift card" description: "Add an amount to a gift card or other stored-value card." url: "https://docs.adyen.com/payment-methods/gift-cards/stored-value-api/load" source_url: "https://docs.adyen.com/payment-methods/gift-cards/stored-value-api/load.md" canonical: "https://docs.adyen.com/payment-methods/gift-cards/stored-value-api/load" last_modified: "2019-10-05T09:31:00+02:00" language: "en" --- # Load funds to a gift card Add an amount to a gift card or other stored-value card. [View source](/payment-methods/gift-cards/stored-value-api/load.md) The `/load` endpoint of our [Stored Value API](/payment-methods/gift-cards/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](/payment-methods/gift-cards/stored-value-api/change-status) them. ### Not for refunds Because the `/load` transaction is not related to a payment, you cannot use it to make a refund. Refer to: | Transaction | Link | | | ---------------------------- | --------------------------------- | ------------------------------------------------------------------------------ | | Make a refund to a gift card | [Online](/online-payments/refund) | [In-person payments](/point-of-sale/gift-cards-terminal-api/refund-gift-cards) | ### Transaction per provider and channel #### Online | Transaction | Givex | SVS | Fiserv (formerly ValueLink) | Intersolve | | ----------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | Load amount | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | #### In-person payments | Transaction | Givex | SVS | Fiserv (formerly ValueLink) | Intersolve | | ----------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | Load amount | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-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](/online-payments/tokenization) a payment that the shopper made with this card. ### Tab: Without token 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](/payment-methods/gift-cards/stored-value-api#sv-api-endpoints), 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](/payment-methods/gift-cards#supported-gift-cards)**. * `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 USD 20 to an SVS gift card because the shopper returned goods to the store: ```json { "amount": { "currency": "USD", "value": 2000 }, "loadType": "merchandiseReturn", "merchantAccount": "ADYEN_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](/payment-methods/gift-cards/stored-value-api#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](https://ca-test.adyen.com/), you'll find these settings under **Developers** > **Additional data**. This response shows that after adding USD 20, the SVS gift card now has a balance of USD 30: ```json { "currentBalance": { "currency": "USD", "value": 30000 }, "pspReference": "851564654294247B", "resultCode": "Success" } ``` ### Tab: With token To add funds to a gift card or other stored-value card that you tokenized: * Make a POST request to the [`/load` endpoint](/payment-methods/gift-cards/stored-value-api#sv-api-endpoints), 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](/payment-methods/gift-cards#supported-gift-cards)**. * `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 EUR 25 to a tokenized Fiserv (formerly ValueLink) gift card: ```json { "amount": { "currency": "EUR", "value": 2500 }, "merchantAccount": "ADYEN_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](/payment-methods/gift-cards/stored-value-api#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](https://ca-test.adyen.com/), you'll find these settings under **Developers** > **Additional data**. This response shows that after adding EUR 25, the Fiserv (formerly ValueLink) gift card now has a balance of EUR 40: ```json { "currentBalance": { "currency": "EUR", "value": 40000 }, "pspReference": "851564654294247B", "resultCode": "Success" } ``` ## Next steps ###### [Change status](/payment-methods/gift-cards/stored-value-api/change-status) [Activate or deactivate a gift card.](/payment-methods/gift-cards/stored-value-api/change-status) ###### [Check balance](/payment-methods/gift-cards/stored-value-api/check-balance) [Check the value stored on a gift card.](/payment-methods/gift-cards/stored-value-api/check-balance) ## See also * [Issue a new gift card](/payment-methods/gift-cards/stored-value-api/issue) * [Transfer the value from one gift card to another of the same type](/payment-methods/gift-cards/stored-value-api/merge-balance) * [Undo a previous Stored Value API transaction from the last 24 hours](/payment-methods/gift-cards/stored-value-api/void) * [Stored Value API](/payment-methods/gift-cards/stored-value-api)