Amadis

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Quasi Cash Service processing is similar to Payment Service processing but requires a different Transaction Type and does not allow a supplementary amount or cashback.

Quasi Cash shall be authorized online and 'No CVM Required' shall not be supported for Quasi Cash transactions.

Initiate a Quasicash

 Below is an example of how to initiate a quasicash of 10.00.
// Minimal parameter set
TlvTree paymentParams = TlvTree.Empty();

paymentParams.AddEnum(ArkosTags.SelectedService, PaymentServiceID.Quasicash);
// 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());

Quasicash is always performed online. Below are the following exchanges:

 AccptrAuthstnReq

<?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-17T06:45:44.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-13 16:59:42</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>Google</PrvdrId> <Id>sdk_gphone_x86_arm</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-stub</VrsnNb> </Sts> </Cmpnt> </POI> <Card> <PlainCardData> <PAN>5219610200140517</PAN> <XpryDt>2021-08</XpryDt> <SvcCd>121</SvcCd> <Trck2>5219610200140517=210812110000946</Trck2> </PlainCardData> <IssrBIN>52196102</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>true</CardPres> <CrdhldrPres>true</CrdhldrPres> <AttndncCntxt>ATTD</AttndncCntxt> <CardDataNtryMd>MGST</CardDataNtryMd> </PmtCntxt> </Cntxt> <Tx> <TxCaptr>false</TxCaptr> <TxTp>QUCH</TxTp> <MrchntCtgyCd>5555</MrchntCtgyCd> <TxId> <TxDtTm>2022-01-17T06:45:44.000+00:00</TxDtTm> <TxRef>00000005</TxRef> </TxId> <RcncltnId>3</RcncltnId> <TxDtls> <Ccy>EUR</Ccy> <TtlAmt>10.00</TtlAmt> <AmtQlfr>ACTL</AmtQlfr> <OnLineRsn>TRMF</OnLineRsn> </TxDtls> </Tx> </AuthstnReq> </AccptrAuthstnReq> </Document>

 AccptrAuthstnRspn

<?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-17T23:45:44.496+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-17T06:45:44.000+00:00</TxDtTm> <TxRef>00000005</TxRef> </TxId> <RcptTxId>000000000000</RcptTxId> <TxDtls> <Ccy>EUR</Ccy> <TtlAmt>10.00</TtlAmt> <ICCRltdData>ioECMDA=</ICCRltdData> </TxDtls> </Tx> <TxRspn> <AuthstnRslt> <RspnToAuthstn> <Rspn>APPR</Rspn> </RspnToAuthstn> <AuthstnCd>001734</AuthstnCd> </AuthstnRslt> </TxRspn> </AuthstnRspn> </AccptrAuthstnRspn> </Document>

 AccptrCmpltnAdvc

<?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-17T06:48:06.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-13 16:59:42</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>Google</PrvdrId> <Id>sdk_gphone_x86_arm</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-stub</VrsnNb> </Sts> </Cmpnt> </POI> <Card> <PlainCardData> <PAN>5219610200140517</PAN> <XpryDt>2021-08</XpryDt> <SvcCd>121</SvcCd> </PlainCardData> <IssrBIN>52196102</IssrBIN> <CardPdctPrfl>04</CardPdctPrfl> <CardBrnd>Carte a Piste</CardBrnd> </Card> </Envt> <Cntxt> <PmtCntxt> <CardPres>true</CardPres> <CrdhldrPres>true</CrdhldrPres> <OnLineCntxt>true</OnLineCntxt> <AttndncCntxt>ATTD</AttndncCntxt> <CardDataNtryMd>MGST</CardDataNtryMd> </PmtCntxt> </Cntxt> <Tx> <TxCaptr>true</TxCaptr> <TxTp>QUCH</TxTp> <MrchntCtgyCd>5555</MrchntCtgyCd> <TxId> <TxDtTm>2022-01-17T06:45:44.000-05:00</TxDtTm> <TxRef>00000005</TxRef> </TxId> <TxSucss>true</TxSucss> <Rvsl>false</Rvsl> <MrchntOvrrd>false</MrchntOvrrd> <RcptTxId>000000000000</RcptTxId> <RcncltnId>3</RcncltnId> <TxDtls> <Ccy>EUR</Ccy> <TtlAmt>10.00</TtlAmt> <AmtQlfr>ACTL</AmtQlfr> <AuthrsdAmt>10.00</AuthrsdAmt> </TxDtls> <AuthstnRslt> <RspnToAuthstn> <Rspn>APPR</Rspn> </RspnToAuthstn> <AuthstnCd>001734</AuthstnCd> </AuthstnRslt> <TxVrfctnRslt> <Mtd>PPSG</Mtd> </TxVrfctnRslt> </Tx> </CmpltnAdvc> </AccptrCmpltnAdvc> </Document>

 AccptrCmpltnAdvcRspn

<?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-17T23:48:04.464+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-17T06:45:44.000-05:00</TxDtTm> <TxRef>00000005</TxRef> </TxId> <Rspn>APPR</Rspn> </Tx> </CmpltnAdvcRspn> </AccptrCmpltnAdvcRspn> </Document>

  • No labels