API CONFIGURATION

API Configuration

Already have an sms website? Then its time to experience peace and steady growth in your business, stay ahead of your competitors by intergrating our SMS API! Simple yet powerful, it allows you to quickly and seamlessly integrate our messaging and database capabilities with your own system through the following api url:

To add our API to your joomla sms website, follow this instruction

Please logon to your SMSportal with your "admin" details and perform the following:

1. Click on Gateway/API under the admin settings (sms component version 2) For SPC version 3, simply click on the add API under administration

2. Locate and click manage API.

3. Add the setting below (replacing the highlights with your actual username and password you registered with with us

4. in click the gateway/api under the setting (sms reseller component version 2) or under the admin settings (SPC version 3) and select www.mtnbulksms.com as the default

 

API Name *
WWW.MTNBULKSMS.COM

HTTP SMS API:

http://mtnbulksms.com/components/com_smsreseller/smsapi.php?username=yourusername&password=yourpassword&sender=@@sender@@&recipient=@@recipient@@&message=@@message@@&


TO CHECK RESELLER BALLANCE:

http://mtnbulksms.com/components/com_smsreseller/smsapi.php?username=yourusername&password=yourpassword&balance=true&

API response on Success*
OK


API Response confirmation*

Contains

Protocol
HTTP POST

Push to API as:*
Bulk

The parameters are:
1. recipient : The destination phone numbers. Separate multiple numbers with comma(,)
3. username: Your puresms.com account username
4. password: Your puresms.com account password
5. sender: The sender ID to show on the receiver's phone
6. message: The text message to be sent
7. balance: Set to true only when you want to check your credit balance
6. schedule: Specify this parameter only when you are scheduling an sms for later delivery. It should contain the date the message should be delivered. Supported format is "2010-10-01 12:30:00" i.e "YYYY-MM-DD HH:mm:ss"


The return values are
OK=Successful
2904=SMS Sending Failed
2905=Invalid username/password combination
2906=Credit exhausted
2907=Gateway unavailable
2908=Invalid schedule date format
2909=Unable to schedule
2910=Username is empty
2911=Password is empty
2912=Recipient is empty
2913=Message is empty
2914=Sender is empty
2915=One or more required fields are empty
Example:
On success, the following code will be returned
OK 21 08033333333,08022222222,08055555555
i.e OK no of sms credits used gsm numbers that failed
where 21=no of sms credits used
and 08033333333,08022222222,08055555555 are the 3 numbers that failed