Credentials
SMPP user accounts for connecting to the gateway.
SMPP credentials allow clients to connect to the eSMS SMPP gateway and send messages.
SMPP connection settings
| Setting | Value |
|---|---|
| Host | smpp.esmsafrica.io |
| Port | 2775 (plain TCP) |
| Bind type | Transceiver (transmitter and receiver also supported) |
| Username | Provided by admin |
| Password | Provided by admin |
| Source IP | Must be on your bind's IP allowlist |
| Throughput | Set per bind, typically 100 messages per second; higher on request |
Security and transport
SMPP runs over plain TCP on port 2775. The port is closed to the internet by default: it only accepts connections from the IP addresses on your bind's allowlist. TLS is not currently offered on the SMPP port. If your policy requires an encrypted link, contact support@esmsafrica.io to discuss options, or send over the HTTP API, which uses HTTPS (TLS 1.2 or 1.3).
Throughput
Throughput is set per bind. A typical limit is 100 messages per second. Higher limits are available on request, subject to the capacity of the destination routes. If you submit faster than your limit, the gateway rejects the extra submit_sm with ESME_RTHROTTLED (0x58). Pace your client to your limit and retry throttled messages after a short back-off.
Requesting credentials
- Log in to smpp.esmsafrica.io
- Go to SMPP Credentials
- Click Request Credential
- An administrator will review and approve your request
Once approved, your SMPP username and password are displayed in the credentials section.
Credential settings
Each SMPP credential includes:
| Setting | Description |
|---|---|
| Username | SMPP bind username |
| Password | SMPP bind password |
| Quota | Maximum messages allowed |
| Throughput | Maximum messages per second |
| Allowed senders | Permitted sender IDs |
Connecting
Use any SMPP client library to connect:
Python (smpplib)
import smpplib
client = smpplib.client.Client('smpp.esmsafrica.io', 2775)
client.connect()
client.bind_transceiver(
system_id='your_username',
password='your_password'
)
client.send_message(
source_addr='eSMS',
destination_addr='+254712345678',
short_message='Hello via SMPP!'
)Java (jSMPP)
SMPPSession session = new SMPPSession();
session.connectAndBind(
"smpp.esmsafrica.io", 2775,
new BindParameter(
BindType.BIND_TRX,
"your_username", "your_password",
"SMPP", TypeOfNumber.UNKNOWN,
NumberingPlanIndicator.UNKNOWN, null
)
);Test SMS
Send a test SMS from the dashboard to verify your credential is working:
- Go to your credential details
- Enter a test phone number
- Click Send Test