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


Общее описание

Система приема платежей WAY to PAY имеет простой интерфейс, позволяющий Вам как владельцу магазина получать оплату в любой электронной валюте от своих покупателей.

Процесс оплаты услуг SMS, через терминал или электронной валютой происходит простым способом через безопасное соединение, что делает всю операцию не только надежной и конфиденциальной, но и быстрой.

  • Покупатель выбирает товар и способ оплаты в Вашем он-лайн магазине и магазин, в свою очередь, подсчитывает сумму к оплате.
    Сервер системы WAY to PAY получает требуемую информацию о сумме и валюте для осуществления платежа.
    При необходимости, наша система приема платежей производит титульный обмен, и Вы получаете требуемую сумму в желаемой валюте на кошелек, указанный при регистрации.
    После оплаты, Ваш покупатель перенаправляется на страницу с оплаченным товаром (на страницу с неудавшейся операцией).

У Вас как у владельца сайта нет необходимости подключать массу прихотливых модулей, защищенных соединений и компонентов.
Используя систему приёма платежей на сайте WAY to PAY, Вы обходите прямое подключение к серверу приёма webmoney и других электронных систем. Это и есть главное преимущество нашей системы. Вы делаете автоматический прием платежей проще, удобнее и безопаснее как для себя, так и для Ваших уважаемых покупателей.

WAY to PAY – качество, безопасность и простота в использовании!

  • Если Вы желаете подключиться к системе приёма платежей на сайте Way to Pay, то при регистрации Вам потребуется ввести соответствующие номера счетов. В дальнейшем, любые действия по изменению и регистрации новых счетов, будут доступны при вводе секретного слова. Это делается с целью Вашей безопасности и отсутствия возможности вывода Ваших средств третьими лицами.

Для Вашего удобства, мы разработали удобный XML интерфейс с целью отслеживания состояния операций и текущих курсов системы. Таким образом, Вы можете всегда видеть любую интересующую Вас информацию, касающуюся оплат услуг SMS-ками или электронными деньгами.

  • Несмотря на всю кажущуюся сложность процесса приема платежей на сайте, всё происходит в считанные минуты с использованием простого и интуитивно понятного интерфейса. Покупатель, приобретающий товар в Вашем интернет магазине видит лишь удобное окно с возможностью выбора способа оплаты. Вы же, в свою очередь, получаете на свой счет, указанный при регистрации, заявленную сумму, независимо от того в какой валюте покупатель оплатил заказ.

Для того чтобы наглядно понять и посмотреть на систему приема платежей WAY to PAY в действии, мы предлагаем Вам изучить компоненты сервиса:


Сделайте приём webmoney или SMS оплату на своём сайте максимально комфортной для покупателей, ведь мы сделали всё за Вас!

Пройдите регистрацию, подключитесь к системе, установите и настройте, принимайте платежи в удобной для Вас валюте!

Состав сервиса WAY to PAY



Интерфейс оплаты

Код встраиваемой кассы со списком возможных валют оплаты

Для быстрой инициализации оплаты Вы можете  воспользоваться специальный JavaScript кодом который выводит удобное окно с выбором способа оплаты. 

Action - https://waytopay.org/api/interface/  

Method - GET

Fields - поля передаваемые в форме, описаны в таблице ниже:

Название HTML Field Form Обязательный? Описание
ID сервиса MerchantId Да ID сервиса в системе
Сумма платежа OutSum Да Сумма требуемая к получению
Номер счета InvId Да Номер счета в магазине (число должно быть уникальное)
Описание InvDesc Да Описание платежа (максимум 255 символов)
Кодировка Encoding Нет Кодировка в которой возвращается окно оплаты (по умолчанию utf-8)
Дополнительные параметры продавца Определяется продавцом Нет Дополнительные параметры (в сумме до 2048 символов)

Пример:
<script language='javascript' type='text/javascript' src='https://waytopay.org/api/interface/?MerchantId=6&OutSum=10.23&InvId=1&InvDesc=Technical+documentation+on+WayToPay&Shp_item=2'></script>  

Инициализация оплаты

Для инициализации оплаты, магазин должен отправить покупателя по данному адресу с передачей параметров. Предварительно заполнив параметры (номер счета, сумма)

Action - https://waytopay.org/merchant/index/

Method - POST/GET

Fields - поля передаваемые в форме, описаны в таблице ниже:

Название HTML Field Form Обязательный? Описание
ID сервиса MerchantId Да ID сервиса в системе
Сумма платежа OutSum Да Сумма требуемая к получению
Номер счета InvId Да Номер счета в магазине (число должно быть уникальное)
Описание InvDesc Да Описание платежа (максимум 255 символов)
Id валюты IncCurr Нет Id валюты платежа (смотрите список валют)
Дополнительные параметры продавца Определяется продавцом Нет Дополнительные параметры (в сумме до 2048 символов)

Пример:
<form action='https://waytopay.org/merchant/index' method='post'>
<input type=hidden name=MerchantId value=6>
<input type=hidden name=OutSum value=10.23>
<input type=hidden name=InvId value=1>
<input type=hidden name=InvDesc value='Техническая документация по WayToPay'>
<input type=hidden name=IncCurr value=1>
<input type=submit value='Купить'>
</form>

Оповещение об оплате (ResultURL)

После поступления платежа от ваших покупателей, наш Сервис отправляет запрос на ResultURL
который Вы указали в настройках сервиса.
На стороне магазина по адресу RusultURl должен быть установлен скрипт-обработчик,
который проверяет поступившие данные (сумма, номер счета, контрольная подпись).

После успешной проверки данных скрипт должен вернуть строку OK_wInvId
(к примеру номер счета 1, то скрипт должен вернуть OK_1)
В случае неудачной проверки данных скрипт должен вернуть строку "ERROR_текст ошибки" (без кавычек)

Action - ResultURL

Method - POST/GET/EMAIL

Fields - передаваемые поля, описаны в таблице ниже:

Название HTML Field Form Обязательный? Описание
Сумма платежа wOutSum Да Сумма поступившая на счет клиента
Номер счета wInvId Да Номер счета в магазине
Тестовый платеж wIsTest Да 1 - платеж тестовый
0 - платеж рабочий
Подпись секретная wSignature Да Контрольная сумма md5 (формирование подписи secret_key)
Дополнительные параметры продавца Определяется продавцом Нет Дополнительные параметры (в сумме до 2048 символов)

Переадресация пользователя при успешной оплате (SuccessURL)

После успешного проведения платежа, Покупатель будет перенаправлен на SuccessURL который Вы задали в настройках сервиса.
На данной странице, Покупатель должен быть проинформирован о том, что покупка прошла успешно.
Для надежности Вы можете проверить параметр wSignature в Вашем скрипте по адресу SuccessURL
Не используйте SuccessURL как скрипт-обработчик!

Action - SuccessURL

Method - POST/GET

Fields - передаваемые поля, описаны в таблице ниже:

Название HTML Field Form Обязательный? Описание
Сумма платежа wOutSum Да Сумма поступившая на счет клиента
Номер счета wInvId Да Номер счета в магазине
Дополнительные параметры продавца Определяется продавцом Нет Дополнительные параметры (в сумме до 2048 символов)

Переадресация пользователя при отказе от оплаты (FailURL)

После НЕ успешного проведения платежа, Покупатель будет перенаправлен на FailURL который Вы задали в настройках сервиса.
На данной странице, Покупатель должен быть проинформирован о том, что покупка прошла НЕ успешно.
Для надежности Вы можете проверить параметр wSignature в Вашем скрипте по адресу FailURL
Не используйте FailURL как скрипт-обработчик!

Action - FailURL

Method - POST/GET

Fields - передаваемые поля, описаны в таблице ниже:

Название HTML Field Form Обязательный? Описание
Сумма платежа wOutSum Да Сумма поступившая на счет клиента
Номер счета wInvId Да Номер счета в магазине
Подпись инициализации wSignature Да Контрольная сумма md5 (формирование подписи init_key)
Дополнительные параметры продавца Определяется продавцом Нет Дополнительные параметры (в сумме до 2048 символов)

Формирование подписи secret_key

Формирование подписи производится путем склеивания параметров через ":" и создание контрольной суммы MD5

Склеиваются параметры service_id, wOutSum, wInvId, секретный ключ и параметры магазина в формате "...secret_key:Shop_item=1:Shop_param=hi"

Пример PHP:
$service_id = 9;

$secret_key = '01bd14-d8074a-9b37bc-884d24-e060';

$signature = md5( "$service_id:$wOutSum:$wInvId:$secret_key" );

Список валют

ID Название
1 WMR
2 WMZ
3 WME
4 WMU
14 Яндекс.Деньги
5 SMS
6 QIWI
7 Единый кошелек (W1)
8 Z-Payment
9 RBK Money
10 VISA / MasterCard
11 Деньги@Mail.ru
12 Терминалы России
13 Терминалы Украины




Интерфейс СМС биллинга

Как это работает?

Для регистрации нового SMS Биллинга, Вам нужно зайти в систему под своим логином и перейти в раздел "Сервисы"
После чего "Создать новый SMS сервис". Заполнить все необходимые поля и дождаться активации сервиса

Для приёма оплаты по SMS, Ваши покупатели должны отправить SMS вида "WTP prefix text"
Список номеров и наших префиксов можно получить из XML/JSON
После отправки SMS наш робот отправляет запрос на Result URL с параметрами
Ваш скрипт должен подтвердить оплату и выдать покупателю заказ после чего выслать в ответ текст который будет передан покупателю.

Запрос списка номеров

Список номеров, стран, операторов и стоимости СМС Вы можете запросить через наш API интерфейс

Action XML - https://waytopay.org/api/getsmsxml/ид_сервиса
Action JSON - https://waytopay.org/api/getsmsjson/ид_сервиса

Method - GET

Fields - поля получаемые в XML/JSON, описаны в таблице ниже:

Название XML/JSON Field Form
Код страны country
Название страны country_name
Код оператора operator code
Имя оператора operator name
Короткий номер operator number
Префикс operator prefix
Стоимость SMS в местной валюте без НДС operator price
Заработок с SMS в местной валюте с НДС operator price_vat
Стоимость SMS в рублях без НДС operator price_rub
Стоимость SMS в рублях с НДС operator price_rub_vat
Заработок с SMS в Рублях operator profit
Местная валюта operator currency
Комментарий operator comment
Фрод лимит, в USD operator frod

Оповещение об оплате (ResultURL)

После поступления SMS от ваших покупателей, наш Сервис отправляет запрос на ResultURL
который Вы указали в настройках сервиса.
На стороне магазина по адресу RusultURL должен быть установлен скрипт-обработчик,
который проверяет поступившие данные (сумма, номер счета, контрольная подпись).

После успешной проверки данных скрипт должен вернуть строку "OK_текст смс" (без кавычек) которая будет отправлена по СМС покупателю
В случае неудачной проверки скрипт должен вернуть строку "ERROR_текст ошибки" (без кавычек)

Method - POST/GET/EMAIL

Fields - поля передаваемые в форме, описаны в таблице ниже:

Название HTML Field Form Обязательный? Описание
Сумма платежа wOutSum Да Сумма полученная в результате отправки SMS
Номер счета wInvId Да Номер счета в системе
Тестовый платеж wIsTest Да 1 - платеж тестовый
0 - платеж рабочий
Короткий номер wNumber Да Номер на который отправили SMS
Номер телефона wPhone Да Номер с которого отправили SMS
Текст сообщения wText Да Текст котрой был отправлен
Стоимость SMS wCost Да Стоимость SMS в Рублях
Прибыть с SMS wProfit Да Прибыль с SMS в Рублях
Страна wCountry Да Страна отправителя
Контрольная подпись wSignature Да Контрольная сумма md5 (формирование подписи)

Формирование подписи

Формирование подписи производится путем склеивания параметров через ":" и создание контрольной суммы MD5

Склеиваются параметры service_id, wOutSum, wInvId, секретный ключ, wNumber, wPhone, wText, wCost, wProfit, wCountry

Пример PHP:
$service_id = 9;

$secret_key = '01bd14-d8074a-9b37bc-884d24-e060';

$signature = md5( "$service_id:$wOutSum:$wInvId:$secret_key:wNumber=$wNumber:wPhone=$wPhone:wText=$wText:wCost=$wCost:wProfit=$wProfit:wCountry=$wCountry" );


Дополнительные функции

Автоматический повтор запроса

Автоматический повтор запроса - данная функция предназначена для автоматического повтора запроса от нашего сервиса к Вашему скрипту

При включении этой функици наш сервис будет повторять запрос 3 раза (раз в 10 минут), в том случае, если Ваш скрипт оказался недоступен, либо вернул ошибку

Экспорт статистики в CSV

Вы можете экспортировать статистику любого сервиса в CSV файл для использования в автоматических скриптах, либо для своих целей.

Помимо обязательных параметров в запрос списка можно включить дополнительные - для фильтрафии:

Method - GET

Fields - поля передаваемые в форме, описаны в таблице ниже:

Название HTML Field Form Описание
Статус платежа status 50 - оплачен; 10- оплачен смс, но не выплачен; 5 - не оплачен
Начальная временная точка start_time В формате UNIX TIME
Конечная временная точка stop_time В формате UNIX TIME