On This Page

Process an Offline Sale

Use this information to process an offline sale. This transaction is also called a deferred authorization
or store-and-forward
transaction.

Offline sales can be performed only on terminals that have successfully processed at least one online transaction.

When internet connectivity is unavailable, an offline sale enables you to capture transaction details locally. These stored transactions must be submitted for authorization when connectivity is restored. For more information, see Submit an Offline Transactions Batch for Authorization.

Only process offline sales when required. The recommendation is to process online sale transactions whenever possible. For more information, see Sale.

Follow these steps to process an offline sale.

Create a

TransactionParameters

object and provide the required information for the payment.

Retrieve the

transactionIntent

variable from the

mposUi

object and use the

startActivity

method to initiate the transaction flow.

// Use this to configure the maximum amount per offline transaction and maximum amount for an offline batch.
// MposUI.offlineModule.offlineTransactionConfiguration = OfflineTransactionConfiguration(
//            maximumAmountPerTransaction = BigDecimal("100.00"),
//            maximumTotalAmountForBatch = BigDecimal("1000.00")
//        )


val transactionParameters = TransactionParameters.Builder()
            .charge(BigDecimal("1.00"), Currency.EUR)    
            .customIdentifier("yourReferenceForTheTransaction")
            .build()

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

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

onActivityResult

method 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()
            }
        }
    }
}