Bind and submit errors
Common SMPP errors, what they mean and how to fix them.
Cannot connect at all
| What you see | Likely cause | Fix |
|---|---|---|
| Timeout or "connection refused" on port 2775 | Your IP address is not on the bind's allowlist. The firewall drops it before SMPP. | Add your public IP in the portal and wait about a minute. Check which IP the internet sees. |
| DNS error | Wrong host name. | Use smpp.smsyanu.com. |
Bind refused
The bind response has a non-zero command_status:
| Status | Hex | Meaning | Fix |
|---|---|---|---|
ESME_RINVPASWD | 0x0000000E | Invalid password. | Reset the password in the portal and update your client. |
ESME_RINVSYSID | 0x0000000F | Unknown system_id. | Copy the system_id from the portal exactly. |
ESME_RBINDFAIL | 0x0000000D | Bind failed. Often the session limit (too many sessions open), or the bind is suspended. | Close old sessions. Ask support or your reseller if the bind is suspended. |
ESME_RALYBND | 0x00000005 | This session is already bound. | Do not bind twice on one connection. |
Message refused
The submit_sm_resp has a non-zero command_status. You are not charged.
| Status | Hex | Meaning | Fix |
|---|---|---|---|
ESME_RTHROTTLED | 0x00000058 | Throttled. You sent faster than the bind's limit. | Slow down and send again. |
ESME_RINVDSTADR | 0x0000000B | Bad destination, or a country not on this bind. | Check the number format and the bind's countries. |
ESME_RINVSRCADR | 0x0000000A | Sender ID not allowed. | Use an approved sender ID. |
ESME_RINVMSGLEN | 0x00000001 | Message too long for one submit_sm. | Split it with UDH. See Encoding. |
ESME_RSUBMITFAIL | 0x00000045 | Submit failed. This includes no credit (balance 0). | Check the bind balance and top up. |
Still stuck
Collect your system_id, the time of the error (Malawi time), the error code and your public IP, then contact support.
To be confirmed
The codes for "no credit", "country not on this bind" and "session limit reached" are the ones the SMPP gateway software normally returns. They have not yet been checked against the live SMS YANU server.