Start Transaction
StartTransaction
Parameters startTransaction(Parameters)
Call startTransaction()
to initiate a transaction. This can be used to start a Sale, Refund or Account Verification transaction. The request accepts various parameters including amount, transaction type, unique reference, whether to enable/disable gratuity and currency.
When the startTransaction()
method is successful, asynchronous updates are provided in the following callbacks; transactionUpdate
, userNotification
, applicationSelection
, signatureVerification
, and transactionFinished
.
Transaction POI - Tap To Mobile
Using the ParameterKeys.TransactionPOI parameter allows you to dictate whether the transaction is run on an external device or as a Tap To Mobile transaction.
When a single POI is Configured (either PaymentDevice or TapToMobile), it will be automatically selected when starting a transaction.
When both payment types are configured the payment device will be used by default unless the TransactionPOI parameter explicitly specifies Tap To Mobile.
Please note that Tap To Mobile transactions are currently online only as an auto confirmed sale. Therefore the following is not supported when running a Tap To Mobile Transaction:
-
TransactionType
Refund
AccountVerification
-
DelayOnlineProcessing
TRUE
-
PANKeyEntry
TRUE
-
TippingType
OnDeviceTipping
EndOfDayTipping
BothTipping
-
AutoConfirm
FALSE
Tipping however is supported when running a Tap to Pay Transaction, and is passed into StartTransaction with the parameter
TipAmount
. To enable it contact your account manager.
Updated 3 days ago