SMPP
SMPP
August2011
Copyright SMSGlobal Pty Ltd (AU) & Global Messaging FZ-LLC (UAE)
No part of this document may be reproduced except as authorised by written permission.
The copyright and foregoing restrictions extend to reproduction in all media.
SMSGlobal Pty Ltd. All rights reserved.
CONFIDENTIAL
Page 2 of 6
ShortMessagePeertoPeer(SMPP)
Preface
WelcometotheSMSGlobalSMPPAPI.Thisdocumentprovidesareferenceforallfeatures
availabletoyouviatheSMPPinterfaceforsendingSMS.
Introduction
TheShortMessagePeertoPeer(SMPP)isaprotocolusedbythetelecommunications
industryforexchangingSMSmessagesbetweenShortMessageServiceCenters(SMSC)
and/orExternalShortMessagingEntities(ESME).
Theprotocolisalevel7TCP/IPprotocol,whichallowsfastdeliverofSMSmessages.
ThemostcommonlyusedversionsofSMPParev3.3,themostwidelysupportedstandard,
andv3.4,whichaddstransceiversupport(singleconnectionsthatcansendandreceive
messages).Dataexchangemaybesynchronous,whereeachpeermustwaitforaresponse
foreachPDUbeingsent,andasynchronous,wheremultiplerequestscanbeissuedinone
goandacknowledgedinaskeworderbytheotherpeer.
SMSGlobalsupportstheindustrystandardSMPPV3.4protocol.
Features
PleasefindbelowalistoffeaturesforthisAPI.
SMPPisadirectconnectiontocarriersandprovidesinstantdelivery
Highthroughput(upto200msgs/second)
UsageofShortCode
SMPPoffersstatusdeliveryreports
24/7supportviaoursupportsystem
Page 3 of 6
ServerDetails
Parameter
Description
IP/DOMAIN
smsglobal.com
PORT
1775
SYSTEMID
[Username]
PASSWORD
[Password]
Options
Parameter
Transmitterbind(TX)
Receiverbind(RX)
Transceiverbind(TRX)
Submitcommand
TON:1
NPI:1
Deliveryreceipts[Note.Pleasecontactustoenablethisforyou.]
DeliveryReceipts
Deliveryreceiptsareoptional.TheycanbepushedthroughanRX/TRXbindbacktothe
user.ToenabledeliveryreceiptslogintotheSMSGlobalMobileWorkspreferencesand
updateyourdeliveryreceiptsettingstoenableapushoverSMPP.
Page 4 of 6
CommonErrors
ErrorCode
ErrorType.
Description
Error
ESME_RINVMSGLENMessageLengthisinvalid
Error
ESME_RINVCMDLENCommandLengthisinvalid
Error
ESME_RINVCMDIDInvalidCommandID
Error
ESME_RINVBNDSTSIncorrectBIND
Error
ESME_RALYBNDESMEAlreadyinBoundState
10
Error
ESME_RINVSRCADRInvalidSourceAddress
11
Error
ESME_RINVDSTADRInvalidDestAddr
12
Error
ESME_RINVMSGIDMessageIDisinvalid
13
Error
ESME_RBINDFAILBindFailed
14
Error
ESME_RINVPASWDInvalidPassword
69
Error
ESME_RSUBMITFAILSubmitSMfailed
88
Error
ESME_RTHROTTLEDExceededallowedmessagelimits
102
Error
DestinationnotcoveredorUnknownprefix
400
Timeout
Sendmessagetimedout.
401
SystemError
Systemtemporarilydisabled
402
NoResponse
NoresponsefromSMSGlobalSMSC
Page 5 of 6
SMSGlobalContactDetails
SMSGlobalHeadquarters
9698MarketStreet
SouthMelbourne
Victoria3205
Australia
T:1300883400
T:+61390956245
F:+61396468837
SMSGlobalEMEAOffice
3015ShathaTower
DubaiMediaCity,Dubai
UNITEDARABEMIRATES
T:+97144409600
F:+97144458467
POBox502014Dubai,UAE
WebAddress:www.smsglobal.com
Support:http://www.smsglobal.com/support/
Page 6 of 6