Processing a Token Refund

This section describes how to process a token refund. A token refund transaction enables you to process a stand-alone credit against a tokenized card. In order to process a credit through a token, you must have the Token Management Service product enabled and an existing (saved) token from a tokenized transaction. For more information, see

Token Management Service

Follow these steps to process a token refund:

Create a

TransactionParameters

object and provide the required information for the payment.

Create an

accountParameters

object and set the

instrumentIdentifierID

from the original transaction’s metadata as the

shopperAccountIdentifier

Retrieve the

transactionIntent

from the

mposUi

object and use the

startActivity

method to initiate the transaction flow.

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

val accountParameters = AccountParameters.Builder().token().cybersource().shopperAccountIdentifier("instrumentIdentifierID").build();

val transactionIntent = mposUi.createTransactionIntent(transactionParameters, null, accountParameters)
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