Sale/Purchase *
*
*
M
Mandatory
O
Optional
C
Conditional
blank
not relevant
Context *
Parameter *
Debit with PAN *
Debit with TransactionIndex *
Void *
Credit with PAN *
Credit with TransactionIndex *
Core
ApplicationID
M *
M *
M *
M *
M *
Core
Category
M *
M *
M *
M *
M *
Core
CertificateID
M *
M *
M *
M *
M *
Core
Gateway
O *
O *
O *
O *
O *
Core
Command
M *
M *
M *
M *
M *
Core
Mode
M *
M *
M *
M *
M *
Common
Amount
M *
M *
*
M *
M *
Common
CardSecurityCode
O
O
O
O
Common
PAN
M
M
M
Common
Currency
M *
M *
*
M *
M *
Common
ExpiryDate
M *
M *
*
M *
M *
Common
MerchantReference
M *
M *
*
M *
M *
Common
OriginalMerchantReference
*
*
M *
*
*
Common
MerchantTrace
O *
O *
*
O *
O *
Common
OriginalRequestID
*
*
M *
*
*
Common
PANFormat
*
M *
*
*
M *
Common
TransactionIndex
*
M *
*
*
M *
Common
QR Code – MasterPass Parameters *
*
Context *
Parameter *
MasterPassQuickResponseCod *e *
MasterPassPaymentNotification *
Credit with TransactionIndex *
Void *
Core
ApplicationID
M *
M *
M *
M *
Core
Category
M *
M *
M *
M *
Core
CertificateID
M *
M *
M *
M *
Core
Gateway
O *
O *
O *
O *
Core
Command
M *
M *
M *
M *
Core
Mode
M *
M *
M *
M *
Common
Amount
*
*
*
*
Common
ExipiryDate
*
*
*
*
Common
Currency
*
*
*
*
Common
MerchantReference
*
*
*
*
MasterPass
MasterPassAction
M *
*
*
*
MasterPass
MasterPassMerchantID
M *
*
*
*
MasterPass
MasterPassShortDescription
*
*
*
*
MasterPass
MasterPassCodeExpiryDate
*
*
*
*
MasterPass
MasterPassMerchantName
*
*
*
*
MasterPass
MasterPassCode
*
*
*
*
MasterPasss
MasterPassTransactionID
*
*
*
*
View Batch *
**
Purpose * - To view the status of batches that have been uploaded for processing and view any errors / failed transactions in a completed batch.
Action: *
From the main menu, the user will navigate to: Batch - View Batch.*
Action: *
The user will select the applicable Application ID.
Action: *
The user will select the date range for the Batch they would like to view.
Action: *
The user will now be able to view the Batch for the selected date range. To view any errors within the Batch or applicable to a specific transaction, the user can click on the "Errors".
Data Types *
**
The following key table is used for data types:
Data Type *
Description *
A
Alpha only (A-Za-z)
AN
Alphanumeric (a-zA-Z0-9)
Base64
Base64 encryption of binary data
Boolean
True or False
Guid
Globally Unique
Identifier: {[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\}
(eg {8E51611F-E19A-4FF0-B229-6A69F42AAA62})
Hex
Hex (0-9A-Fa-f)
N
Numeric (Positive integer)
N.
Digits and dots (.) (e.g's
4242........4242, 1.0)
N:
Digits and colons
String
ANPS Free format string containing:
Alpha, numeric, special and padding (printable ASCII)
Z
Positive or negative integer
Node Type *
Set input parameter value *
Get output parameter value *
attribute
enterprise.setAttribute(..)
enterprise.getAttribute(..)
tag
enterprise.setTag(..)
enterprise.getTag(..)
parame
Airline addendum data
**
Airline addendum data is additional transaction data which appear on a card holder's statement when buying a ticket from an airline merchant who include this data in a transaction request. Airline addendum data is currently only available for Nedbank. In addition, the airline addendum data is currently only supported for follow-up debit (pre-authorised debit) transactions.
Coding for Airline addendum data *
The following is a code snippet in C#:
enterprise.openElement("AirlineData");
enterprise.setTag("PassengerName", passengerName);
enterprise.setTag("PrimaryTicketNumber", primaryTicketNumber);
enterprise.setTag("FirstDepartureLocationCode", firstDepartureLocationCode);
enterprise.setTag("FirstArrivalLocationCode", firstArrivalLocationCode);
enterprise.setTag("PNR
Authenticated Collections
**
Authenticated collections are intended to enable a merchant who wants to make regular direct debits to a customer’s account to authenticate the customer.
This has two benefits:
The merchant has proved that the customer has consented to these regular debits The customer has verified themselves by way of a pin validation so there is a higher level of comfort that the customer's account is a valid account and does belong to the customer.
Authenticated Collections is currently only available from Nedbank. In addition, the Authenticated Collections provider parameter must be enabled otherwise the transaction will be declined.
Coding for Authenticated Collection data
The following is a code snippet in C#:
enterprise.openElement("AuthenticatedCollectionData");
enterp
Additional Data for Procurement Transactions
**
Procurement transactions refer to transactions that contain the line item (or order basket) details. If the line-item details are sent to iVeri within a transaction, then a procurement card holder get those details from their issuing bank (for example on their monthly statement). This is of assistance in tracking business to business transactions particularly in large corporations. Procurement transactions are currently only available within distributor Nedbank.
Coding for Procurement *
The following optional input parameters are Procurement specific per transaction:
CustomerReferenceIdentifier CustomerVATRegistrationNumber DestinationCountry DestinationZIPCode NationalTax NationalTaxIndicator OrderDate PurchaseIdentifier ShipFromZIP
Fleet card transactions
**
Fleet cards facilitate the tracking of costs and managing statistical information of a fleet of vehicles.
A Fleet transaction refer to special processing for a Fleet card. Fleet transactions are currently only available within distributor Nedbank. If a fleet card is received with other distributors, then the fleet specific parameters are ignored. Coding for Fleetcards *
The following optional input parameters are Fleet specific per transaction:
CustomerReferenceIdentifier
The following optional input parameters are Fleet specific per Line item:
ProductCode Quantity QuantityDecimalPlaces UnitCost
The latest available values of the ProductCode field are obtained via the “Inventory” download command (See section 22). Only use the ProductCodes with Type='Fle
Advanced Fraud Screening
**
The following optional input parameters are CyberSource specific per Line item:
Discount ItemCommodityCode ItemDescriptor ProductCode Quantity TaxRate Total UnitCost UnitOfMeasure PassengerFirstName PassengerLastName PassengerID PassengerStatus PassangerType
Note: The fields in Blue will be used when doing Advanced Fraud Screening and is not recorded on the iVeri system. Since Line items are repeated, the advanced Enterprise methods openElement and closeElement must be used. The following is a code snippet in https://vb.net/
enterprise.setTag("ShippingTaxRate", shippingTaxRate)
enterprise.setTag("TransactionDiscount", transactionDiscount)
enterprise.setTag("UniqueVATInvoiceReferenceNumber", vatReferenceNo)
Dim dr As DataRow
For Each dr in myTable.Ro
Refund – “Initial Credit”
**
Allows the merchants to essentially “pay” or “credit” the cardholder without referencing any original or previously processed transaction
REST
SOAP
Request
{
"Version" : "2.0" ,
"CertificateID" : "{cf4b7e7a-4fec-43b4-a2cb-221263c0a34b}" ,
"ProductType" : "Enterprise" ,
"ProductVersion" : "WebAPI" ,
"Direction" : "Request" ,
"Transaction" : {
"ApplicationID" : "e7c523a4-7da7-4e59-b888-569fe65c535b" ,
"Command" : "Credit" ,
"Mode" : "TEST" ,
"MerchantReference" : "20211014_0129" ,
"MerchantTrace" : "NAHSI-1112" ,
"Currency" : "ZAR" ,
"Amount" : "1000" ,
"ExpiryDate" : "1025" ,
"PAN" : "4242424242424242"
}
}
< soap:Envelope xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd = "http://www.w3.org/2001/XMLSchema" xmlns:soap = "http://