Card Validity Check Service processing used to check for validity of cards, is similar to Payment Service processing. It doesn’t require a different Transaction Type. But it doesn’t allow a supplementary amount or cashback.
When carrying out a card validity service transaction, it is important to note that there should not be any amount entered as the transaction amount is set to zero in the nexoFast pre-Processing function.
The Transaction Amount can also be set to Card Validity Check Default Amount if retrieved from the Application Profile after Application Selection. Card Validity Check shall be always authorized online.
Below is the Tag to modify if you wish to have a default amount instead of using the transaction Amount in Pre-Processing (0$).
Â
Name
Tag
Table
Length
Format
presence
Name
Tag
Table
Length
Format
presence
Card Validity Check Default Amount
DF58
E6
6
n12
Optional
Â
Initiate a Card validity check
// Minimal parameter set
TlvTree paymentParams = TlvTree.Empty();
params.paramTree.AddEnum(ArkosTags.SelectedService, PaymentServiceID.CardValidityCheck);
// 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 - Card validity check
Name
Tag
Format
Usage
Name
Tag
Format
Usage
Selected Service
CE
u8; 1
12: Card Validity Check
Identification of the payment service requested
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
Â
Â
Â
Â
Â
Â
This value will be present in nexo acquirer message if present.