Документация
Система приема платежей WAY to PAY имеет простой интерфейс, позволяющий Вам как владельцу магазина получать оплату в любой электронной валюте от своих покупателей.
Процесс оплаты услуг SMS, через терминал или электронной валютой происходит простым способом через безопасное соединение, что делает всю операцию не только надежной и конфиденциальной, но и быстрой.
- Покупатель выбирает товар и способ оплаты в Вашем он-лайн магазине и магазин, в свою очередь, подсчитывает сумму к оплате.
Сервер системы WAY to PAY получает требуемую информацию о сумме и валюте для осуществления платежа.
При необходимости, наша система приема платежей производит титульный обмен, и Вы получаете требуемую сумму в желаемой валюте на кошелек, указанный при регистрации.
После оплаты, Ваш покупатель перенаправляется на страницу с оплаченным товаром (на страницу с неудавшейся операцией).
У Вас как у владельца сайта нет необходимости подключать массу прихотливых модулей, защищенных соединений и компонентов.
Используя систему приёма платежей на сайте WAY to PAY, Вы обходите прямое подключение к серверу приёма webmoney и других электронных систем. Это и есть главное преимущество нашей системы. Вы делаете автоматический прием платежей проще, удобнее и безопаснее как для себя, так и для Ваших уважаемых покупателей.
WAY to PAY – качество, безопасность и простота в использовании!
- Если Вы желаете подключиться к системе приёма платежей на сайте Way to Pay, то при регистрации Вам потребуется ввести соответствующие номера счетов. В дальнейшем, любые действия по изменению и регистрации новых счетов, будут доступны при вводе секретного слова. Это делается с целью Вашей безопасности и отсутствия возможности вывода Ваших средств третьими лицами.
Для Вашего удобства, мы разработали удобный XML интерфейс с целью отслеживания состояния операций и текущих курсов системы. Таким образом, Вы можете всегда видеть любую интересующую Вас информацию, касающуюся оплат услуг SMS-ками или электронными деньгами.
- Несмотря на всю кажущуюся сложность процесса приема платежей на сайте, всё происходит в считанные минуты с использованием простого и интуитивно понятного интерфейса. Покупатель, приобретающий товар в Вашем интернет магазине видит лишь удобное окно с возможностью выбора способа оплаты. Вы же, в свою очередь, получаете на свой счет, указанный при регистрации, заявленную сумму, независимо от того в какой валюте покупатель оплатил заказ.
Для того чтобы наглядно понять и посмотреть на систему приема платежей WAY to PAY в действии, мы предлагаем Вам изучить компоненты сервиса:
- Интерфейс оплаты;
- Инициализация оплаты;
- Оповещение об оплате;
- Переадресация покупателя при удачной оплате;
- Переадресация покупателя при неудачной оплате;
- Интерфейс СМС-биллинга;
- Формирование подписей.
Сделайте приём webmoney или SMS оплату на своём сайте максимально комфортной для покупателей, ведь мы сделали всё за Вас!
Пройдите регистрацию, подключитесь к системе, установите и настройте, принимайте платежи в удобной для Вас валюте!
Интерфейс оплаты
Код встраиваемой кассы со списком возможных валют оплаты
Для быстрой инициализации оплаты Вы можете воспользоваться специальный JavaScript кодом который выводит удобное окно с выбором способа оплаты.
Action - https://waytopay.org/api/interface/
Method - GET
Fields - поля передаваемые в форме, описаны в таблице ниже:
| Название | HTML Field Form | Обязательный? | Описание |
| ID сервиса | MerchantId | Да | ID сервиса в системе |
| Сумма платежа | OutSum | Да | Сумма требуемая к получению |
| Номер счета | InvId | Да | Номер счета в магазине (число должно быть уникальное) |
| Описание | InvDesc | Да | Описание платежа (максимум 255 символов) |
| Кодировка | Encoding | Нет | Кодировка в которой возвращается окно оплаты (по умолчанию utf-8) |
| Дополнительные параметры продавца | Определяется продавцом | Нет | Дополнительные параметры (в сумме до 2048 символов) |
Пример:
Инициализация оплаты
Для инициализации оплаты, магазин должен отправить покупателя по данному адресу с передачей параметров. Предварительно заполнив параметры (номер счета, сумма)
Action - https://waytopay.org/merchant/index/
Method - POST/GET
Fields - поля передаваемые в форме, описаны в таблице ниже:
| Название | HTML Field Form | Обязательный? | Описание |
| ID сервиса | MerchantId | Да | ID сервиса в системе |
| Сумма платежа | OutSum | Да | Сумма требуемая к получению |
| Номер счета | InvId | Да | Номер счета в магазине (число должно быть уникальное) |
| Описание | InvDesc | Да | Описание платежа (максимум 255 символов) |
| Id валюты | IncCurr | Нет | Id валюты платежа (смотрите список валют) |
| Дополнительные параметры продавца | Определяется продавцом | Нет | Дополнительные параметры (в сумме до 2048 символов) |
Пример:
<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:$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:$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 |
Содержание
- Общее описание
- Состав сервиса WAY to PAY
Последние
новости
-
17.05.12
Произведены корректировки и SMS выплаты по 13 мая [...]
-
11.05.12
Произведены корректировки и SMS выплаты по 6 мая [...]
-
10.05.12
В связи с официальным выходным днем 9 мая, партнерские выплаты за 18-ую нед... [...]
Статистика
- Всего операций: 287998
- За сегодня: 752
- Благот. фонд: 2297.67 руб.

