GTX SMPP API
Connect with the world
Our SMPP interface provides an easy-to-use
and easy-to-implement SMPP interface for receiving
and submitting messages from and to the gateway.
Start sending SMS today >
GTX Messaging SMPP Gateway
The Mobile Messaging SMS Gateway provides an SMPP interface for standardized connectivity. It is based on the protocol version 3.4 as described in the official SMPP specification
If you have trouble downloading this document please ask us for a copy.
This manual will answer some common questions regarding the connection and message submission. If you have further questions regarding this interface, please contact your account manager or file a trouble ticket to firstname.lastname@example.org.
The SMPP interface is reachable under the following address:
Your account manager will announce the target port upon account creation.
Please use the system type "WMA".
Enquire Link Interval
To keep the connection alive, please send an enquire_link command every 60 seconds. If the SMPP gateway doesn't receive any message within 120 seconds it will close the connection by sending an unbind command.
We recommend binding as a transceiver to be able to both send and receive messages.
Please be aware that the SMPP gateway may send an unbind command to your client You may reconnect automatically after a few seconds.
By default your account is set up with a maximum throughput of 5 SMS per second. In case you want to increase this limitation please talk to your account manager.
TON / NPI Settings
This part explains the TON (Type Of Number) and NPI (Numbering Plan Indicator) settings that should be used with the Gateway. For further information please refer to the SMPP specification, sections 5.2.5 and 5.2.6.
Bind TON / NPI
When binding both TON and NPI should be set to NULL.
Source Address TON / NPI
When submitting messages please set the TON and NPI accordingly:
|1||1||International numeric originator|
|2||1||Local / national originator, either shortcode or numeric|
Destination Address TON / NPI
The destination address should always be submitted using TON = 1 and NPI = 1. The SMPP gateway always expects an international number format.
Delivery Reports (DLR)
Depending on the chosen product the underlying routing may not support DLRs. Please ask your account manager about DLR support on your product.
The following DLR reason codes will be returned:
SMS rejected by errorcodes "ff00", "ff01", "ff02" and "ff08" will not be charged.
dlvrd:001 submit date:1105011200
stat:DELIVRD err:0000 text: