Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Info

See No-

...

Show Service on Amadis Wiki for more information about the Refund Service.

No-Show service, used to complete a reservation when the customer does not attend his reservation. Usually, No-show Show is the penalty/fine that the customer pays for not showing up.

No-Show Service processing is similar to Payment Service processing. It doesn’t require a different Transaction Type. But it does not allow a supplementary amount or cashback and it may only be performed either with REFERENCE ENTRY or with MANUAL ENTRY. In particular, REFERENCE ENTRY or MANUAL ENTRY is a necessary Service Start Events for No-Show. The No-Show Service must be authorized online.

Initiate a No-Show

...

Expand
titleBelow is an example of how to initiate a no-show of 10.00 using manual entry.
Code Block
// Minimal parameter set
TlvTree paymentParams = TlvTree.Empty();

paymentParams.AddEnum(ArkosTags.SelectedService, PaymentServiceID.NoShow);
// Amounts are in BCD. In most cases, all 3 amounts should be the same value.
paymentParams.AddBin(ArkosTags.TransactionAmount, new byte[] { 0x00, 0x00, 0x00, 0x00, 0x10, 0x00 });
paymentParams.AddBin(ArkosTags.AmountAuthorised, new byte[] { 0x00, 0x00, 0x00, 0x00, 0x10, 0x00 });
paymentParams.AddBin(ArkosTags.TransactionAmountBeforeAdjustment, new byte[] { 0x00, 0x00, 0x00, 0x00, 0x10, 0x00 });

// The system needs to provide the Date and Time of this transaction, and the local TimeZone
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);
paymentParams.AddEMVDate(ArkosTags.TransactionDate, cal.get(Calendar.YEAR) % 100, cal.get(Calendar.MONTH) + 1, cal.get(Calendar.DAY_OF_MONTH));
paymentParams.AddEMVTime(ArkosTags.TransactionTime, cal.get(Calendar.HOUR), cal.get(Calendar.MINUTE), cal.get(Calendar.SECOND));
paymentParams.AddBin(ArkosTags.LocalTimezone, utcOffset);

paymentParams.AddAscii(ArkosTags.SelectedLanguage, "en");

// Call to the doPayment API, sending the Arkos configuration, and parameters as a byte Array
PaymentResult result = arkos.doPayment(configuration, paymentParams.AsBytes());

Data Parameters

Required -

...

No Show

Name

Tag

Format

Usage

Selected Service

CE

u8; 1

13: Noshow

Identification of the payment service requested

Transaction Amount

D5

BCD; 12
fixed exponent (2)

Amount of the transaction

Authorised Amount

9F02

BCD; 12
fixed exponent (2)

 

Transaction Amount Before Adjustment

DFFF47

BCD; 12
fixed exponent (2)

 

Transaction Time

9F21

BCD; 6
HMS, two nibbles per element
Ex: [0x16, 0x17, 0x27] (16:17:27)

Time at which the current action is performed

Transaction Date

9A

BCD; 6
YMD, two nibbles per element
Ex: [0x20, 0x08, 0x16] (2020-aug-16)

Date at which the current action is performed

Local Time Zone

DF9F3F

i8; 2
Hour and minute offset, one byte each
Ex: [-5, 0]

Local Timezone in which the current action is performed

Selected Language

CD

ASCII; 2
Ex: "en"

 

Optional -

...

Name

...

Tag

...

Format

...

No-Show (for REFERENCE ENTRY)

Name

Tag

Format

Usage

Transaction

Channel

Reference

0xDFBF60

FFFF3E.DF37

u8

ASCII;

1 Expand
titlePossible Values

This value will be present in nexo acquirer message if present.

 

Reference ISO20022_MDRPart2_CAPE_caaa_2016_2017_v1, section 2.4.2.2.1.5 TransactionChannel

n
Ex: "0000000012"

Required to start No Show service using REFERENCE ENTRY. If absent No Show will be performed using MANUAL ENTRY

Original Service

FFFF3E.CE

u8; 1

4: PreAuth

If Transaction reference is present Original Tx. Service must be Reservation (PreAuth)

 

No-show is always performed online. Below are the following exchanges:

...

Expand
titleAccptrCmpltnAdvcRspn

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:caaa.004.001.06">
  <AccptrCmpltnAdvcRspn>
    <Hdr>
      <MsgFctn>CMPK</MsgFctn>
      <PrtcolVrsn>6.0</PrtcolVrsn>
      <XchgId>11</XchgId>
      <CreDtTm>2022-01-24T15:57:35.907+00:00</CreDtTm>
      <InitgPty>
        <Id>Amadis</Id>
      </InitgPty>
      <RcptPty>
        <Id>Amadis</Id>
      </RcptPty>
    </Hdr>
    <CmpltnAdvcRspn>
      <Envt>
        <AcqrrId>
          <Id>10009287351</Id>
        </AcqrrId>
        <MrchntId>
          <Id>00000NEXOMER001</Id>
        </MrchntId>
        <POIId>
          <Id>ASA00001</Id>
        </POIId>
      </Envt>
      <Tx>
        <TxId>
          <TxDtTm>2022-01-24T10:27:51.000-05:00</TxDtTm>
          <TxRef>00000008</TxRef>
        </TxId>
        <Rspn>APPR</Rspn>
      </Tx>
    </CmpltnAdvcRspn>
  </AccptrCmpltnAdvcRspn>
</Document>

...