MTMS Configuration
1.1. Configuring entities
To configure the MTMS for the Versus integration, the following entities need to be created.
- the destination country (Senegal),
- a processing bank for Senegal,
- a delivery bank with one (any) branch
- two mobile network operators (OFMS, WAVESN)
Sample JSON File
{
"banks": [
{
"BNK_ID": "VERSUS",
"IBFT": "Versus Bank"
}
],
"collection_points": [
{
"third_party_id": "VERSUS",
"name": "Versus CP",
"bank": "VERSUS"
}
],
"mobile_network_operators": [
{
"third_party_id": "VERSUS",
"name": "OFMS",
"min": 5.00,
"max": 200000.00
},
{
"third_party_id": "VERSUS",
"name": "WAVESN",
"min": 5.00,
"max": 200000.00
}
]
}
1.2. Create Web Service user
A web service user needs to be created for the processing bank.
To do so, connect as admin in ARM, go to Admin menu → Web Service Users and click on Add Web Service User. Give all the permissions. Make sure to make a note of the username and password we need this to update Middleware system
1.3. Update state machine configurations
To update all the Versus transactions to HQ_OK, add a record to custom/config/config_state_machine.json under modify_state_machine
{
"modify_state_machine": {
"BANKS_TO_HQOK": [
"VERSUS-"
]
}
}
1.4. Update System settings
Please make sure following options to be enabled/true.
Middleware Configuration
From the Middleware the steps are as follows:
Middleware Setup
2.1. Create a client connected to the MTMS system
To create a new client, you have to log into the middleware, go to the Clients menu from the sidebar, click on "Add Client" and fill the fields in. The URL is the URL of the MTMS system to pull the transactions from.
2.2 Create an association between the client and the integration, and set the correct values for the configuration parameters
Go to the Client Integrations menu from the sidebar then click on Add Client Integrations.
On the next screen, select the Client and Integration.
Afterward, set the right values in the textareas: Client Auth Configs will host the information relative to the web service user that will connect to the MTMS system, Integration Configs will have the parameters to export the transactions to Versus.
{
"auth": {
"login": "XXXX",
"password": "XXX"
}
}
Set the processing bank prefix/code (as specified in the MTMS) and tick the enabled checkbox to activate the association.
To finish, click the Create button on the top right corner.
If the cron jobs are running automatically, transactions pulled from the MTMS will be visible in the Transactions menu.
This includes the ARM, ORM and RWS.
for any overrides. If you change anything in point 1 and it doesn't reflect on the apps/ORM then you will need to change it here as well.
. "Country Name-Destination" for the ARM , "ORM-Country Name-Destination" for the the ORM/apps. "Country Name" for the source country. "Country Name" will be the exact spelling you use for said country in the Destination/Source country list.