SMPP Documentation

No setup fee. No monthly fee. No contract lock.

SMPP Documentation: This page will give you instructions and examples of how to use the Uwazii MOBILE SMPP communication interface. The Short Message Peer-to-Peer is an open, industry-standard protocol used by the telecommunications industry to exchange SMS messages between Short Message Service Centers or SMSC and SMS application systems. The protocol is a TCP/IP protocol level-7, which allows fast delivery of SMS messages. The application’s connection to the SMPP server is SMPP version 3.4. We do not support version 3.3.

Register for an Enterprise or Reseller Account

SMPP Parameter


You are allowed to bind as transmitter, receiver, transceiver. In order to receive delivery reports, you must bind a transceiver or receiver.

You’ll receive delivery reports only if your route provides delivery reporting. Delivery reports will be sent equally over all of your currently available sessions capable of receiving them (transceiver or receiver). By default, you are allowed to bind with 4 sessions. There is no other throughput (TPS) limitations besides internet speed.

PDUs Supported:

  • bind_transmitter
  • bind_receiver
  • bind_transceiver
  • unbind
  • submit_sm
  • deliver_sm
  • enquire_link

Delivery Report Format:

id:{message_id} sub:{message_sub} dlvrd:{message_dlvrd}
submit date:{message_submit_date} done date:{message_done_date} 
stat:{message_stat} err:{message_err}	

Delivery Statuses



If you set DCS 0 or DCS 1 when sending messages, we will treat that as default GSM7 encoding (SMSC Default Alphabet or IA5).

For Latin1 (ISO-8859-1) please use DCS 3 and DCS 8 for sending messages as Unicode (ISO/IEC-10646).

Command status and GSM Error Codes:

Each request sent to our system is to receive an acknowledgment in submit_sm resp PDU and is fully compliant with SMPP v 3.4 standard. Proprietary platform command statuses are described here along with platform-specific delivery report error codes you may encounter in deliver_sm PDU.

Command Status:

Command status is received as a response for Submit_SM, on special events, illustrated in the table below.

GSM Error Codes

GSM errors which could be provided by Uwazii MOBILE are listed on General Error Codes.

Additional Features

Scheduled Delivery

Scheduled delivery is supported over SMPP protocol using the relative time format.


“070605040302100R” – this would mean that the message will be delivered in 7 years, 6 months, 5 days, 4 hours, 3 minutes, 2 seconds and 1 tenth of a second from now.

National Language Shift over SMPP

Along with the standard features of SMPP 3.4, we also provide the national language shift functionality which enables you to use special characters from language-specific character sets.

Number Lookup over SMPP Specification

Using the Uwazii MOBILE SMPP account, it is possible to request Number Lookup data (IMSI).

In order to use Number Lookup, you can use your default system_id and password, setting system_type = “HLR” (without quotation marks) in Bind PDU.

SubmitSM PDU is used for submitting the Number Lookup request, with the destAddress parameter set to the required destination address. All other parameters will be ignored (srcAddress, TON/NPI, etc).

Uwazii MOBILE Number Lookup subsystem will respond using a regular SubmitSMResp, containing message-id reference.

Once the Number Lookup request is being finalized on the Uwazii MOBILE system, you will receive DeliverSM PDU, containing: – IMSI for the required destAddress or – error code in case of failure.

DeliverSM will contain: – short message data with our regular delivery report – IMSI part (“IMSI:xxxxxxxxx”) – serving MSC – additional optional info fields depending on your package.


Besides DeliverSM.shortMessage, we also included IMSI as an extra-optional parameter:



In case that the Number Lookup request was successful, DeliverSM will be as follows (IMSI 21910110053751):

addr: 0 0 38591xxxxxxx

addr: 0 0 0000000000

msg: id:40072910491427628 sub:001 dlvrd:001 submit date:1007291049 done date:1007291049 stat:DELIVRD err:000
IMSI:219101100935850 MSC:38591016 HLR:38591xxxxxxx ORN:VipNet PON:VipNet RON:VipNet ROC:HR MCCMNC:21910

opt: (oct: (tlv: 1059) 030000) (byte: (tlv: 1063) 2) (str: (tlv: 30) 40072910491427628) (str: (tlv: 5129)38591xxxxxxx) (str: (tlv: 5138) VipNet) (str: (tlv: 5139) VipNet) (str: (tlv: 5140) VipNet) (str: (tlv:5141) Croatia ) (str: (tlv: 5143) HR) (str: (tlv: 5142) 21910) (int: (tlv: 5144) 1) (str: (tlv: 5145) 91) (str: (tlv: 5152) 385) (int: (tlv: 5153) 1) (str: (tlv: 5154) Croatia ) (str: (tlv: 5155) HR) (str: (tlv: 5156) 385) (int: (tlv: 5157) 1) ) (extraopt: (oct: (tlv: 5123) 323139313031313030393335383530) (oct: (tlv: 5126) 3338353931303136) )	

If an error occurred, DeliverSM will be as follows:

addr: 0 0 385915369423

addr: 0 0 0000000000

msg: id:40072910491419819 sub:001 dlvrd:001 submit date:1007291049 done date:1007291049 stat:UNDELIV err:001

opt: (oct: (tlv: 1059) 030001) (byte: (tlv: 1063) 5) (str: (tlv: 30) 40072910491419819) (str: (tlv: 5138) VipNet) (str: (tlv: 5142) ) (int: (tlv: 5144) 1) (int: (tlv: 5153) 0) (str: (tlv: 5154) Croatia ) (str: (tlv: 5155) HR) (str: (tlv: 5156) 385) (int: (tlv: 5157) 1) )	

Flash notifications over SMPP Specification

You can use your Uwazii MOBILE SMPP account to send Flash notifications. Such notifications are immediately displayed on the mobile phone screen upon arrival and aren’t stored in the memory of the device.

In order to use Flash notifications, you can use your default system_id and password, setting system_type = “NSMS” (without quotation marks) in Bind PDU.

The procedure for submitting Flash notifications is exactly the same as for normal SMS, using SubmitSM PDU. Uwazii MOBILE system will automatically convert your message into a Flash notification using the message parameters you have submitted.

Delivery reports will be sent to you using DeliverSM PDU.


Long SMS feature is not supported for Flash notifications.

A Bit of Us

We are confident and we’ve got an excellent team on deck to handle all your SMS messaging needs


Server Uptime


Connected Networks


Happy Clients