---
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-06-01T15:33:15+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)
