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
*
*
*
*
Gateway Release Notes *
**
The release notes contained in this document will be applied on the Hosted Gateway and Nedbank Gateway Notes
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
Batch is a payment solution that allows for bulk payment uploads using the iVeri system. It enables a merchant to create and process large volume, card not present transactions.
Batch requires merchants to create a file in a specific format and to upload It securely to the iVeri Payment Gateway for processing. Alternatively, merchants can also use the Create Batch function to manually create batches for uploading and processing. iVeri automatically creates the batch in the required format.
Batches are uniquely identified and can be set up to be processed on a date in the future. This is ideal for month ends that fall on a weekend or a public holiday.
Batch merchants are able to return to iVeri Back Office and view the status of their batch once it has been processed.
* Shopping Carts *
**
iVeri Lite plug-in is available for download for the following Shopping Cart platforms:
WooCommerce: https://www.iveri.co.za/docs/woocommerce-6 [1]
OpenCart:
https://www.iveri.co.za/docs/opencart-14 [2]
VirtueMart:
https://www.iveri.co.za/docs/virtuemart-15 [3]
[1] https://www.iveri.co.za/docs/woocommerce-6
[2] /docs/opencart-14
[3] https://www.iveri.co.za/docs/virtuemart-15
Download File – By Application *
**
Purpose: *
*– To download a processed file for a selected Application ID e.g., Live or Test or if you have more than one Live Application ID you can select the particular Application ID you wish to download. These could also be for the purposes of reusing the file for another entry.
Action: *
From the main menu the user will navigate to: Batch - Download File - By Application.*
Action: *
The user will select the applicable Application ID for which you want to download the file i.e., Either Live or Test.
Action: *
Choose the date that the file was created/uploaded in
the range above by manually changing the default dates above or clicking on the
calendar icon next to each date and select each date in the calendar that is
displayed. Then click on Search
Authorisation Header *
**
When interfacing with the Gateway endpoints, merchants
can include the AuthenticationKey and AuthenticationToken in the headers for
both transaction status queries and transaction submissions.
Headers **
AuthenticationKey*
The key consists of the username. The key and username must be in lowercase
The Username must be encoded to base64 i.e bWVyY2hhbnRwcm9maWxlPTYxNjk1NA
AuthenticationToken*
The token consists of:
AuthenticationSecret *
This is the secret key generated by the merchant
within Backoffice, which the merchant has to store on the merchant’s system.Once the secret is generated, it remains readable in
plain text for a couple of minutes, after which it is hashed. Merchant must copy the secret immediately
after the secret is generated.
If the merchant lose
*Configure Application*
**
* Purpose *- To receive e-mail confirmations after processing successful transactions and to set-up your transaction viewing preferences, you will now need to set up your choice of transaction configuration.
* Action: *
On the main menu go to Lite – Configure Application.
* Action: *
Click on the Application you want to configure, i.e., either the Test or the Live. Make the relevant changes and click on Submit
Below are some of the details a user would need to configure under Application settings:
E-mail confirmations can be sent to a cardholder. Confirm the E-mail address confirmations are sent to and from. Customise the message on the payment page. Customise the message on payment request e-mail. Copy or Link Merchants Terms and Conditions Show Associated Logo
Download File – By File *
**
Purpose *– To download a selected file by a specific file name.
Action: *
From the main menu, the user will navigate to: Batch - Download File - By File.*
Action: *
Select the date range that the file was created/uploaded by manually changing the default dates above or clicking on the calendar icon next to each date and select each date in the calendar that is displayed.
Then click on Search. The result of your search will then be displayed.
Action: *
Select the filename of the file you want to download. The following page will be displayed. Your selected file is displayed for you to download. Click on "Download". Select the file format you wish to obtain from the drop down (either the default Fixed File Text format or XML) and then click on Download.
You can n
/ Sale/Purchase /*
*
Context *
Parameter *
Debit with Track2 *
Debit with TransactionIndex *
Credit with Track2 *
Credit with TransactionIndex *
Void *
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 *
*
*
*
Common
ExipiryDate
M *
M *
*
*
*
Common
Currency
M *
M *
*
*
*
Common
MerchantReference
M *
M *
*
*
*
Common
MerchantTrace
O *
O *
*
*
*
Common
BudgetPeriod
O *
O *
*
*
*
Common
OriginalMerchantTrace
*
*
*
*
*
Common
Track2
M *
C *
*
*
*
Common
PANMode
M *
C *
*
*
*
Common
Terminal
M *
C *
*
*
*
Common
AccountType
M *
C *
*
*
*
POS
CashAmount
O *
O *
*
*
*
POS
DeviceFirmware
O *
O *
*
*
*
POS
DeviceFirmwareVe