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

What’s Next