Premium SMS simulation API

For testing PSMS API integrations, it is possible to use PSMS simulation API. All back end notification requests triggered by the API have test=true parameter included, which allows you to filter out test payments from live transactions and make sure no service is provided for test payments.

SMS simulation request to base URI. Unique message ID is returned.
1
https://fortumo.com/test_sms_api 
Parameter Description
mcc Mobile country code
mnc Mobile network code
msisdn Message sender’s phone number in international format without the plus sign.
shortcode The shortcode that the message is sent to.
service_id Fortumo service identifier.
status Simulated billing status, either ok or failed.
userdata Message content including the keywords.
url After the simulated SMS is fully processed, response MT text is sent to this URL if specified.
sig Request signature, calculated from all the request parameters and service secret.

Example request:

1
https://fortumo.com/test_sms_api?mcc=248&mnc=2&msisdn=20&service_id=aeedf21fae19d71e70bb228ecc8239aa&shortcode=13018&url=http%3A%2F%2Fwww.google.com&sig=665077b47eeffe95b3093d2c7e4c77d2&status=ok&userdata=for+234565767+wqdfcdfvcdvxcv

Example response:

1
9afbe1e792e15048aeee31c0fff21713

Possible errors:

Error code Error message
404 Invalid country for service
404 Invalid shortcode
400 Invalid status (ok, failed are allowed)
403 Invalid signature
400 Invalid MNC or MCC
404 Invalid service_id
400 Malformed parameters
Fortumo makes payment notification request to merchant back end URL, specified for the service.

The content from the response that Fortumo receives is then used as a simulated reply message text. The request format is exactly the same as for live PSMS API payments.

Example request:

1
https://www.website.com/backend.php?billing_type=MO&country=EE&currency=EUR&keyword=&message=for+234565767+wqdfcdfvcdvxcv&message_id=dd24b8ae885ee93ccffb04b82188a1c3&operator=Elisa&price=0.32&price_wo_vat=0.27&sender=20&service_id=aeedf21fae19d71e70bb228ecc8239aa&shortcode=13018&sig=a2014fc197c7c514bcc4981bca8a25a3&status=OK&test=true

Example response:

1
You have purchased 10 tokens for 2.99 EUR. Thank you!
If selected carrier supports billing reports, Fortumo sends billing report to merchant back end URL.

Report format is exactly the same as the payment notification request. Status parameter value is the same as specified in the initial Simulation API request, either ok or failed.

If the initial Simulation API request included a URL parameter, a notification request is made to the specified URL.
Parameter Description
content MT SMS content
message_id Message id
sig Request signature, calculated from request parameters and service secret.
Help us improve our Merchants Portal. Was this article helpful?