Vodafone/Airtel Ghana Billing

Specific instructions when billing through Vodafone or Airtel Ghana.

GET /yourdomain

Vodafone Ghana and Airtel have recently changed the flow of their billing. They now handle all billing confirmation; meaning the flow starts when a billing request comes in.

Example

<Your DR endpoint>?ORIGINATOR=<Shortcode>&KEYWORD=<Keyword>&MESSAGE_TEXT=MNO+BILLED%3A+SILENT+BILLING+MESSAGE&CHANGED=False&VALUE=<Amount>&RCPT=2021-07-28T02%3A02%3A56.811855&RESULT=1&PROVIDER=vodafonegh&RECEIPTED=2021-07-28T02%3A02%3A56.811855&RECIPIENT=<MSISDN>&ID=<Mobivate sepcific reference ID>&SENT=2021-07-28T02%3A01%3A50

Body

Parameter	Type	Example	Description
originator	integer	12345	The associated shortcode for your service.
keyword	string	mv-100620006	Your unqiue Mobivate keyword for your service.
message_text	string	MNO+BILLED%3A+SILENT+BILLING+MESSAGE	Your URL encoded message.
changed	boolean	FALSE	Indicates whether or not the notification has been modified.
amount	integer	0	Cost of the message.
rcpt	string	2021-07-28T02%3A02%3A56.811855	URL encoded date timestamp of when the message was receipted.
result	integer	1	Indicates the result of the message.
receipted	string	2021-07-28T02%3A02%3A56.811855	URL encoded date timestamp of when the message was receipted.
recipient	integer	XX7432104492	The recipient you want to send this message to.
id	string	939ec52e333fbf124a87845d3a5d72e1	Your unique message ID.
sent	string	2021-07-28T02%3A02%3A56.811855	URL encoded date timestamp of when this message was sent.

Output

{
 "ORIGINATOR": "61412345678",
 "KEYWORD": "mv-100620006",
 "MESSAGE_TEXT": "MNO+BILLED%3A+SILENT+BILLING+MESSAGE",
 "CHANGED": "False",
 "AMOUNT": "0",
 "RCPT": "2021-07-28T02%3A02%3A56.811855",
 "RESULT": "1",
 "RECEIPTED": "2021-07-28T02%3A02%3A56.811855",
 "RECIPIENT": "1987654",
 "ID": "939ec52e333fbf124a87845d3a5d72e1",
 "SENT": "2021-07-28T02%3A01%3A50"
}

New Vodafone Ghana and Airtel billing diagram

The next step would be to send the content Via a free SMS using the Send SMS via HTTP method mentioned previously.

Please note the amount must be set to 0 or Vodafone will reject the message.