SMSGlobal 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

Short Message PeertoPeer (SMPP)

Contents
ShortMessagePeertoPeer(SMPP)......................................................................................................3
Preface................................................................................................................................................3
Introduction........................................................................................................................................3
Features..............................................................................................................................................3
ServerDetails......................................................................................................................................4
Options................................................................................................................................................4
DeliveryReceipts.................................................................................................................................4
CommonErrors...................................................................................................................................5
SMSGlobalContactDetails.................................................................................................................6

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