On This Page

Mail Order or Telephone Order Pre-Authorization

This section describes how to process a mail order or telephone order (MOTO) pre-authorization request for an initial amount. The payment card is not physically tapped, inserted, or swiped in the terminal for a MOTO transaction.

A MOTO pre-authorization request places a temporary hold on the customer's payment card, which can be captured at a later time. Most authorizations expire in 5 to 7 days. The issuing bank sets the length of time before expiration. When an authorization expires with the issuing bank, your bank or processor might require you to re-submit an authorization request and include a request for capture in the same message.

Follow these steps to process a MOTO pre-authorization:

Create a

TransactionParameters

object and provide the required information for the payment.

Retrieve the

transactionIntent

from the

mposUi

object and use the

startActivity

method to initiate the transaction flow.

val transactionParameters = TransactionParameters.Builder()
            .charge(BigDecimal("1.00"), Currency.EUR)    
            .customIdentifier("yourReferenceForTheTransaction")
            .workflow(new WorkflowConfiguration.Builder()
                  .moto()
                  // Set to false to toggle CVV as optional
                  .cvvRequired(true)
                  // Set to false to toggle address as optional
                  .addressRequired(true)
                  // Set to true to show transaction review screen
                  .reviewRequired(false)
                  .autoCapture(false)
            .build()

val transactionIntent = mposUi.createTransactionIntent(transactionParameters)
startActivityForResult(transactionIntent, MposUi.REQUEST_CODE_PAYMENT)

After the transaction is completed and the Summary screen is dismissed,

onActivityResult

is triggered. This action returns information about the last transaction.

Override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) 
{
    super.onActivityResult(requestCode, resultCode, data)
 
    if (requestCode == MposUi.REQUEST_CODE_PAYMENT) {
        when (resultCode) {
            // Result code from a successful transaction
            MposUi.RESULT_CODE_APPROVED -> {
               val transactionIdentifier = data?.getStringExtra(MposUi.RESULT_EXTRA_TRANSACTION_IDENTIFIER)
               Toast.makeText(findViewById(android.R.id.content),"Transaction approved!\nIdentifier: $transactionIdentifier", Toast.LENGTH_LONG).show()
            }
            // Result code from a declined, aborted or failed transaction
            MposUi.RESULT_CODE_FAILED -> {
               Toast.makeText(findViewById(android.R.id.content), "Transaction was declined, aborted, or failed", Toast.LENGTH_LONG).show()
            }
        }
    }
}

You can get the full transaction object by retrieving the

latestTransaction

from the mposUi object.

val transactionObject = mposUi.latestTransaction