--- title: "Check the balance of a gift card" description: "View the value of a gift card or other stored-value card." url: "https://docs.adyen.com/payment-methods/gift-cards/stored-value-api/check-balance" source_url: "https://docs.adyen.com/payment-methods/gift-cards/stored-value-api/check-balance.md" canonical: "https://docs.adyen.com/payment-methods/gift-cards/stored-value-api/check-balance" last_modified: "2026-05-26T13:48:55+02:00" language: "en" --- # Check the balance of a gift card View the value of a gift card or other stored-value card. [View source](/payment-methods/gift-cards/stored-value-api/check-balance.md) The `/checkBalance` endpoint of our [Stored Value API](/payment-methods/gift-cards/stored-value-api) lets you view the remaining balance on a gift card or other type of stored-value card. ### Transaction per provider and channel #### Online | Transaction | Givex | SVS | Fiserv (formerly ValueLink) | Intersolve | | ------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | Check balance | ![-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 | | ------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | Check balance | ![-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-") | ## Check the balance When you view the balance remaining on 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 see the value of a gift card or other stored-value card that has not been tokenized: * Make a POST request to the [`/checkBalance` endpoint](/payment-methods/gift-cards/stored-value-api#sv-api-endpoints), 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` object with: * `type`: Name or brand of the card. Accepted values: **givex** (only for in-person payments), **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 checks the balance on an SVS gift card: ```json { "merchantAccount": "ADYEN_MERCHANT_ACCOUNT", "store":"YOUR_STORE_ID", "paymentMethod": { "type": "svs", "number": "603628672882001915092", "securityCode": "5754" }, "reference": "YOUR_REFERENCE" } ``` #### Response You receive a response containing: * `currentBalance`: The `currency` and total `value` in minor units 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. Refer to [Result codes](/payment-methods/gift-cards/stored-value-api#result-codes) for the values that you can receive. Sample response: ```json { "currentBalance": { "currency": "EUR", "value": 5600 }, "pspReference": "881564657480267D", "resultCode": "Success" } ``` ### Tab: With token To see the value of a gift card or other stored-value card that has been tokenized: * Make a POST request to the [`checkBalance` endpoint](/payment-methods/gift-cards/stored-value-api#sv-api-endpoints), 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: **givex** (only for in-person payments), **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 checks the balance on a tokenized Fiserv (formerly ValueLink) gift card: ```json { "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` in minor units 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. Refer to [Result codes](/payment-methods/gift-cards/stored-value-api#result-codes) for the values that you can receive. Sample response: ```json { "currentBalance": { "currency": "EUR", "value": 5600 }, "pspReference": "881564657480267D", "resultCode": "Success" } ``` ## Next steps ###### [Load](/payment-methods/gift-cards/stored-value-api/load) [Add funds to a gift card.](/payment-methods/gift-cards/stored-value-api/load) ###### [Merge balance](/payment-methods/gift-cards/stored-value-api/merge-balance) [Transfer the value from one gift card to another.](/payment-methods/gift-cards/stored-value-api/merge-balance) ###### [Issue](/payment-methods/gift-cards/stored-value-api/issue) [Issue a new gift card.](/payment-methods/gift-cards/stored-value-api/issue) ## See also * [Activate or deactivate a gift card](/payment-methods/gift-cards/stored-value-api/change-status) * [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)