Receiving callback notifications

This document will detail how callback notifications are received for MNO Web Opt-In Kenya.

GET /yourdomain/

Receive notifications from our gateway to your configured endpoint.

Example of successful subscription

http://hostname/?action=subscribed&trixid=5cf60043-a8bb-4571-925e-57688e05fe36&user=277123456789&keyword=mv-1000000000001&service=60001

Example of successful billing

http://yourdomain/?action=billing&trixid=5cf60043-a8bb-4571-925e-57688e05fe36&user=277123456789&keyword=mv-1000000000001&service=60001&amount=2000

Body

Parameter	Type	Example	Description
keyword	string	mv-1000000000001	Your unique Mobivate product id.
trixid	string	5cf60043-a8bb-4571-925e-57688e05fe36	Your unqiuely generated trixID for this transaction.
orig_keyword	string	secured	The method of the keyword you are using.
msisdn	integer	XX0000000000	The users hashed MSISDN.
service	integer	60001	Your unique shortcode.
campaign_name	string	MyCampaign	Your chosen campaign name.
campaign_id	string	79000000000000abc000000000000000	Your unique campaign id.
cost	integer	2000	Cost of the message.

Output

{
 "KEYWORD": "mv-1000000000001",
 "TRIXID": "5cf60043-a8bb-4571-925e-57688e05fe36",
 "ORIG_KEYWORD": "secured",
 "msisdn": "XX0000000000",
 "service": "60001",
 "campaign_name": "MyCampaign",
 "campaign_id": "79000000000000abc000000000000000",
 "cost": "2000"
}

To see a full list of all available parameters for your callbacks. Please press CMD + M on your keyboard while on the Campaign configuration screen.

Please note: Our return URL parameters and notifications are configurable. You can read more about this in our Campaign Configuration section.