Versions Compared

Old Version 1

changes.mady.by.user Arshad Saidoo

Saved on

compared with

New Version 2

changes.mady.by.user Arshad Saidoo

Saved on

Key

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

No-show service, used to complete a reservation when the customer does not attend his reservation. Usually, No-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 with Manual Entry.

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 - Quasi cash

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 - General

Name

Tag

Format

Usage

Name

Tag

Format

Usage

Transaction Channel

0xDFBF60

u8; 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

 

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

 

Expand
titleAccptrAuthstnReq

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:caaa.001.001.06">
  <AccptrAuthstnReq>
    <Hdr>
      <MsgFctn>AUTQ</MsgFctn>
      <PrtcolVrsn>6.0</PrtcolVrsn>
      <XchgId>10</XchgId>
      <CreDtTm>2022-01-24T10:27:51.000+00:00</CreDtTm>
      <InitgPty>
        <Id>Amadis</Id>
      </InitgPty>
      <RcptPty>
        <Id>Amadis</Id>
      </RcptPty>
    </Hdr>
    <AuthstnReq>
      <Envt>
        <Acqrr>
          <Id>
            <Id>10009287351</Id>
          </Id>
          <ParamsVrsn>2022-01-20 17:34:10</ParamsVrsn>
        </Acqrr>
        <Mrchnt>
          <Id>
            <Id>00000NEXOMER001</Id>
          </Id>
          <CmonNm>AMADIS 1111 Saint-Urbain Montréal</CmonNm>
        </Mrchnt>
        <POI>
          <Id>
            <Id>ASA00001</Id>
          </Id>
          <Cpblties>
            <CardRdngCpblties>PHYS</CardRdngCpblties>
            <CardRdngCpblties>MGST</CardRdngCpblties>
            <CardRdngCpblties>CICC</CardRdngCpblties>
            <CardRdngCpblties>ECTL</CardRdngCpblties>
            <CrdhldrVrfctnCpblties>FCPN</CrdhldrVrfctnCpblties>
            <CrdhldrVrfctnCpblties>MNSG</CrdhldrVrfctnCpblties>
            <ApprvlCdLngth>6</ApprvlCdLngth>
            <OnLineCpblties>SMON</OnLineCpblties>
            <MsgCpblties>
              <Dstn>CRCP</Dstn>
              <Dstn>MDSP</Dstn>
              <Dstn>MRCP</Dstn>
              <AvlblLang>en</AvlblLang>
              <AvlblLang>fr</AvlblLang>
              <AvlblLang>it</AvlblLang>
            </MsgCpblties>
          </Cpblties>
          <Cmpnt>
            <Tp>TERM</Tp>
            <Id>
              <PrvdrId>samsung</PrvdrId>
              <Id>SM-G950U</Id>
              <SrlNb>ArkosPay DEMOSN00</SrlNb>
            </Id>
            <Sts />
          </Cmpnt>
          <Cmpnt>
            <Tp>APLI</Tp>
            <Id>
              <PrvdrId>AMADIS</PrvdrId>
              <Id>ARKOS</Id>
            </Id>
            <Sts>
              <VrsnNb>3.0.6-dev-softpos</VrsnNb>
            </Sts>
          </Cmpnt>
        </POI>
        <Card>
          <PlainCardData>
            <PAN>5113407285151213</PAN>
            <XpryDt>2030-32</XpryDt>
          </PlainCardData>
          <IssrBIN>51134072</IssrBIN>
          <CardPdctPrfl>04</CardPdctPrfl>
          <CardBrnd>Carte a Piste</CardBrnd>
          <IntrnlCard>false</IntrnlCard>
        </Card>
        <Crdhldr>
          <Lang>en</Lang>
          <TxVrfctnRslt>
            <Mtd>PPSG</Mtd>
          </TxVrfctnRslt>
        </Crdhldr>
      </Envt>
      <Cntxt>
        <PmtCntxt>
          <CardPres>false</CardPres>
          <CrdhldrPres>false</CrdhldrPres>
          <AttndncCntxt>ATTD</AttndncCntxt>
          <CardDataNtryMd>PHYS</CardDataNtryMd>
        </PmtCntxt>
      </Cntxt>
      <Tx>
        <TxCaptr>false</TxCaptr>
        <TxTp>CRDP</TxTp>
        <AddtlSvc>NRES</AddtlSvc>
        <MrchntCtgyCd>5555</MrchntCtgyCd>
        <TxId>
          <TxDtTm>2022-01-24T10:27:51.000+00:00</TxDtTm>
          <TxRef>00000008</TxRef>
        </TxId>
        <RcncltnId>7</RcncltnId>
        <TxDtls>
          <Ccy>EUR</Ccy>
          <TtlAmt>5.00</TtlAmt>
          <AmtQlfr>ACTL</AmtQlfr>
          <OnLineRsn>TRMF</OnLineRsn>
        </TxDtls>
      </Tx>
    </AuthstnReq>
  </AccptrAuthstnReq>
</Document>

 

Expand
titleAccptrAuthstnRspn

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:caaa.002.001.06">
  <AccptrAuthstnRspn>
    <Hdr>
      <MsgFctn>AUTP</MsgFctn>
      <PrtcolVrsn>6.0</PrtcolVrsn>
      <XchgId>10</XchgId>
      <CreDtTm>2022-01-24T15:28:24.016+00:00</CreDtTm>
      <InitgPty>
        <Id>Amadis</Id>
      </InitgPty>
      <RcptPty>
        <Id>Amadis</Id>
      </RcptPty>
    </Hdr>
    <AuthstnRspn>
      <Envt>
        <POIId>
          <Id>ASA00001</Id>
        </POIId>
      </Envt>
      <Tx>
        <TxId>
          <TxDtTm>2022-01-24T10:27:51.000+00:00</TxDtTm>
          <TxRef>00000008</TxRef>
        </TxId>
        <RcptTxId>000000000000</RcptTxId>
        <TxDtls>
          <Ccy>EUR</Ccy>
          <TtlAmt>5.00</TtlAmt>
          <ICCRltdData>ioECMDA=</ICCRltdData>
        </TxDtls>
      </Tx>
      <TxRspn>
        <AuthstnRslt>
          <RspnToAuthstn>
            <Rspn>APPR</Rspn>
          </RspnToAuthstn>
          <AuthstnCd>001743</AuthstnCd>
        </AuthstnRslt>
      </TxRspn>
    </AuthstnRspn>
  </AccptrAuthstnRspn>
</Document>

 

Expand
titleAccptrCmpltnAdvc

Code Block
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:caaa.003.001.06">
  <AccptrCmpltnAdvc>
    <Hdr>
      <MsgFctn>FCMV</MsgFctn>
      <PrtcolVrsn>6.0</PrtcolVrsn>
      <XchgId>11</XchgId>
      <CreDtTm>2022-01-24T10:57:32.000-05:00</CreDtTm>
      <InitgPty>
        <Id>Amadis</Id>
      </InitgPty>
      <RcptPty>
        <Id>Amadis</Id>
      </RcptPty>
    </Hdr>
    <CmpltnAdvc>
      <Envt>
        <Acqrr>
          <Id>
            <Id>10009287351</Id>
          </Id>
          <ParamsVrsn>2022-01-20 17:34:10</ParamsVrsn>
        </Acqrr>
        <Mrchnt>
          <Id>
            <Id>00000NEXOMER001</Id>
          </Id>
          <CmonNm>AMADIS 1111 Saint-Urbain Montréal</CmonNm>
        </Mrchnt>
        <POI>
          <Id>
            <Id>ASA00001</Id>
          </Id>
          <Cpblties>
            <CardRdngCpblties>PHYS</CardRdngCpblties>
            <CardRdngCpblties>MGST</CardRdngCpblties>
            <CardRdngCpblties>CICC</CardRdngCpblties>
            <CardRdngCpblties>ECTL</CardRdngCpblties>
            <CrdhldrVrfctnCpblties>FCPN</CrdhldrVrfctnCpblties>
            <CrdhldrVrfctnCpblties>MNSG</CrdhldrVrfctnCpblties>
            <ApprvlCdLngth>6</ApprvlCdLngth>
            <OnLineCpblties>SMON</OnLineCpblties>
            <MsgCpblties>
              <Dstn>CRCP</Dstn>
              <Dstn>MDSP</Dstn>
              <Dstn>MRCP</Dstn>
              <AvlblLang>en</AvlblLang>
              <AvlblLang>fr</AvlblLang>
              <AvlblLang>it</AvlblLang>
            </MsgCpblties>
          </Cpblties>
          <Cmpnt>
            <Tp>TERM</Tp>
            <Id>
              <PrvdrId>samsung</PrvdrId>
              <Id>SM-G950U</Id>
              <SrlNb>ArkosPay DEMOSN00</SrlNb>
            </Id>
            <Sts />
          </Cmpnt>
          <Cmpnt>
            <Tp>APLI</Tp>
            <Id>
              <PrvdrId>AMADIS</PrvdrId>
              <Id>ARKOS</Id>
            </Id>
            <Sts>
              <VrsnNb>3.0.6-dev-softpos</VrsnNb>
            </Sts>
          </Cmpnt>
        </POI>
        <Card>
          <PlainCardData>
            <PAN>5113407285151213</PAN>
            <XpryDt>2030-32</XpryDt>
          </PlainCardData>
          <IssrBIN>51134072</IssrBIN>
          <CardPdctPrfl>04</CardPdctPrfl>
          <CardBrnd>Carte a Piste</CardBrnd>
        </Card>
      </Envt>
      <Cntxt>
        <PmtCntxt>
          <CardPres>false</CardPres>
          <CrdhldrPres>false</CrdhldrPres>
          <OnLineCntxt>true</OnLineCntxt>
          <AttndncCntxt>ATTD</AttndncCntxt>
          <CardDataNtryMd>PHYS</CardDataNtryMd>
        </PmtCntxt>
      </Cntxt>
      <Tx>
        <TxCaptr>true</TxCaptr>
        <TxTp>CRDP</TxTp>
        <AddtlSvc>NRES</AddtlSvc>
        <MrchntCtgyCd>5555</MrchntCtgyCd>
        <TxId>
          <TxDtTm>2022-01-24T10:27:51.000-05:00</TxDtTm>
          <TxRef>00000008</TxRef>
        </TxId>
        <TxSucss>true</TxSucss>
        <Rvsl>false</Rvsl>
        <MrchntOvrrd>false</MrchntOvrrd>
        <RcptTxId>000000000000</RcptTxId>
        <RcncltnId>7</RcncltnId>
        <TxDtls>
          <Ccy>EUR</Ccy>
          <TtlAmt>5.00</TtlAmt>
          <AmtQlfr>ACTL</AmtQlfr>
          <AuthrsdAmt>5.00</AuthrsdAmt>
        </TxDtls>
        <AuthstnRslt>
          <RspnToAuthstn>
            <Rspn>APPR</Rspn>
          </RspnToAuthstn>
          <AuthstnCd>001743</AuthstnCd>
        </AuthstnRslt>
        <TxVrfctnRslt>
          <Mtd>PPSG</Mtd>
        </TxVrfctnRslt>
      </Tx>
    </CmpltnAdvc>
  </AccptrCmpltnAdvc>
</Document>

 

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>


Initiate a No-Show with Reference Entry. //Todo