On This Page

Token Refund

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

Use this information to process a token refund. This transaction enables you to process a stand-alone credit for a tokenized card.

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

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

Get the full transaction object by retrieving the

latestTransaction

from the mposUi object.

val transactionObject = mposUi.latestTransaction