Page Comparison

Info
See Cancellation Service on the Amadis Wiki for more information about the Cancellation Service.

– To be completed --

Below is an example derived from a cancellation of an original transaction(payment).

Code Block

PaymentResult result;
result = arkos.doPayment(arkosConfig.AsBytes(), paymentParams.AsBytes()); //In your payment function
paymentParams.AddAscii(ArkosTags.ReferenceData,result.trxReference); //In your cancellation function

Below is an example derived from a cancellation of an original transaction(payment).

Code Block

PaymentResult result;
result = arkos.doPayment(arkosConfig.AsBytes(), paymentParams.AsBytes()); //In your payment function
paymentParams.AddAscii(ArkosTags.ReferenceData,result.trxReference); //In your cancellation function

Below is an example derived from a cancellation of an original transaction(payment).

Code Block

 paymentParamspublic static PaymentParams createReversal(String trxReference) {
        PaymentParams params = new PaymentParams(PaymentServiceID.Cancellation);
        
        //Date //Time //Timezone of current transaction // cancellation in our case
        Calendar cal = Calendar.getInstance();
        int utcOffsetMinutes = cal.getTimeZone().getOffset(cal.getTimeInMillis()) / 1000 / 60;
        byte[] utcOffset = new byte[2];
        utcOffset[0] = (byte) (utcOffsetMinutes / 60);
        utcOffset[1] = (byte) (utcOffsetMinutes % 60);
        params.paramTree.AddEMVDate(ArkosTags.TransactionDate, cal.get(Calendar.YEAR) % 100, cal.get(Calendar.MONTH) + 1, cal.get(Calendar.DAY_OF_MONTH));
        params.paramTree.AddEMVTime(ArkosTags.TransactionTime, cal.get(Calendar.HOUR_OF_DAY), cal.get(Calendar.MINUTE), cal.get(Calendar.SECOND));
        params.paramTree.AddBin(ArkosTags.LocalTimezone, utcOffset);
        
        params .AddBin(ArkosTags.TransactionAmount, new byte[] { 0x00, 0x00, 0x00, 0x00, 0x200x00, 0x00 });
        params paymentParams.AddBin(ArkosTags.AmountAuthorised, new byte[] { 0x00, 0x00, 0x00, 0x00, 0x200x00, 0x00 });
 paymentParams       params .AddBin(ArkosTags.TransactionAmountBeforeAdjustment, new byte[] { 0x00, 0x00, 0x00, 0x00, 0x200x00, 0x00 });
        
        //Language of current transaction
        params.paramTree.AddAscii(ArkosTags.SelectedLanguage, "en");
        
        //Date //Time //Timezone of original transaction
        TlvTree originalTransaction = paymentParamsparams.AddChild(ArkosTags.OriginalTransaction);
        originalTransaction.AddEMVDate(ArkosTags.TransactionDate, cal.get(Calendar.YEAR) % 100, cal.get(Calendar.MONTH) + 1, cal.get(Calendar.DAY_OF_MONTH));
        originalTransaction.AddEMVTime(ArkosTags.TransactionTime, cal.get(Calendar.HOUR_OF_DAY), cal.get(Calendar.MINUTE), cal.get(Calendar.SECOND));
        originalTransaction.paramTree.AddBin(ArkosTags.LocalTimezone, utcOffset);
        
        originalTransaction.AddAscii(ArkosTags.ReferenceData,"1234567890" trxReference);
        originalTransaction.AddEnum(ArkosTags.SelectedService, PaymentServiceID.Payment);
        
      
        return params;
    }

It is to be noted that, upon carrying out a cancellation/reversal, the transaction reference is now set under the TlvTree Original Transaction.

It is mandatory to include the original transaction date, time, and service( which will always be payment and will later be overridden by the value we get from the batch for the corresponding transaction reference number).

Code Block

  originalTransaction.AddEMVDate(ArkosTags.TransactionDate, cal.get(Calendar.YEAR) % 100, cal.get(Calendar.MONTH) + 1, cal.get(Calendar.DAY_OF_MONTH));
  originalTransaction.AddEMVTime(ArkosTags.TransactionTime, cal.get(Calendar.HOUR), cal.get(Calendar.MINUTE), cal.get(Calendar.SECOND));
 paymentParams originalTransaction.AddAsciiAddEnum(ArkosTags.ReferenceData,SelectedService, PaymentServiceID.Payment);

trxReference = "1234567890"

...

in our example.

Versions Compared

Old Version 5

New Version Current

Key