special_tender_request

The special_tender_request contains the following data elements:

Field	Type	Description
`ped`	void	if not specified the PED object will be automatically populated.
`merchant_account`	char	The merchant account processing this transaction. Transactions can be performed with any of the merchant accounts that were returned when registering the POS.
`transaction_type`	ADYTransactionType	Type of gift card transaction (Redeem, which uses a card balance to pay for an item, Load, which loads a balance to a card, and Balance Inquiry which returns the current balance of the card). `transaction_type` takes the following values: redeem load balanceInquiry
`reference`	char	A merchant-supplied reference for the transaction.
`terminal_id`	char	The `terminal_id` of the PED.
`amount_currency`	char	Currency of the transaction (ISO 4217).
`amount_value`	long	Amount of the transaction in minor currency units.
`payment_method_type`	char	Payment method used for the transaction, such as a gift card, Alipay etc.For Gift Cards: Pass givex for a Givex card. Pass svs for a SVS card. For Alipay and WeChat Pay: Pass alipay for an Alipay transaction. Pass wechatpay_pos for WeChat Pay transaction.
`options`	void	Special options are dictionary key value pairs. This information is passed directly to the PED, which interprets it.Activate, load, or refund a balance to a card by creating a special tender and passing the following values as the `loadType` in special options: activate - Activates a gift card. load - Adds a balance to a gift card. merchandise_return - Add a refund balance back on to a gift card. This uses the same functionally as a load but is separated for accounting purposes. The activate and load values can be piped to chain the tasks by passing "activate\|load". Perform a cash back or deactivate a card by creating a special tender and passing a `redemptionType` as a special option. 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".
`handle_receipt`	boolean	Specifies that the POS handles and prints receipts. If omitted, it is required that the PED prints the receipt. If there is no printer unit, the transaction will fail.
`additional_data`	additional_data_struct	Contains key/value pairs that can be used by the merchant to return specific additional data, in particular in the final transaction result.