Fortumo Мобилни плащания/ Premium SMS API техническа спецификация

message

Съдържание на съобщението без ключови думи. Ако съобщението е било TXT KEY 123, то този параметър е 123. Параметърът е празен, ако е имало само ключовата дума и никакъв друг допълнителен текст.

sender

Телефонният номер на подателя на съобщението в международен формат, без знака плюс. Например 359888123456 или 40123456700. В някои страни, поради законите за защита на крайния потребител, този параметър може да е празен или криптиран от мобилните оператори.

country

Държавният код на оператора на подателя. Използват се дву-символни кодове, съгласно стандарта ISO 3166-1 (BG за България, RO за Румъния, SE за Швеция, FI - Финландия, NO - Норвегия, LT - Литва, LV - Латвия, EE - Естония и т.н). Моля, имайте предвид, че това НЕ задължително е истинското местонахождение на изпращача. Например, подателят с шведски телефон може да изпрати съобщение, докато е на роуминг в Норвегия, а вие пак ще имате SE в полето за държава.

price

Крайната клиентска цена на съобщението в местната валута с включен ДДС.

currency

Местният паричен символ, съгласно ISO 4217 (BGN, RON, EUR, SEK, NOK, DKK, LTL, LVL, EEK, USD, GBP и т.н).

service_id

Серия от символи(низ), която разпознава тази услуга на Fortumo. Например f7fa12b381d290e268f99e382578d64a. Ако имате много услуги с един и същи URL адрес, можете да използвате това поле, за да определите, за коя услуга е това съобщение.

message_id

Серия от символи(низ), която е уникална за всяко съобщение, което услугата ви получава.

keyword

Частта от съобщението, наречена ключова дума. Ако съобщението е TXT KEY 123, тогава параметърът е TXT KEY.

shortcode

Краткият номер, до който бе изпратено съобщението

operator

Име на мобилният оператор, с който работи клиента

billing_type

Може да е MO или MT. Научете повече за различните видове таксуване от ЧЗВ секцията наFortumo.

status

Платежен статус, който е pending(при заявка за проверка статуса на доставка ), ok или failed(в репорт за таксуване).

test

Този параметър е наличен само когато съобщението се изпраща чрез тест интерфейса на Fortumo и стойността му винаги е 'true'.

sig

Поискайте подпис, който можете да проверите, за да сте сигурни, че заявката е произлязла от Fortumo. Погледнете по-долу в частта "Сигурност", за да разберете как.

<?php

  //set true if you want to use script for billing reports
  //first you need to enable them in your account
  $billing_reports_enabled = false;

  // check that the request comes from Fortumo server
  if(!in_array($_SERVER['REMOTE_ADDR'],
      array('81.20.151.38', '81.20.148.122', '209.20.83.207'))) {
    die("Error: Unknown IP");
  }

  // check the signature
  $secret = ''; // insert your secret between ''
  if(!empty($secret) && !check_signature($_GET, $secret)) {
    die("Error: Invalid signature");
  }

  $sender = $_GET['sender'];
  $message = $_GET['message'];

  // do something with $sender and $message
  $reply = "Thank you $sender for sending $message";

  // print out the reply
  echo($reply);
 
 //customize this according to your needs
  if($billing_reports_enabled 
    && preg_match("/Failed/i", $_GET['status']) 
    && preg_match("/MT/i", $_GET['billing_type'])) {
   // find message by $_GET['message_id'] and suspend it
  }


  function check_signature($params_array, $secret) {
    ksort($params_array);

    $str = '';
    foreach ($params_array as $k=>$v) {
      if($k != 'sig') {
        $str .= "$k=$v";
      }
    }
    $str .= $secret;
    $signature = md5($str);

    return ($params_array['sig'] == $signature);
  }
?>