Чтобы использовать API, Вам необходимо связаться с нами и получить ID, пароль и ключ. А также согласовать финансы.

Далее необходимо делать HTTP-запросы на URL http://money2mobile.ru/api/, используя полученные ID и пароль (далее [ID] и [pass]) для прохождения HTTP-авторизации с реквизитами "api[ID]":"[pass]", а также полученный ключ (далее [key]) для подписи всех запросов.

Формат ответов - JSON:

{
	"error" :"Код ошибки (Integer), 0 означает успешное выполнение операции",
	"msg"   :"Сообщение (String)", # по умолчанию строки JSON передаются в UTF-8, для получения строк в UNICODE передавайте параметр unicode=1
	"data"  :"Ответные данные, если есть (Object)"
}

Список методов

• issue (Выпуск карты/ЭС)
• find (Поиск карты/ЭС)
• unissue (Аннулирование карты/ЭС)
• pay (Запуск выплаты по карте)
• check (Проверка статуса карты)
• balance (Проверка баланса)

Шаблон кода PHP

<?php

$operation      = '';
$credits        = '';
$expire         = '';
$code           = '';
$wallet         = '';
$wallet_type    = '';
$phone          = '';
$change_wallet  = '';
$customer_id    = '[ID]';
$pass           = '[pass]';
$hash           = md5($operation.$credits.$expire.$code.$wallet.$wallet_type.$phone.$change_wallet.$customer_id.'[key]');

$request = "http://money2mobile.ru/api/?"
								."&operation=".urlencode($operation)
								."&credits=".urlencode($credits)
								."&expire=".urlencode($expire)
								."&code=".urlencode($code)
								."&wallet=".urlencode($wallet)
								."&wallet_type=".urlencode($wallet_type)
								."&phone=".urlencode($phone)
								."&change_wallet=".urlencode($change_wallet)
								."&customer_id=".urlencode($customer_id)
								."&hash=".urlencode($hash);


# Пример на PHP

$ch = curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_USERPWD, "api$customer_id:$pass");
curl_setopt($ch, CURLOPT_URL, $request);
$json = curl_exec($ch);
var_dump ( json_decode( $json) );

Пример запроса

http://money2mobile.ru/api/?operation=issue&credits=2000&expire=28.11.2017&customer_id=101&hash=b11e36cadfee38cf5c659f7503b311a8

<?php
# Пример на PHP

$ch = curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_USERPWD, "api[ID]:[pass]");
curl_setopt($ch, CURLOPT_URL, "http://money2mobile.ru/api/?operation=issue&credits=2000&expire=28.11.2017&customer_id=101&hash=b11e36cadfee38cf5c659f7503b311a8");
$json = curl_exec($ch);
var_dump ( json_decode( $json) );

Пример ответа

{
	"error":0,
	"msg":"Карта выпущена.",
	"data": {
		"id":	    1010371,
		"code":     "A1000000000", # по этому коду карта может быть активирована на http://money2mobile.ru/activate_card.html
		"key":	    "eef32d05b70a633563086f83597a8fed", # ЭС доступен по адресу http://money2mobile.ru/get_sert.php?key=eef32d05b70a633563086f83597a8fed
		"credits":  10000, #номинал карты
		"balance": {
			"credits": 100000, # баланс в копейках
			"credits_limit": 0, # минаимальный баланс в копейках
			"cards_left": 0, # кол-во карт, доступных для операции issue
			"daily_paylimit": 0 # объем средств в коп., доступный для операции pay сегодня
		}
	}
}

Поиск одной из карт, которая была выпущена, но еще не была использована.

Пример запроса

http://money2mobile.ru/api/?operation=find&customer_id=101&hash=b11e36cadfee38cf5c659f7503b311a8

<?php
# Пример на PHP

$ch = curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_USERPWD, "api[ID]:[pass]");
curl_setopt($ch, CURLOPT_URL, "http://money2mobile.ru/api/?operation=find&customer_id=101&hash=b11e36cadfee38cf5c659f7503b311a8");
$json = curl_exec($ch);
var_dump ( json_decode( $json) );

Пример ответа

{
	"error": 0,
	"msg":   "Карта найдена.",
    "data": {
        "id":	    1010371,
        "code":     "A1000000000", # по этому коду карта может быть активирована на http://money2mobile.ru/activate_card.html
        "key":	    "eef32d05b70a633563086f83597a8fed", # ЭС доступен по адресу http://money2mobile.ru/get_sert.php?key=eef32d05b70a633563086f83597a8fed
        "credits":  10000, #номинал карты
    }
}

Отзыв карты, платеж по которой не удалось провести или он не проводился.

Пример запроса

http://money2mobile.ru/api/?operation=unissue&code=A1000000000&customer_id=101&hash=b11e36cadfee38cf5c659f7503b311a8

<?php
# Пример на PHP

$ch = curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_USERPWD, "api[ID]:[pass]");
curl_setopt($ch, CURLOPT_URL, "http://money2mobile.ru/api/?operation=unissue&code=A1000000000&customer_id=101&hash=b11e36cadfee38cf5c659f7503b311a8");
$json = curl_exec($ch);
var_dump ( json_decode( $json) );

Пример ответа

{
	"error": 0,
	"msg":   "Карта аннулирована, деньги возвращены на баланс."
}

Задание для карты реквизитов, по которым будет проводиться выплата.

Пример запроса

http://money2mobile.ru/api/?operation=pay&code=A1000000000&wallet=+7 999 9876543&wallet_type=PHONE&customer_id=101&hash=b11e36cadfee38cf5c659f7503b311a8

<?php
# Пример на PHP

$ch = curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_USERPWD, "api[ID]:[pass]");
curl_setopt($ch, CURLOPT_URL, "http://money2mobile.ru/api/?operation=pay&code=A1000000000&wallet=+7%20999%209876543&wallet_type=PHONE&customer_id=101&hash=b11e36cadfee38cf5c659f7503b311a8");
$json = curl_exec($ch);
var_dump ( json_decode( $json) );

Пример ответа

{
	"error": 0,
	"msg":   "Платеж по коду A1000000000 на сумму 20.00 руб. поставлен в очередь, ожидайте прихода средств."
}

Проверка статуса карты. При первом обращении к карте она переводится в статус "активирована" (если не истек срок годности); далее возвращаются статусы, связанные с заданием реквизитов для выплаты или статусом осуществляемого по карте платежа.

Пример запроса

http://money2mobile.ru/api/?operation=check&code=A1000000000&customer_id=101&hash=b11e36cadfee38cf5c659f7503b311a8

<?php
# Пример на PHP

$ch = curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_USERPWD, "api[ID]:[pass]");
curl_setopt($ch, CURLOPT_URL, "http://money2mobile.ru/api/?operation=check&code=A1000000000&customer_id=101&hash=b11e36cadfee38cf5c659f7503b311a8");
$json = curl_exec($ch);
var_dump ( json_decode( $json) );

Пример ответа

{
	"error": 0,
	"msg":   "Код выплачен 28.11.2014 19:00:00 на мобильный телефон, оканчивающийся на 6543."
}

Баланс, привязанный к аккаунту, меняется при выпуске (номинал карты списывается) или отзыве (номинал карты возвращается) карты.

Пример запроса

http://money2mobile.ru/api/?operation=balance&customer_id=101&hash=b11e36cadfee38cf5c659f7503b311a8

<?php
# Пример на PHP

$ch = curl_init();
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_USERPWD, "api[ID]:[pass]");
curl_setopt($ch, CURLOPT_URL, "http://money2mobile.ru/api/?operation=balance&customer_id=101&hash=b11e36cadfee38cf5c659f7503b311a8");
$json = curl_exec($ch);
var_dump ( json_decode( $json) );

Пример ответа

{
	"error": 0,
	"msg":   "Баланс определен.",
	"data": {
		"credits": 100000, # баланс в копейках
		"credits_limit": 0, # минаимальный баланс в копейках
		"cards_left": 0, # кол-во карт, доступных для операции issue
		"daily_paylimit": 0 # объем средств в коп., доступный для операции pay сегодня
	}

}