--- title: "card_operation_request" url: "https://docs.adyen.com/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/structs/card_operation_request" source_url: "https://docs.adyen.com/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/structs/card_operation_request.md" canonical: "https://docs.adyen.com/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/structs/card_operation_request" last_modified: "2026-05-24T12:54:31+02:00" language: "en" --- # card\_operation\_request [View source](/point-of-sale/classic-library-deprecation/classic-library-integrations/c-library-integration/structs/card_operation_request.md) The `card_operation_request` contains the following data elements: | Field | Type | Required | Description | | --------------------- | ------------------------ | ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `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. | | `terminal_id` | char | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | The `terminal_id` of the PED. | | `tender_reference` | char | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | A reference to the tender provided by the PED. | | `card_type`  | char | ![-x-](/user/data/smileys/emoji/x.png "-x-") | The type of gift card. | | `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. | | `additional_data_obj` | additional\_data\_struct | ![-x-](/user/data/smileys/emoji/x.png "-x-") | Contains key/value pairs that can be used by the merchant to return specific additional data, in particular in the final transaction result.For gift cards, the `stored_value_redemption_type` additional data key is used for cashback, gratuity and card deactivation.- **cashback - **Cash out the value of a gift card. For SVS, you must create a zero-value transaction to cash out the entire balance of a card. You can not cash out a specific amount. - **deactivate **(not available for SVS) - Deactivates a gift card. - **gratuity **(SVS cards only) - Used to provide a tip from a gift card. The cashback and deactivate values can be piped to chain the tasks by passing  "**cashback\|deactivate**". |