MMSMessage (SOAP)

RSS

The MMSMessage object is used when submitting MMS messages to the Gateway through the SOAP API.

Table of Contents [Hide/Show]

General information
Packaging
Properties
Code
XML
See also

General information¶

MMS in general and Premium MMS (CPA) are currently supported for the following operators:

Norway:
Telenor Mobil
NetCom
Tele2

Packaging¶

To simplify the packaging and transmission of MMS Messages, we have decided to use a simple ZIP file as the packaging of the MMS content. This means that all the content files/parts of the MMS must be zipped together into one zip-file before transmission to the MMS Gateway. The zip-file should not have any internal directory structure; all content files must reside in the root directory of the zip file, like this:

MyZippedMMS.zip contains
                  Pres.smil
                  Image.gif
                  Message.txt

How to construct an MMS presentation with text, audio and image content is beyond the scope of this interface documentation. Most will use some kind of MMS composer or other software to create the files required. Refer to http://www.w3.org/AudioVideo/ for more information about creating mobile content and SMIL files.

The zip-file is transmitted as a Byte-array to the MMS Gateway the attribute below named Data.

Properties¶

The table below shows all attributes and their description:

Attribute	Description
ReceiverNumber	Number of the receiver, internationally formatted with country-code but no “+” or “00” prefixed.
SenderNumber	Number of sender to be displayed on receiver’s handset. Numeric with no “+” or space, max 15 digits. Alphanumeric up to 11 characters can also be used.
Subject	This is the subject of the MMS to send or receive.
Tariff	Specifies the amount to charge the end-user in units of cents/”ører”. For example, to charge the end-user NOK 5,- you specify “500” as the TARIFF value. Only valid values must be used. Valid values are described in the CPA Agreement from PSWinCom that is required to use this property.
Data	Byte-array containing the MMS Message content as a packed zip-file.
Network	Optional. Used to indicate special routing of the message. Should only be set upon request from gateway-owner.
TimeToLive	Set this value to the number of minutes that the message should be valid before it expires if not delivered. Set to 0 to use the default value.
CPATag	Optional. Used with CPA messages to indicate further details on the subscribers telephone bill what he/she has paid for.
ReceiptRequest	If this attribute is set to true and forwarding of delivery reports are enabled for your Gateway account, then the delivery report for this message will be forwarded to your application.
SessionData	Optional. A free text field that can be used to tag the session with customer specific data such as the application name, username, reference-id etc. The maximum length is 200 characters. Leave empty unless required.
AffiliateProgram	Optional. If you are part of an Affiliate-Program offered by the PSWinCom Gateway provider, you can use this element to specify your Affiliate Program code. Leave empty unless required.

Code¶

C# notation of the SMSMessage object:

public class MMSMessage
{
  public string ReceiverNumber;
  public string SenderNumber;
  public string Subject;
  public string Network;
  public int Tariff;
  public int TimeToLive;
  public string CPATag;
  public bool RequestReceipt;
  public string SessionData;
  public string AffiliateProgram;
  public byte[] Data;

  public MMSMessage()
  {
  }
}

XML¶

<MMSMessage>
  <ReceiverNumber>4792112233</ReceiverNumber>
  <SenderNumber>2077</SenderNumber>
  <Subject>My MMS</Text>
  <Network> </Network>
  <Tariff>0</Tariff>
  <TimeToLive>0</TimeToLive>
  <CPATag></CPATag>
  <RequestReceipt>true</RequestReceipt>
  <SessionData></SessionData>
  <AffiliateProgram></AffiliateProgram>
  <Data>____</Data>
</MMSMessage>

Search the wiki¶

API Documentation¶

Mobile Payment¶