Search docs

Are you looking for test card numbers?

Would you like to contact support?

Start searching Adyen's documentation...



The create_tender_request contains the following data elements:

Field Type Required Description
ped void -white_check_mark-

if not specified the PED object will be automatically populated.

merchant_account char -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.




An enum of type TRANSACTION_TYPES. For a sale transaction, it must have the value GOODS_SERVICES.

reference char -white_check_mark-

A reference for this request. Allows the merchant to identify the transaction.

order_reference char -white_check_mark- Adyen order reference, used to reference an earlier transaction. It must refer to the psp_reference of an earlier existing transaction, unless the transaction fails.
terminal_id char -white_check_mark-

The terminal_id of the PED.

amount_currency char -white_check_mark- Currency of the transaction (ISO 4217).
amount_value long -white_check_mark- Amount of the transaction in minor currency units.
gratuity_amount_currency char -x-

Tender gratuity currency (if applicable). Should match the tender currency.

gratuity_amount_value long -x- Tender gratuity amount, if applicable, in minor units (100 is 1.00 EUR).
shopper_email char -x- For digital shopper recognition, provide a shopper reference and/or a shopper email address. See also the additional data callback. If the additional data callback indicates that there is currently no shopper email registered for this customer, the shopper can be asked for his email address as part of the payment process.
shopper_reference char -x- Records the shopper reference with the transaction and to set up recurring or one-click functionality.
recurring_contract char -x-

The recurring contract specification.

recurring_contract_detail_name char -x-

The recurring contract detail name.


tender_options_struct -white_check_mark-

An enum of type TENDER_OPTIONS. For a list of tender options, see Tender Options.




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.

Perform a cash back or deactivate a card by passing a stored value redemption type in additional data. 

  • 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 - Deactivates a gift card.  (Deactivate is not available for SVS).
  • gratuity - Used to provide a tip from a gift card. (For SVS cards only).
The cashback and deactivate values can be piped to chain the tasks by passing  "cashback|deactivate".