SendUSSD

POST

Send USSD

Send USSD Push notification to any Indosat Ooredoo mobile phone number. Similar to SMS, USSD Push messages take the form of plain text and is sent to a recipient’s mobile handset.

 

To start your USSD push notification, every request must pass in the access_token value in the header. For more information on how to generate your access_token, please refer to this section.

 

 

Request

Method URL
POST https://blinke-stage.apigee.net/umb/ussd

 

 

Request Headers

Name Description Mandatory
Authorization Bearer access_token Yes
Content-Type value = application/json Yes

 

 

Request Body

Request body is a JSON formatted text containing the following fields:

Name Description Mandatory
msisdn
string
The destination phone number. Format with msisdn e.g., 628150000001 (MSISDN format). The Indosat Ooredoo mobile number prefix starts with "62815", "62816", "62855", "62856", "62857", "62858" Yes
message
string
Message content to be sent Yes

 

 

Response

Result of the successful request contains following information:

Name Description
success
boolean
Return true if success.
transId
string
The Transaction ID from Blinke API.
message
string
The message information if the request has been successfully processed.

 

 

Response (Example)

HTTP Code Response
200
{
    "transId": "9000364791991406",
    "success": true,
    "message": "Message has been successfully sent to designated msisdn"
}
400
{
    "success": false,
    "error": {
        "code": "UMB-103",
        "message": "Invalid MSISDN"
    }
}

Depending on the request, other error code may occurs. Please refer to the following error code:

  • UMB-103 : Invalid MSISDN
  • UMB-105 : Invalid request
  • UMB-107 : Invalid prefix number (e.g. valid prefix number: 628xxx – ISAT Number)
  • UMB-109 : UMB not send
  • UMB-113 : Content message max 160 characters
  • UMB-197 : Permission denied
401
{
    "fault": {
        "faultstring": "Invalid Access Token",
        "detail": {
            "errorcode": "keymanagement.service.invalid_access_token"
        }
    }
}

 

 

Sandbox limitation
  • Limited to 10 ussd push per developer.
  • The remaining sms balance can be observed from Available-USSD-Quota response header.

Resource URL

https://blinke-stage.apigee.net /umb/ussd

Header Parameters


Name Values Description
Content-Type
(required)

JSON

Authorization
(required)

Bearer access_token

Body Parameters


Name Values Description
Message and msisdn
(required)

Message to send and MSISDN

Request Body

HTTP Basic

OAuth 2.0

API Key

Reset

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Resource Summary

Security

Content Type

application/json

Working...