MTMS Configuration
1.1. Configuring entities
To configure the MTMS for the WHISH integration, the following entities need to be created.
WHISH is based in Lebanon and make sure you setup the destination countries and necessary MTMS setup if that is not available. See PayOnlime test or production for more details.
- the available destination countries,
- a processing bank for each country. When making Proc Bank, make sure to check process unprocessed cash collection transaction option if proc bank required to import cash collection transaction.
- a delivery bank with one (any) branch for each country
- A collection point connecting to delivery bank
- Mobile network operator for the delivery bank
Supported Transfer Types
- Cash Collection
- Mobile Transfer
1.2. 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 WHISH transactions to HQ_OK, add a record to custom/config/config_state_machine.json under modify_state_machine
{
"modify_state_machine": {
"BANKS_TO_HQOK": [
"WHISH-"
]
}
}
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 integration with the parameters to configure as template
To create an integration, go to the Integrations menu from the sidebar then click on Add Integration. Copy the snippet below in the textarea then click on Create:
{
"key": "XXXX",
"username": "XXXX"
}
2.3. 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 WHISH.
Set the name of the processing bank (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.
