NowSMS/MMS Accounting Callbacks

Topic Keywords: accounting callbacks, billing, charging

Accounting callbacks have been added to the Now SMS & MMS Gateway effective with v4.11 and later.

Before the gateway accepts an SMS or MMS message for delivery, the gateway will connect to a configurable customer-provided URL, providing information about the message to be sent, and who is sending the message. The customer provided URL can either tell the gateway to either accept or reject the message. This is a “pre-authorisation” request, and does not mean that the message will actually be accepted for delivery. If the gateway cannot successfully connect to the URL, or the URL returns a response other than a standard “HTTP 200 OK”, the user request to send a message will be blocked. A “PreAuth” request to send a message will also be blocked if the response includes the text “PreAuth=Deny”.

After an SMS or MMS message is accepted for delivery, the gateway will connect to a configurable customer provided URL, providing accounting information about the message being sent, allowing the customer to maintain external accounting information on messages processed by the Now SMS & MMS Gateway. The gateway ignores HTTP responses to the accounting callbacks.

MMS Accounting Callbacks

For MMS messages, the MMS callback URL is defined in the MMSC.INI file, under the [MMSC] section header:

MMSAccountingURL=http://server.name/path

The variables listed in the sections below will be added to the MMSAccountingURL when the URL is executed by the gateway as HTTP GET (CGI-style) parameters.

MMSSend PreAuth Callback

This callback is executed when an MMS user is requesting to send a message. The following variables will be set:

PreAuth=Yes (indicates that the message is a Pre-Authorisation Request)

Type=MMSSend

From=SenderPhoneNumber

MsgCount=#### (number of recipients user is requesting to send the message to)

MMSSend Accounting Callback

This callback is executed after an MMS message that has been sent by an MMS user has been accepted by the gateway for delivery.

Type=MMSSend

From=SenderPhoneNumber

To=RecipientPhoneNumberOrEMailAddress

MessageID=SystemSpecificMessageID

Size=##### (size of message in bytes, may vary slightly with header changes in-transit)

MMSEMail Pre-Auth Callback

This callback is executed when an e-mail message is being presented for delivery to an MMS recipient. The following variables will be set:

PreAuth=Yes

Type=MMSEMail

From=SenderPhoneNumberOrEMailAddress (almost always an e-mail address)

To=RecipientPhoneNumber

MsgCount=1 (always 1 in current implementations)

MMSEMail Accounting Callback

This callback is executed after an MMS message has been received via e-mail, and has been queued for delivery to an MMS recipient. The following variables will be set:

Type=MMSEMail

From=SenderPhoneNumberOrEMailAddress (almost always an e-mail address)

To=RecipientPhoneNumber

MessageID=SystemSpecificMessageID

Size=#### (size of message in bytes, may vary slightly with header changes in-transit)

MMSRetrieve Accounting Callback

This callback is executed with a client connects in to retrieve an MMS message. The following variables will be set:

Type=MMSRetrieve

From=SenderPhoneNumberOrEMailAddress

To=RecipientPhoneNumber

MessageID=SystemSpecificMessageID

Size=#### (size of message in bytes)

SMS Accounting Callbacks

For SMS messages, the SMS callback URL is defined in the SMSGW.INI file, under the [SMSGW] section header:

SMSAccountingURL=http://server.name/path

The variables listed in the sections below will be added to the SMSAccountingURL when the URL is executed by the gateway as HTTP GET (CGI-style) parameters.

SMSSend PreAuth Callback

This callback is executed when an SMS (web, SMPP, SMTP) user is requesting to send a message. The following variables will be set:

PreAuth=Yes (indicates that the message is a Pre-Authorisation Request)

Type=SMSSend

From=DefinedSMSUserAccount

MsgCount=#### (number of recipients user is requesting to send the message to)

SMSSend Accounting Callback

This callback is executed after an SMS message that has been sent by an SMS user has been accepted by the gateway for delivery.

Type=SMSSend

From=DefinedSMSUserAccount

To=RecipientPhoneNumber

MessageID=SystemSpecificMessageID

Size=##### (size of message in bytes, may vary slightly with header changes in-transit)