Документация

Параметры подключения к API

Для того чтобы вызвать метод API, необходимо отправить запрос на https://www.имя_хоста/api/

Общие принципы работы API

Параметры передаются одним из методов:

— GET

— POST

Создание заказа

Запрос на https://www.имя_хоста/api/
Инициирует приём платежа через мобильную коммерцию

Параметры

phone	номер телефона клиента (Формат: 7XXXXXXXXXX)
description	описание платежа (придёт в SMS-сообщении клиенту) длина — от 10 до 100 символов
amount	цена услуги
merchant_order_id	ID платежа в системе продавца необязательный параметр
success_message	текст успешного SMS-сообщения необязательный параметр, длина — от 10 до 70 символов
service_id	ID сервиса продавца, к которому относится платеж
test	0 — для реальных платежей (по умолчанию). 1 — для тестовых платежей. Если выбран тестовый режим — платежи не проводятся через биллинг, а просто записываются в БД. необязательный параметр
sign	подпись запроса. Алгоритм генерации подписи: md5(PHONE + ”?”+ AMOUNT +”?”+ SECRET_KEY), где: • PHONE – номер телефона в точности как в поле PHONE • AMOUNT – цена услуги в точности как в поле AMOUNT • SECRET KEY — секретный ключ (задаётся в настройках проекта)

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

https://www.имя_хоста/api/?phone=79201234567&amount=10&descripion=Тестовый платеж&success_message=Все ок. Ваш платеж принят &sevice_id=1&test=0&sign=d2576c0ea9538131e65f70aa13cc71d8

[params] => Array
	(
		[phone] => 79201234567
		[description] => Тестовый платеж
		[amount] => 10
		[success_message] => Все ок. Ваш платеж принят
		[service_id] => 1
		[test] => 0
		[sign] => d2576c0ea9538131e65f70aa13cc71d8
	)

Результат

order_id — ID платежа в системе мобильной коммерции

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

10a:1:{s:8:»order_id»;i:6;}

Уведомления об изменении статуса заказа

Запрос инициирует сервисом мобильной коммерции. Обращается к URL, указанному вами в настройках сервиса.
По умолчанию: GET.

Параметры

method	метод на стороне покупателя, для которого происходит доставка. Возможные методы: notifyStatus — уведомление о статусе платежа
service_id	ID сервиса продавца, к которому относится платеж
date	дата запроса. Формат: UNIXвремя. Часовой пояс — UTC+3.
order_id	ID платежа в системе мобильной коммерции
merchant_order_id	ID платежа в системе продавца (0, если не был указан при инициации)
status	cтатус платежа
phone	номер телефона абонента
operator	оператор сотовой связи абонента
amount	цена услуги (сумма инициации платежа)
amount_charged	сумма, причитающаяся продавцу
sign	подпись. Генерится по тому же алгоритму, что и подпись для исходящих запросов.

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

[params] => Array
	(
		[method] => notifyStatus
		[service_id] => 100127
		[date] => 1418299945
		[order_id] => a6dxhzgeThG05CmGNmdRWw
		[merchant_order_id] => 0
		[status] => 21
		[phone] => 79261999885
		[operator] => mf
		[amount] => 11
		[amount_charged] => 9.9
		[sign] => 81b09757079bc7a07ef973cd180ef01d
	)

Запрос отправляется до 5 раз или до получения кода 200 от сервера.

Возможные статусы платежа

1 — ожидает обработки
2 — оплачен
4 — ошибка, недостаточно средств
5 — внутренняя ошибка системы
6 — отменено покупателем
7 — отменено продавцом
8 — возвращено покупателю
9 — обрабатывается гейтом
10 — ожидает отправки на инициацию
11 — необходимо подтверждение инициации
12 — нет ответа от сервера оператора
13 — лимит по количеству платежей за сутки
14 — лимит по сумме оплаты за сутки
15 — лимит по сумме оплаты за неделю
16 — лимит по минимальному остатку на счете
17 — предыдущий платеж не завершен
18 — услуга недоступна для абонента
19 — время ожидания абонента истекло
20 — превышены другие лимиты
21 — не оплачен (по другой причине)
22 — сумма платежа меньше допустимой