Update User's SMS Balance Bulk SMS API Documentation

Update User's SMS Balance

Update your user's Account SMS Balance.

Add or Remove Credits using API. You/User need to have sufficient balance to add/remove credits.

Application API URL:

https://www.smsgateway.center/library/api/reseller/UpdateBalance/

 

Key Value Description
Login Credentials (Required Parameters)
Authenticate your API request using userId-password or apiKey. You should use either one to authenticate your login.
userId Your Registered Username The registered username parameter to be passed. You can use this if apiKey is not being used.
password Your password The password needs to be urlencoded if there are any special characters used in the password field. You can use this if apiKey is not being used.
apiKey Your unique apiKey apiKey needs to be sent as HTTP header when you are not using userId and password credentials. You can avail this from your user control panel and use instead of userId and password HTTP Request parameter. Please do not disclose this to anyone.
Required Parameters
Client_Username Your User's Username Enter your user's registered username.
UpdateAction add|remove To add credits you need to use parameter, add or to remove credits from your user account, you need to use parameter, remove.
UpdateCredit Integer Use integers to update balance, do not use comma or period in this parameter. For example: 100000 for 100 thousand credits.
UpdateComments String Use string to insert comments about your update balance action.
format plain|json|xml Value for response format.

System default is plain. If you need responses in JSON or XML then you have to give value as JSON or XML.

Save this Page on your Favorite Social Media

Sample Request Code

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://www.smsgateway.center/library/api/reseller/UpdateBalance/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "userId=YourUsername&password=YourPassword&Client_Username=ClientUsername&UpdateAction=add&UpdateCredit=100000&format=json",
  CURLOPT_HTTPHEADER => array(
    "cache-control: no-cache",
    "content-type: application/x-www-form-urlencoded"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://www.smsgateway.center/library/api/reseller/UpdateBalance/?userId=YourUsername&password=YourPassword&Client_Username=ClientUsername&UpdateAction=add&UpdateCredit=100000&format=json",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => array(
    "cache-control: no-cache"
  ),
));

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
var qs = require("querystring");
var http = require("https");

var options = {
  "method": "POST",
  "hostname": "www.smsgateway.center",
  "port": null,
  "path": "/library/api/reseller/UpdateBalance/",
  "headers": {
    "content-type": "application/x-www-form-urlencoded",
    "cache-control": "no-cache"
  }
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.write(qs.stringify({ userId: 'YourUsername',
  password: 'YourPassword',
  Client_Username: 'ClientUsername',
  UpdateAction: 'add',
  UpdateCredit: '100000'
  format: 'json' }));
req.end();
var http = require("https");

var options = {
  "method": "GET",
  "hostname": "www.smsgateway.center",
  "port": null,
  "path": "/library/api/reseller/UpdateBalance/?userId=YourUsername&password=YourPassword&Client_Username=ClientUsername&UpdateAction=add&UpdateCredit=100000&format=json",
  "headers": {
    "cache-control": "no-cache"
  }
};

var req = http.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function () {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });
});

req.end();
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded");
RequestBody body = RequestBody.create(mediaType, "userId=YourUsername&password=YourPassword&Client_Username=ClientUsername&UpdateAction=add&UpdateCredit=100000&format=json");
Request request = new Request.Builder()
  .url("https://www.smsgateway.center/library/api/reseller/UpdateBalance/")
  .post(body)
  .addHeader("content-type", "application/x-www-form-urlencoded")
  .addHeader("cache-control", "no-cache")
  .build();

Response response = client.newCall(request).execute();
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://www.smsgateway.center/library/api/reseller/UpdateBalance/?userId=YourUsername&password=YourPassword&Client_Username=ClientUsername&UpdateAction=add&UpdateCredit=100000&format=json")
  .get()
  .addHeader("cache-control", "no-cache")
  .build();

Response response = client.newCall(request).execute();

Response

{
    "status": "success",
    "statusCode": "900",
    "transactionId": "e6a3d971-1125-415d-b40a-1c92274d2f65",
    "reason": "SMS Credits Successfully been added."
}
{
    "status": "success",
    "statusCode": "900",
    "transactionId": "e6a3d971-1125-415d-b40a-1c92274d2f65",
    "reason": "SMS Credits Successfully been removed."
}
{
    "status": "error",
    "statusCode": "2536",
    "reason": "Insufficient Balance"
}
{
    "status": "error",
    "statusCode": "2536",
    "reason": "Insufficient User's Balance"
}