||PED object that represents the terminal.|
Create a special tender request
Use this method to create a request object to hold the special tender details. Instantiates an
Adding Parameters to a SpecialTenderRequest
The transaction reference provided by the Merchant (reported in the Adyen payments platform).
The transaction amount in minor units (100 is 1.00 with EUR). The Amount field should be a strong typed field with a string for currency code and a number (long) for the minor digits value (similar to the current API (of the terminal)).
|long||The transaction currency.|
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).
The type of payment method, in this case gift cards. For example, Givex, SVS, EagleEye.
Holds tender attributes.
Activate, load, or refund a balance to a card by creating a special tender and passing the following values as the
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
The cashback and deactivate values can be piped to chain the tasks by passing "cashback|deactivate".
|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.|
Add special options parameters to the
SpecialTenderRequest using the
Remove parameters from the
SpecialTenderRequest using the
The scanned number from the gift card. If this number:
The entry mode for the transaction.
You can select from two entry modes:
Not all languages using COM handle empty parameters equally. This has the potential to cause unexpected behavior. To prevent this, provide empty strings or pass
Null objects for C++/C#, and the default value
Nothing for vb.net.
specialTenderRequest.SpecialOptions.Add("cardNumber", "60362821657200117610") specialTenderRequest.SpecialOptions.Add("cardNumber.expiryMonth", "12") specialTenderRequest.SpecialOptions.Add("cardNumber.expiryYear", "2049")
Create a special tender
Use this method to create a special tender and pass the
The gift card can be presented in three ways:
- Swipe: The gift card is read through a magnetic stripe.
- MKE on terminal: The card number is manually entered on the payment terminal. The tender should specify that it expects keyed entry on the terminal, and a card mask should be provided.
- MKE on cash register: Scan a barcode on the back of the card from the cash register application (POS). In this scenario, the card number, card mask and expiry should be provided in special options.
You can specify entry modes by passing special tender options. See Gift Cards.
|Reports the progress of a running tender.|
|Returns the receipt for printing, and requests that the POS confirms it has received the receipt.|
When the system finishes processing the tender, it triggers the final state callback.