Rate Plan API

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => "https://unify.smsgateway.center/SMSApi/rateplan/read",
  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&output=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;
}

{
  "response": {
    "api": "rateplan",
    "action": "read",
    "status": "success",
    "msg": "Rate plan retrieved successfully",
    "code": 200,
    "count": 1,
    "data": {
      "mccMncRoutingEnabled": false,
      "defaultCurrency": "USD",
      "currencySymbol": "$",
      "currencyPosition": "left",
      "rates": [
        {
          "mcc": "Default",
          "mnc": "Default",
          "country": "Default",
          "countryCode": "Default",
          "operator": "Default",
          "rate": "0.0050",
          "dltRate": "0.0010",
          "sortName": "Default"
        }
      ]
    }
  }
}

Explanation: When MCC/MNC routing is disabled, only the default rate is returned. This is the standard rate applied to all SMS messages sent from your account.

{
  "response": {
    "api": "rateplan",
    "action": "read",
    "status": "success",
    "msg": "Rate plan retrieved successfully - 125 country rates",
    "code": 200,
    "count": 125,
    "data": {
      "mccMncRoutingEnabled": true,
      "defaultCurrency": "USD",
      "currencySymbol": "$",
      "currencyPosition": "left",
      "rates": [
        {
          "mcc": "Default",
          "mnc": "Default",
          "country": "Default",
          "countryCode": "Default",
          "operator": "Default",
          "rate": "0.0050",
          "dltRate": "0.0010",
          "sortName": "Default"
        },
        {
          "mcc": "404",
          "mnc": "10",
          "country": "India",
          "countryCode": "+91",
          "operator": "Airtel",
          "rate": "0.0045",
          "dltRate": "0.0000",
          "sortName": "IN"
        },
        {
          "mcc": "404",
          "mnc": "20",
          "country": "India",
          "countryCode": "+91",
          "operator": "Vodafone",
          "rate": "0.0045",
          "dltRate": "0.0000",
          "sortName": "IN"
        },
        {
          "mcc": "310",
          "mnc": "410",
          "country": "United States",
          "countryCode": "+1",
          "operator": "AT&T",
          "rate": "0.0080",
          "dltRate": "0.0000",
          "sortName": "US"
        },
        {
          "mcc": "234",
          "mnc": "15",
          "country": "United Kingdom",
          "countryCode": "+44",
          "operator": "Vodafone",
          "rate": "0.0070",
          "dltRate": "0.0000",
          "sortName": "UK"
        }
      ]
    }
  }
}

Explanation: When MCC/MNC routing is enabled, the API returns detailed country and operator-specific rates. The default rate is always the first entry, followed by all configured country/operator rates.

{
  "response": {
    "api": "rateplan",
    "action": "read",
    "status": "error",
    "msg": "Rate plan is not active for your account. Please contact administrator for pricing information",
    "code": 489
  }
}

{
  "response": {
    "api": "rateplan",
    "action": "read",
    "status": "error",
    "msg": "Rate plans for sub-users are undefined. Please review the rates in the main account",
    "code": 486
  }
}

// JavaScript example for displaying formatted price
function formatPrice(rate, currencySymbol, currencyPosition) {
  if (currencyPosition === 'left') {
    return currencySymbol + rate;  // e.g., $0.0050
  } else {
    return rate + currencySymbol;  // e.g., 0.0050€
  }
}

// Usage
const formattedPrice = formatPrice('0.0050', '$', 'left');
console.log(formattedPrice);  // Output: $0.0050

<?php
// Step 1: Get rate plan
$curl = curl_init();
curl_setopt_array($curl, array(
  CURLOPT_URL => "https://unify.smsgateway.center/SMSApi/rateplan/read",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POSTFIELDS => "userid=YourUsername&password=YourPassword&output=json",
));
$response = json_decode(curl_exec($curl), true);
curl_close($curl);

// Step 2: Extract default rate
$defaultRate = $response['response']['data']['rates'][0]['rate'];
$currencySymbol = $response['response']['data']['currencySymbol'];

// Step 3: Calculate cost for 1000 SMS
$smsCount = 1000;
$totalCost = $defaultRate * $smsCount;

echo "Cost for {$smsCount} SMS: {$currencySymbol}" . number_format($totalCost, 2);
// Output: Cost for 1000 SMS: $5.00

import requests
import json

# Step 1: Get rate plan
url = "https://unify.smsgateway.center/SMSApi/rateplan/read"
payload = {
    'userid': 'YourUsername',
    'password': 'YourPassword',
    'output': 'json'
}
response = requests.post(url, data=payload)
data = response.json()

# Step 2: Find rate for India
rates = data['response']['data']['rates']
india_rates = [r for r in rates if r['country'] == 'India']

# Step 3: Display India rates by operator
for rate in india_rates:
    print(f"{rate['operator']} (MCC: {rate['mcc']}, MNC: {rate['mnc']}): ${rate['rate']}")

# Output:
# Airtel (MCC: 404, MNC: 10): $0.0045
# Vodafone (MCC: 404, MNC: 20): $0.0045

// React Native / JavaScript example
async function fetchAndDisplayRates() {
  const formData = new FormData();
  formData.append('userid', 'YourUsername');
  formData.append('password', 'YourPassword');
  formData.append('output', 'json');

  const response = await fetch('https://unify.smsgateway.center/SMSApi/rateplan/read', {
    method: 'POST',
    body: formData
  });

  const data = await response.json();
  const rates = data.response.data.rates;
  const currencySymbol = data.response.data.currencySymbol;
  const currencyPosition = data.response.data.currencyPosition;

  // Group rates by country
  const ratesByCountry = {};
  rates.forEach(rate => {
    if (!ratesByCountry[rate.country]) {
      ratesByCountry[rate.country] = [];
    }
    ratesByCountry[rate.country].push(rate);
  });

  // Display rates
  Object.keys(ratesByCountry).forEach(country => {
    console.log(`\n${country}:`);
    ratesByCountry[country].forEach(rate => {
      const price = currencyPosition === 'left' 
        ? `${currencySymbol}${rate.rate}` 
        : `${rate.rate}${currencySymbol}`;
      console.log(`  ${rate.operator}: ${price}`);
    });
  });
}

fetchAndDisplayRates();