SMPP technical details
SMS service for transactional and bulk SMS. SMPP and REST SMS APIs supported.
Technical Details: Tyr SMS Gateway
This section provides details specific to the use of SMPP with the Tyr SMS Gateway service. Accounts may be configured different to the defaults shown below and therefore you should check your SMPP Account Details issued by Melrose Labs for details specific to your account.
Hosts
Connect to any of the following hosts using your SMPP account details:
| Host | Location | |
|---|---|---|
| eu-uk.mlsmpp.net / eu-uk-lon.mlsmpp.net | London, United Kingdom | |
| eu-de.mlsmpp.net / eu-de-fra.mlsmpp.net | Frankfurt, Germany | |
| af-za.mlsmpp.net | Cape Town, South Africa | |
| na-us.mlsmpp.net | North Virginia, USA | |
| me-bh.mlsmpp.net | Bahrain | |
| sa-br.mlsmpp.net | São Paulo , Brazil | |
| ap-sg.mlsmpp.net | Singapore | |
| ap-au.mlsmpp.net | Sydney, Australia | |
Live Coming Soon Planned
Ports
Non-TLS and TLS connections can be made depending on port use:
| Port | Description |
|---|---|
| 2775 | Non-TLS |
| 8775 | TLS (recommended) |
SMPP over TLS
We strongly recommend the use of SMPP over TLS to secure sessions between applications and our access node hosts. TLS v1.1 and v1.2 are supported. Earlier versions of TLS and SSL are deliberately not supported.
For legacy applications that do not support TLS, we recommend the use of stunnel for using SMPP over TLS.
SMPP Client
Test an SMPP account and service from Melrose Labs or another provider using the Melrose Labs SMPP Client . Use from your web browser. No software installation necessary. Other web browser-based SMPP clients available from Melrose Labs include:
Alternatively, use our txtConsole portal to send messages, get usage reports and look-up messages.
Session Parameters
| Bind types | SMPP versions | Maximum binds | Submit window size | Max. submit rate | Character Sets |
|---|---|---|---|---|---|
| TX, RX, TRX | v3.3, v3.4 (default) or v5 | 10 per host | 20 | 2000 SMS/sec | GSM (data_coding=0) Latin/ISO-8859-1 (3) Binary (4) UCS2 (8) |
Operations Supported
| Session Management | Message Submission | Message Delivery | Anciliary Submission |
|---|---|---|---|
| bind_transmitter bind_receiver bind_transceiver |
submit_sm data_sm |
deliver_sm data_sm |
cancel_sm query_sm replace_sm |
Full details of the Tyr SMS Gateway SMPP support can be found in the SMPP Protocol Implementation Conformance Statement (PICS) .
Delivery Receipts
Delivery receipts and intermediate notifications have the following format and are contained in the short_message field of the deliver_sm:
id:IIIIIIIIII sub:SSS dlvrd:DDD submit date:YYMMDDhhmm done date:YYMMDDhhmm stat:DDDDDDD err:EEE text:
- id: message ID returned in submit_sm_resp (up to 64 characters in length)
- sub: number of messages originally submitted (set to 001)
- dlvrd: number of messages delivered (000 or 001)
- submit date: When message was submitted by ESME
- done date: When message reached final state
- stat: State of message (see Name field below)
- err: Error encountered during delivery (if any)
Additionally, the following TLVs are present in the delivery receipt:
| TLV | Description |
|---|---|
| receipted_message_id | MC message ID of message being receipted. Should be present for MC Delivery Receipts and Intermediate Notifications. |
| message_state | Delivery state as shown in below table. |
| network_error_code | Error code specific to a wireless network (see error codes below). |
Message states
| State | Meaning | Name | Description |
|---|---|---|---|
| 0 | Scheduled | SCHEDLD | The message is scheduled. Delivery has not yet been initiated. (Intermediate) |
| 1 | Enroute | ENROUTE | The message is in enroute state. (Intermediate) |
| 2 | Delivered | DELIVRD | Message is delivered to destination. (Final) |
| 3 | Expired | EXPIRED | Message validity period has expired. (Final) |
| 4 | Deleted | DELETED | Message has been deleted. (Final) |
| 5 | Undeliverable | UNDELIV | Message is undeliverable. (Final) |
| 6 | Accepted | ACCEPTD | Message is in accepted state. (Final) |
| 7 | Unknown | UNKNOWN | Message is in invalid state. |
| 8 | Rejected | REJECTD | Message is in a rejected state. (Final) |
| 9 | Skipped | SKIPPED | The message was accepted but not transmitted or broadcast on the network. (Final) |
Error codes
| Code | Name | Description |
|---|---|---|
| 0 | No error | |
| 1 | Unknown subscriber | MSISDN is unknown or invalid |
| 27 | Absent subscriber | Mobile is switched off or unreachable |
| 31 | Subscriber busy for MT SMS | MSC is busy communicating with the handset for another transaction (may be receiving another SMS simultaneously) |
| 34 | System failure | SS7 protocol or network failure |