Merchant Take-on Process

Below is a step-b-step process on how to onboard and configure a merchant on the iVeri Administration Website.


User Group Capture


Login: Using the URL link https://admin.host.iveri.com for the iVeri Admin Website and login credentials that have been created & e-mailed to the user.


From your homepage, navigate to: ‘Merchant Profile’ > select ‘Create’.


1. Under the ‘General information’ tab, you would capture the details of the Merchant.

Note: All the Yellow fields are mandatory and would need to be captured.


2. Send Email Notifications:

If this tab is ticked the BackOffice credentials and other notifications will automatically be sent to the Contact persons’ e-mail address.


Leave this unticked should you not want the merchant to receive e-mail notifications.


3. Distributor:

Ensure that the Distributor is (which is set to the bank’s name i.e., FNB) is set.


4. Aggregators:


Aggregators facilitate payment processing for merchants, acting as intermediaries. Acquiring banks settle payments to the aggregator, who subsequently settles funds to their associated merchants. If the merchant belongs to an aggregator, users can select the appropriate aggregator from the dropdown menu. Should the merchant not belong to an aggregator this, step must be skipped and left to the default value.



5. Scroll down to capture the Address of the Merchant.

Note: For compliance purposes, it is important that the physical and postal address of the Merchant is accurately captured in the provided fields.


Once the user has captured the address of the Merchant, click on the ‘Create’ tab.


This will now generate the iVeri Merchant Group ID number which will display on the screen, make note of it.


6. The ‘Adding integrator’ field should be left unchanged. 

Should the merchant be processing through an integrator/Payment service provider, the below steps should then be followed:



Adding an Integrator:


Navigation Path: Merchant Profile > Update > General.



Click on the ‘Add integrators’ tab to access the list of integrators.


The default integrator that needs to be selected is ‘iVeri’.


Once you have selected ‘iVeri’ click on ‘Ok’. 


To ensure the changes are effected, click on the ‘Update’ tab.


Applications > Create


Under ‘Merchant information’ you would be able to view the details you have captured. The Merchant Profile ID has also been successfully generated at this point.


This screen will automatically appear.


Navigation Path to this screen:

Applications > Create.


The Yellow fields are mandatory to capture.


1. Application:


Please select the applicable Product Type ID from the dropdown. For this example, we have selected DiVert as the Product Type ID.


2. Let us have a look at some of the mandatory fields that need to be captured under Application:


  • Default Provider – The default provider is ‘FNBBase24 FNB South Africa’.
  • Providers – Ensure that this is ticked at all times.
  • Suspend application if inactive – If ticked, a merchant’s application will be suspended if in active for excess of 90 days. If unticked, the application will remain active indefinitely.
  • Send Email notifications – It is recommended that this field is ticked. If there any updates to the application, the merchant will be notified.
  • Technical Email – Update an e-mail address that you would like to receive notifications for should any changes be made to a Merchants application.

    Description – Refers to the reference description you would like to use as an identifier for the application created.


3. Application Parameters:

The Yellow fields are mandatory fields that would need to be captured.


Capture the Merchants name.

Merchant Country

Merchant City


4. Merchant Category:

From the dropdown, please select the correct trade for the Merchant you are onboarding.


Note: The Merchant Category must be captured correctly for the Merchant and must reflect their specific trade.



5. Complete the FNB BICISO details as per below:

Terminal ID:


This is a mandatory field that needs to be captured and is Acquirer dependent. The acquirer captures a Terminal ID if the acquirer has a Terminal ID.


If the merchant belongs to an aggregator, then the acquirer would need to obtain the terminal id from the aggregator. Dummy values can be also supplied, in the event the acquirer has no terminal ID’s. The terminal must be 8 characters in length.


Terminal (AN.8) in this example is 11111111


Card Acceptor ID:


This is a mandatory field that needs to be captured and is Acquirer dependent. The card acceptor id’s maximum length is 15 characters in length. The character length of each card acceptor id is dependent on the Acquirer.



Card Acceptor ID/Merchant ID (N.15) in this example is 12345678


Lastly, before clicking on the create tab, please ensure that the details captured for the merchant is correct. Once you have done your checks, click on the ‘Create tab’.



Email Notifications


An automated system generated e-mail will be sent as confirmation for the application that was created for the Merchant.

The e-mail confirms:


  • Merchant Profile / User Group ID
  • Live and Test Application IDs
  • Product Type
  • Confirmation of the Technical e-mail address captured.
  • Application Description as captured on the application you have created.



Note: Once the user has clicked on the ‘Create’ tab the BackOffice Services screen will appear.

From this screen you will note the Merchant Profile / User Group ID.

The Merchant Profile / User Group ID is especially important when logging a query. This must be provided at all times.

The Merchant Profile / User Group ID will also reflect on your daily report you receive.