On This Page

Processing a Cashback

This section describes how to process a cashback transaction. This type of transaction enables a customer to request that a specified amount of cash be given to them as part of the transaction. A cashback transaction can be performed with or without a purchase.
Follow these steps to process a cashback:
  1. Create a
    TransactionParameters
     object and provide the required information for the payment.
  2. Retrieve the
    transactionIntent
     from the
    mposUi
     object and use the
    startActivity
     method to initiate the transaction flow.
    val transactionParameters = TransactionParameters.Builder()
            .charge(BigDecimal("30.00"), Currency.GBP)
            .withCashback(BigDecimal("10.00"))    
            .customIdentifier("yourReferenceForTheTransaction")
            .build()

val transactionIntent = mposUi.createTransactionIntent(transactionParameters)
startActivityForResult(transactionIntent, MposUi.REQUEST_CODE_PAYMENT)
  3. After the transaction is completed and the Summary screen is dismissed, the
    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()
            }
        }
    }
}
  4. You can get the full transaction object by retrieving the
    latestTransaction
     from the mposUi object.
    
 
    val transactionObject = mposUi.latestTransaction