MO Forwarding

Some businesses have the need to receive initial MO request for payment and to handle it somehow, for example, by generating personalized (dynamic) MT message. For those types of businesses Centili provides a special feature for this kind of intermediate notifications.

It is very simple MO Forward service, which forwards initial MO to you and expects from you to answer with MT message related with this payment. To use this feature you need to provide URL of specifically designed notification web service which is able to handle MO Forward request properly. The concept of MO Forward service is based on a simple Request/Response conversation.

MO Forward Request

Both GET and POST HTTP methods are available. Our request can also be in JSON format, but in that case it can be only for POST type of methods.

This is an example of request using GET method:

http://www.mocky.io/v2/51f2c5e664250c0f01f90c24?transactionid=1&phone=3816373417161&shortcode=2525&message=CENT+Something&mno=RS_TELENOR&callback=http%3A%2F%2Fapi.centili.com%2Ftransaction%2Merchant%2F1%2Fmt

Parameters to be sent in request:

Requests for POST method are the same. In that case, parameters (transactionid, shortcode, callback etc) will be in the body of the request. Request can also be in JSON format. Other formats (XML, etc.) are available on demand.

In this case, callback URL will be in the following format:

protocol//host/transaction/serviceKey/transactionId/mt

where:

• serviceKey - unique service identifier that will be given to you in advance
• transctionId - Our ID for this transaction. You will receive this ID in our MO Forward request.

For example:

http://api.centili.com/transaction/serviceKey/2562343/mt

📘

Note:

In case clientID parameter is sent to Centili platform via Payment Page or API, the value of that parameter will be included in MO Forward request as an addition to message parameter (message=message text + “ ” + clientid).

MO Forward Response - Synchronous

To use Response of MO Forward service you need to confirm that you successfully received MO notification, but also you can use it to pass text for MT message. MT text should be passed as plain text in the body of response. To confirm that notification is received it is necessary to use standard HTTP statuses:

👍

Success

In case of success status you can send MT message text in the body of response as a plain text.

❗️

Error

In case of error, you can use response body to send error description back to Centili.

MO Forward Response - Asynchronous

Same as in case of synchronous response on MO Forward request:

Next step...