Bulk SMS API - SMS to SMPP

You can easily connect to our servers using the Industry Standard SMPP protocol using your own login credentials. The SMPP version 3.3 protocol specification is available in PDF format as are the SMPP version 3.4 and SMPP version 5.0 specifications.

We particularly draw your attention to the SMPP Acceptance Test Plan mentioned towards the bottom of this document. Completing the Acceptance Test will ensure that your SMPP application and our SMPP servers communicate correctly.

Introduction

Although the SMPP API is mainly aimed at high-volume customers, we do not currently put any restrictions on its usage. The current API supports the following SMPP version 3.3 and 3.4 Protocol Description Units (PDU’s):

  • BIND_TRANSMITTER / BIND_TRANSMITTER_RESP
  • BIND_RECEIVER / BIND_RECEIVER_RESP
  • SUBMIT_SM / SUBMIT_SM_RESP
  • ENQUIRE_LINK / ENQUIRE_LINK_RESP
  • QUERY_SM / QUERY_SM_RESP
  • DELIVER_SM / DELIVER_SM_RESP
  • BIND_TRANCEIVER / BIND_TRANCEIVER_RESP
  • UNBIND / UNBIND_RESP

You must honour the unbind PDU by issuing a unbind_resp PDU before disconnecting. You are also required to honour the enquire_link PDU by sending an enquire_link_resp PDU.

Binding

TCP port 2775 on both s3.csoft.co.uk and s4.csoft.co.uk are open for SMPP connections. To receive traffic on a Two-way SMS Service Number (Virtual Mobile Number or Short Code Number) you must bind to both of our SMPP servers as receiver or tranceiver.

The following credentials should be used in all bind PDU's:

  • system_id – your username
  • password – your PIN
  • system_type – blank

Character Encoding

Our SMSC default alphabet (data_coding=0x00) is the GSM 03.38 7-bit ASCII alphabet. We deliver messages containing characters not in this set using UCS-2 (data_coding=0x08).

SMPP PDU Decoding/Encoding

You can decode and encode SMPP PDUs using our free utilities. For your convenience we provide both an online and offline decoder/encoder to help you debug your SMPP PDUs.

SMPP Acceptance Test Plan

We strongly encourage all customers with SMPP connection to work with us to complete our SMPP Acceptance Test. Passing this test will ensure that our systems are configured correctly and thus ensure the best possible service. If your system does not behave appropriately, for example by repeatedly retrying failed messages, then we reserve the right to block your access until the problem is resolved. We would much prefer to work with you to prevent such problems occurring in the first place. A PDF copy of the SMPP Acceptance Test Plan Version 10 is available here.