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"
}

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.

Last updated