Войти | Регистрация

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

Параметры подключения к 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. Позвонить по телефону: +7 (495) 545-41-43

2. Написать нам письмо: info@pay-telecom.com

3 . Воспользоваться формой обратной связи.