Gateway Release Notes *
**
The release notes contained in this document will be applied on the Hosted Gateway and Nedbank Gateway Notes
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
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 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
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
* Application Parameters *
**
*/ Purpose /* – This function is used to allocate application ID(s) that a User is only allowed to have access to. This application refers to specific product and what a merchant uses to process transactions through iVeri.
Example below indicates that when you select a particular Application ID an Administrator can configure what functions can this user perform in a particular Application ID. If no function is associated to an Application ID, no access is granted to that user.
Administrator can configure what Transaction Types a user can perform on a specific Application ID.
If no Transaction Types are configured for a user, the user will be unable to process transactions for any of the Application IDs.
*/ Action /*:
Select the product and Live Application IDs
*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
/ 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
Customize
*Card Details Capture Layout*
**
* Purpose: *
From the ‘Customise Card details capture Layout page, the Administrator can customise the look and feel of the payment page.
This is a preview of the defaulted payment page that cardholders will see.
* Action: *
From the main menu the user will navigate to: *Lite - Configure Application.*
Action: *
Select the applicable application ID.
*
*
* Action: *
The user will select the 'Customise Card Details Capture Layout' tab.
Action: *
The user can upload the company logo to align with their company’s Corporate Identity. JPEG and PNG are the accepted file extensions.This can be done by clicking on the "Upload Logo" expansion button. The user will be able to access the assets from their PC and upload the file extension.
*Under 'Style', the u