Send SMS via HTTP-API
Sending SMS messages
Our API uses HTTP requests. When you send a HTTP request to our server, you will be able to send values using POST or GET variables. For example, the originator, the message and the recipient(s). Use the following URL for sending SMS messages:
Sending the request:
http://www.mollie.nl/xml/sms/?username=[username]
&password=[password]&originator=[originator]&
recipients=[recipient(s)]&message=[message]
| Parameter | Explanation | Remarks |
|---|---|---|
| username | mollie.nl username | |
| password | mollie.nl password | |
| originator | originator of the SMS message | max. 14 numbers or 11 characters |
| recipients | recipient(s) of the SMS message | numbers separated by comma |
| message | the message | max. 160 characters |
| Optional parameters | ||
| md5_password | encrypted version of your mollie.nl password | use instead of password-parameter |
| gateway | setting of gateway route | click for explanation |
| reference | required when using delivery report | click for explanation » |
| dlrurl | alternative url for delivery report | click for explanation » |
| deliverydate | deliver message at chosen date and/or time | format yyyymmddhhmmss |
| charset | name of charset of message | Windows-1252 / UTF-8 / ISO-8859-1(5) / etc. |
| type | SMS message type | options: normal / wappush / vcard / flash / binary / long / unicode / longunicode |
| udh | the 'header' of the SMS message | only when type=binary |
| return | return extra information on response page | option: charged |
| cut | cut off message after 160 characters | true / false |
| replace_illegal_chars | replace non-GSM-charset characters by alternate characters | true / false (default: true) |
* Unfortunately Telfort does not support € 2,00 and € 3,00 premium tariffs. Therefore you will need to filter based on the recipient's operator prefix, or the operator parameter in the MO report script. If you do try to charge these tariffs, we will return an error in the DLR report.
Our response
After sending the HTTP-request, our server will return an XML-response. For example:
<?xml version="1.0" ?>
<response>
<item type="sms">
<recipients>1</recipients>
<success>true</success>
<resultcode>10</resultcode>
<resultmessage>Message successfully sent.</resultmessage>
</item>
</response>
The item recipients explains the number of recipients the message is sent to (if it was sent successfully).
Incorrect telephone numbers will be filtered by our system. The item success returns true if the message is sent and false when sending the message failed.
Possible returns of resultcode:
- 10 - message sent
- 20 - no 'username'
- 21 - no 'password'
- 22 - no or incorrect 'originator'
- 23 - no 'recipients'
- 24 - no 'message'
- 25 - incorrect 'recipients'
- 26 - incorrect 'originator'
- 27 - incorrect 'message'
- 28 - charset failure
- 29 - parameter failure
- 30 - incorrect 'username' or 'password'
- 31 - not enough credits to send message
- 38 - binary UDH parameter misformed
- 39 - deliverydate format is not correct.
- 98 - gateway unreachable
- 99 - unknown error
Suggestion: we offer also a 'secure SSL connection' to our webservers. If you want to use this connection, please connect to https://secure.mollie.nl/
SMS API downlaods
Below you will find classes, modules and examples in several programming languages. Some attached descriptions and documentation are in Dutch.
| Description | Programming language | Author | Version |
|---|---|---|---|
| PHP class | PHP 4.x, 5.x or higher | Mollie | v2.5 (17/09/10) |
| Ruby library | Ruby | Eloy Durán | v1.0.0 |
| Perl library | Perl | b10m | v0.02 |
| ASP script | ASP | D-motivatie | v1.00 |
| PowerShell | Microsoft PowerShell | M. Seegers | v1.0 |
| C# (.NET) | C# (.NET) | Oblivio | v2.0 |
| Java | Java | Crolox B.V. | v1.0 |
| Python | Python | I. van der Wijk | v1.0 |
| VB.NET | Visual Basic .NET | K. de Groot | v1.0 |
| Delphi (Win32 / .NET) | Delphi (Win32 / .NET) | Bob Swart | v1.0 | Third party plugins / modules |
| Nagios Plugin | Nagios plugin for Mollie | Mollie B.V. | v2.0 |
| Zabbix Plugin | Zabbix plugin for Mollie | Mollie B.V. | v1.1 |
| Vasco Plugin | Vasco plugin for Mollie | Mollie B.V. | v1.0 |
