--- title: "balance_inquiry_request" url: "https://docs.adyen.com/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/structs/balance_inquiry_request" source_url: "https://docs.adyen.com/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/structs/balance_inquiry_request.md" canonical: "https://docs.adyen.com/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/structs/balance_inquiry_request" last_modified: "2026-05-23T12:56:20+02:00" language: "en" --- # balance\_inquiry\_request [View source](/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/structs/balance_inquiry_request.md) | Name | Type | Required | Definition | | -------------------- | ----------------------- | ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `ped` | void | ![-x-](/user/data/smileys/emoji/x.png "-x-") | if not specified the PED object will be automatically populated | | `merchant_account` | char | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") |  The merchant account processing this transaction. Transactions can be performed with any of the merchant accounts that were returned when registering the POS.Use a merchant account that you provided during [app registration](/point-of-sale/classic-library-deprecation/classic-library-integrations/com-extension-for-windows-integration/key-steps-com-extension/register-the-application-with-adyen-com-extension).  | | `terminal_id` | char | ![-x-](/user/data/smileys/emoji/x.png "-x-") | The `terminal_id` of the PED. | | `card_type`  | char | ![-x-](/user/data/smileys/emoji/x.png "-x-") | The type of gift card.  | | `reference` | char | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | A reference for this request. Allows the merchant to identify the transaction. | | `card_number` | char | ![-x-](/user/data/smileys/emoji/x.png "-x-") | The gift card number.Use of this parameter depends on selection of the [Manual Keyed Entry](/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/extras-c-library/start-gift-card-transactions-c-library/manual-keyed-entry-and-passing-of-card-details-c-library) option. | | `expiry_month` | int | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Month of expiration.Use of this parameter depends on selection of the [Manual Keyed Entry](/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/extras-c-library/start-gift-card-transactions-c-library/manual-keyed-entry-and-passing-of-card-details-c-library) option. | | `expiry_year` | int | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Year of expiration.Use of this parameter depends on selection of the [Manual Keyed Entry](/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/extras-c-library/start-gift-card-transactions-c-library/manual-keyed-entry-and-passing-of-card-details-c-library) option. | | `card_mask` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | A mask to validate the correct number of digits to enter.Use of this parameter depends on selection of the [Manual Keyed Entry](/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/extras-c-library/start-gift-card-transactions-c-library/manual-keyed-entry-and-passing-of-card-details-c-library) option. | | `card_mask_min` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Minimum number of characters in the card mask.Use of this parameter depends on selection of the [Manual Keyed Entry](/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/extras-c-library/start-gift-card-transactions-c-library/manual-keyed-entry-and-passing-of-card-details-c-library) option. | | `card_mask_max` | String | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Maximum number of characters in the card mask.Use of this parameter depends on selection of the [Manual Keyed Entry](/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/extras-c-library/start-gift-card-transactions-c-library/manual-keyed-entry-and-passing-of-card-details-c-library) option. | | `tender_options_obj` | tender\_options\_struct | ![-x-](/user/data/smileys/emoji/x.png "-x-") |  Tender options define the behavior of the PED.An object that can have the following values:1) `ReceiptHandler` 2) `GetAdditionalData` 3) `Recurring` 4) `OneClick` 5) `BypassPin` 6) `AskGratuity` 7) `NoProcess` 8) `KeyedEntry` 9) `DontPrintReceipt` 10) `Error` 11) `ForcedOnline` 12) `ForcedDecline` 13) `EnableMagstripeFallback` 14) `NoCTLS` 15) `AllowPartialAuthorisation`number\_of\_additional\_data\_entries: defines the number of entries in the `additional_data` array.   |