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)

Return to Now SMS/MMS Gateway Technical Bulletins