Getting to know the Chikka SMS API
The Chikka SMS API allows you to create SMS-based applications or integrate the service into your existing applications using HTTP POST interface.
It enables you to develop apps that can send and receive SMS using phone numbers or short codes. Our SMS API makes it possible for your users to communicate with your application or to conveniently receive updates from their favorite brands.
The Chikka SMS API gives you the freedom to use standard web languages to build your SMS-based applications. And one of the best things about our API is that it will seamlessly connect your applications to the major Philippine carriers without any hassle.
Chikka SMS API requires a system-generated secret key for all the messages you send to ensure that your data stays private.
The Chikka SMS API can be seamlessly integrated into any programming language you prefer.
Our technical experts are always available to provide assistance on anything you need to know about the Chikka API.
Notifications on the status of your sent messages will help you closely monitor transactions.
Allow bank customers to check their current account balance via SMS.
Improve branding awareness through text promos.
Let your users authenticate their accounts through SMS verification.
Let people know when their bills are due, table reservation is ready, or a storm is coming.
Advertise Products and Services
Send mobile alerts to help increase sales.
Allow your customers to trace the delivery of their packages.
Provide Technical Support
Through SMS, your customers may be served better by quickly responding to their questions and helping them understand the product/service more.
To start using the Chikka SMS API, create an account using your email address and unique password. You will then go through the verification process to help us secure your account. Afterwards, you can simply log on to your account using your email address as the username.
You will get 25 SMS credits that you can use for up to five (5) days, absolutely free. Even before your free trial ends, you can also start availing of SMS package/s if you want to continue communicating to your customers.
Testing your account
You also need to set a test mobile number, which you can change up to three (3) times for the duration of your free trial.
Continue using SMS API
You have the option to consume all your 25 free SMS credits before availing of a package or you can also upgrade even before your free trial expires. Buying a package will automatically upgrade you to a paid account. Once you upgrade, any remaining free SMS credits will no longer be valid.
Upon creating an account, you will be assigned a unique short code, which you can choose from list of suggestions; or better yet, you can set your preferred short code. However, please take note that the assignment of short codes is on a first-come, first-served basis.
Your short code will appear in this format: 29290+<preferred 3 to 6 digits unique suffix combination>. Example: 29290123456
Once you've used up your free trial, your unique short code will expire after 30 days of inactivity.
Your expired short code may then be reallocated to another user. Your account, however, will remain accessible for you for any future SMS API-enabled projects you will have. After the deactivation of your short code, you will be asked to assign a new one when you log in to your account.
There are four packages you can choose from and there's no limit as to how many packages you can avail of at a time. You can purchase one or combine packages anytime you need more credits.
Package Messages Plan 100 up to 250 messages Plan 500 up to 1,250 messages Plan 1000 up to 2,500 messages Plan 2500 up to 6,250 messages
You can choose to pay for your packages via the following methods:
- Smart Mobile Payment
Payments via Dragonpay and PayPal are available for transactions of Plan 500 and above. Meanwhile, only verified users will be allowed to purchase via PayPal; and the monthly limit is P300,000.
Feel free to utilize the Chikka SMS API for your applications, except for the following:
- SMS loan offers
- SMS real estate marketing
- SMS VAS subscription services
As general rule, offensive or explicit language in your messages will not be tolerated. Our system will automatically filter offensive or explicit words included in messages. The system will only display the first two characters of the filtered word and replace the rest with asterisks (*). Example: sh** for … you know what it is.
The Chikka SMS API is equipped with tri-telco connectivity that includes Smart, Globe and Sun Cellular.
All the outgoing messages (140 characters) you send will be deducted from the SMS credits in your existing package. The charge rate for every successful outgoing message depends on the network carrier of your recipients.
Telco Charge Rate Smart 0.40 Php per SMS sent Sun Cellular 0.40 Php per SMS sent Globe 0.50 Php per SMS sent
You are allowed to send up to thirty (30) 420-character messages to a particular customer per day. You will be notified in the event that you exceed the message limit. Exceeding messages for the day will no longer be sent out but will still be deducted from your credit balance.
As the owner of the service or application, you have a say on how much you want to charge your customers using the available tariff rates*:
- 1.00 Php
- 2.50 Php
- 5.00 Php
- 10.00 Php
- 15.00 Php
*The reply message rate will automatically be included in your outgoing message to help inform your customers; this is why your outgoing message can only be 140 characters long.
You are entitled to a percentage of each mobile reply sent by your customers. The revenue share for each carrier are as follows:
- 70% revenue share for every reply message of a Smart subscriber
- 60% revenue share for every reply message of a Globe subscriber
You will receive a statement report summarizing your monthly transactions; and once you reach a minimum amount of 5000 Php revenue share, you can start collecting your share by furnishing an invoice to Chikka Philippines, Inc. Your payment will be released via check within 60 calendar days upon the receipt of your invoice. Download the invoice template here.
Checks will be made payable to the registered user so please make sure your Account Name is your full name or the complete name of your company.
Please remember to keep a copy of your transaction history on a regular basis. The Chikka API website can only display transactions made within the last two (2) months.
Note: The Chikka API currently supports SMS to/from Smart and Globe numbers; connection with Sun Cellular is still in the works.
I cannot confirm my test mobile number because I did not receive a text message with my verification code. What should I do?
Make sure that you have entered your correct mobile number. Also, please wait for a few minutes as network congestion can sometimes cause delay in delivering your verification code.
I did not receive a PIN code when I purchased via Smart Payment. What should I do?
Make sure you have entered a valid mobile number that is NOT tied to a corporate account. If your number is not tied to a corporate account and you still did not receive a PIN code within a few minutes, kindly purchase the package/s again. Don't worry, you will only be charged once and that is after you have entered the correct PIN code.
I did not receive a confirmation message after I entered my PIN code. What should I do?
You can always view the status of your purchases online. In the Chikka API Dashboard, just go to your Purchase History.
If the Transaction Status is:
- SUCCESSFUL: Don't worry, you have successfully purchased your package/s. The delivery of your confirmation message may have just been delayed due to network congestion or other network-related problems. You may also check your email for the confirmation message regarding your transaction.
- PENDING: Kindly wait for a few minutes as your transaction is still being processed.
- FAILED: Make sure you have sufficient load to purchase your package/s. Once you have the enough balance, kindly try purchasing again. For other concerns, you may contact email@example.com.
My access code appears too long. Can I get a 5-digit access code?
Unfortunately, the minimum length for an access code is 8 digits. This includes the 29290 prefix.
I am a Smart subscriber. Why can't I purchase Chikka API credits?
Kindly check if your mobile number is valid and not tied to a corporate account. Most corporate numbers are not allowed to purchase Chikka API credits.
Would the tariff rate (e.g. Php 1.00), which is charged to the user, cover the charge rate (e.g. Php 0.40 for Smart) of my reply message?
No, the tariff rate and the charge rate are settled separately.
The tariff rate (request cost) is the amount you desire to charge the user/recipient and it is deducted from the user's actual load. On the other hand, the charge rate (credits cost) is the cost of your reply message and it is deducted from your Chikka API credits.
I don’t want to charge my customers for their text. How do I do this?
You can cover the costs of your users’ messages by choosing the FREE reply charge (request_cost). Reverse Billing will then be implemented and you will be charged Php 0.40 for Smart/Sun and Php 0.50 for Globe. This is on top of the credits you will be using to reply to your user.
Why can't I send/receive SMS to/from the Chikka API short code?
Make sure that your mobile number is VALID and is NOT tied to a corporate account. Most corporate numbers are blocked from sending and receiving text messages from an access code.
If a user sends a multi-part message to my access code, will the Chikka API send the message as a single transaction?
No, the Chikka API will send a multi-part message separately depending on the number of message parts. For example, a 2-part message will be sent as 2 separate messages to your access code.
Please note that if the user sends a multi-part message, only the first message might be received, unless the recipient sends a reply. This is due to the limit imposed by the API in receiving messages (refer to Limitation in Receiving Messages).