Чтобы использовать 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 (Проверка статуса карты)
• make_a_transaction (Проведение платежа без выпуска карты)
• check_the_transaction (Проверка платежа, созданного без выпуска карты)
• get_SBP_bank_list (Получение списка банков для проведения платежей через СБП)
• 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 руб. поставлен в очередь, ожидайте прихода средств."
}

При проведение данной операции с баланса списывается соответствующая сумма только после проверки возможности его инициации.

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

https://money2mobile.ru/api/?operation=make_a_transaction&wallet_type=SBP&wallet=89009999999&credits=1000&bank_id=100000000004&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, "https://money2mobile.ru/api/?operation=make_a_transaction&wallet_type=SBP&wallet=89009999999&credits=1000&bank_id=100000000004&customer_id=101&hash=b11e36cadfee38cf5c659f7503b311a8");
$json = curl_exec($ch);
var_dump ( json_decode( $json) );

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

{
	"error": 0,
	"msg":   "Транзакция на сумму 100 руб. инициирована.",
	"data": {
		"id": 100000010, # ID платежа для дальнейшей работы с ним
	}

}

Проверка статуса платежа, которые был создан методом make_a_transaction.

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

http://money2mobile.ru/api/?operation=check_the_transaction&id=100000010&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_the_transaction&code=100000010&customer_id=101&hash=b11e36cadfee38cf5c659f7503b311a8");
$json = curl_exec($ch);
var_dump ( json_decode( $json) );

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

{
	"error": 0,
	"msg":   "Транзакция проведена."
}

Чтобы провести платеж через СПБ кроме прочих параметров нужно указать bank_id, который надо определять по полученному данным методом списку.

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

http://money2mobile.ru/api/?operation=get_SBP_bank_list&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=get_SBP_bank_list&customer_id=101&hash=b11e36cadfee38cf5c659f7503b311a8");
$json = curl_exec($ch);
var_dump ( json_decode( $json) );

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

{
	"error": 0,
	"msg":   "Список банков сформирован.",
	"data": [
		{"MemberId":"100000000001","MemberNameRus":"Газпромбанк"},
		{"MemberId":"100000000002","MemberNameRus":"Золотая Корона – Korona (РНКО Платежный Центр)"},
		...
	]
}

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

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

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 сегодня
	}

}