--- title: "load_request" url: "https://docs.adyen.com/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/structs/load_request" source_url: "https://docs.adyen.com/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/structs/load_request.md" canonical: "https://docs.adyen.com/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/structs/load_request" last_modified: "2026-05-23T12:56:20+02:00" language: "en" --- # load\_request [View source](/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/structs/load_request.md) ## Parameters | 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. | | `load_type`  | char | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Gift Card Providers allow for many types of loads to cards. For example, merchandising return loads are used to credit returns to a card. Pass the default value: **load**. For Givex cards pass either **load** for balance load, or **merchandise\_return** for refunds. `load_type` can take the following values:**activate** - Activates a gift card.****load**** - Loads a balance to a gift card****.**********merchandise\_return****** - Load a refund balance back on to a gift card. This uses the same functionally as a load but is separated for accounting purposes. | | `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` | String | ![-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` | Long | ![-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` | Long | ![-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` | char | ![-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` | int | ![-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` | int | ![-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. | | `amount_currency` | char | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The currency of the balance.  | | `amount_value` | long | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The value of the balance. | | `tender_options_obj` | [t](/point-of-sale/classic-library-deprecation/classic-library-integrations/com-extension-for-windows-integration/com-extension-for-windows-objects/tenderoption)tender\_options\_struct | ![-x-](/user/data/smileys/emoji/x.png "-x-") | An enum of type `TENDER_OPTIONS`. For a list of tender options, see [Tender Options](/point-of-sale/add-data/tender-options). | | `additional_data_obj` | additional\_data\_struct | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Register additional data with the transaction if necessary. number\_of\_additional\_data\_entries: defines the number of entries in the `additional_data` array. |