Point-of-sale icon

special_tender_request

The special_tender_request contains the following data elements:

FieldTypeRequiredDescription

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.

transaction_type

ADYTransactionType

-white_check_mark-

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

-white_check_mark-

A merchant-supplied reference for the transaction.

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.

payment_method_type

char

-white_check_mark-

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

-white_check_mark-

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

-x-

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

-x-

Contains key/value pairs that can be used by the merchant to return specific additional data, in particular in the final transaction result.