Чтобы узнать, какая версия спецификации используется в Вашем проекте, нужно перейти к пункту меню «Управление услугами». В настройках нужного проекта выбрать пункт «общие настройки». В блоке внизу указывается версия спецификации, используемая в Вашем проекте, с комментариями.

Как только пользователь переводит оплату, и этот перевод оказывается на Вашем счету, Paysera обращается по указанному callbackurl и передаёт всю необходимую информацию о произведённом платеже.

Параметр callbackurl это адрес скрипта на Вашем сайте информирующий систему Paysera о получении запроса о произведённом платеже. Ответ генерируется следующим образом:

1. Создайте каталог.

Создайте каталог с названием libwebtopay, в котором хранятся все файлы, связанные с интеграцией оплат.

2. Скачайте библиотеку libwebtopay.

В созданный каталог libwebtopay скачайте файл WebToPay.php.

3. Создайте callback.php.

В каталоге libwebtopay создайте файл с названием callback.php. Файл должен содержать:

<?php
require_once('libwebtopay/WebToPay.php');

try {
    $response = WebToPay::checkResponse($_GET, array(
            'sign_password' => 'секрет',

            // Путь к файлу, где регистрируются все запросы
            // Если используете эту функцию, убедитесь, что log файл
            // не доступен снаружи.
            //'log'           => 'webtopay.log',
        ));

    echo 'OK Spasibo za otpravku';
}
catch (Exception $e) {
    echo get_class($e).': '.$e->getMessage();
}

Методу WebToPay::checkResponse необходимо передать все данные из Paysera. Это необходимо для проверки целостности файла. Если не будет хватать хоть одного параметра или не совпадут значения параметров, будет вызвано исключение WebToPayException.

Параметр Длина Обязателен Описание
sign_password 32 Да Пароль проекта. Вы можете его найти подключившись к своей учётной записи Paysera, выбрать "управление услугами", далее, выбрав конкретный проект "общие настройки".

После $_GET проверки данных, если всё в порядке, необходимо вернуть ответ, как это сделано в примере выше (echo 'OK';). Возможные варианты ответа:

OK <текст>
Указанный после ключевого слова OK текст будет отправлен обратно, как ответное сообщение.
Например: "OK Spasibo za otpravku" (будет отправлено ответное сообщение: "Spasibo za otpravku").
NOSMS
В этом случае отправитель не получит никакого ответа, а ответ Вы сможете отправить поззже (в течение недели).
WAPPUSH <url> <текст>
Система отправит ответ отправителю методом Wap Push.
Например: "WAPPUSH http://www.address.com/services/link описание услуги".

4. Отправка ответного сообщения.

Если вы не отправили ответного сообщения сразу же с OK <текст>, ответ Вы сможете отправить поззже (в течение недели), используя эту функцию libwebtopay:

<?php

// Включает в себя библиотеку webtopay
require_once('libwebtopay/WebToPay.php');

try {
    // Проверка данных ответа о произведенной оплате
    WebToPay::smsAnswer(array(
            // Уникальный номер сообщения в нашей системе. Номер вы получили вместе с сообщением.
            'id'            => 0,

            // Ответное сообщение
            'msg'           => 'Spasibo za otpravku',

            // Сгенерирован ваш новый пароль проекта в системе paysera.com
            'sign_password' => 'sekret',

            // Путь к файлу, где регистрируются все запросы
            // Если используете эту функцию, убедитесь, что log файл
            // не доступен снаружи.
            //'log'           => 'webtopay.log',
        ));
}
catch (Exception $e) {
    echo get_class($e).': '.$e->getMessage();
}

Для интеграции системы макро- платежей рекомендуем использовать подготовленную нами программную библиотеку с открытым исходным кодом – libwebtopay . Библиотека выполняет все необходимые проверки сохранности передаваемых и получаемых данных.

Скачайте самую новую версию libwebtopay в желаемом формате:

Чтобы libwebtopay работала успешно, из находящихся в архиве файлов достаточен только один файл libwebtopay/WebToPay.php. Остальные файлы предназначены для тестов, примеров и пояснений. Самую новую версию файла libwebtopay/WebToPay.php (только одного файла) можно скачать по адресу:

Также можете скачать вариант с различными версиями (из Mercurial VCS):

$ hg clone https://bitbucket.org/paysera/libwebtopay/

Внимание: libwebtopay можно использовать как с услугами макро-, так и микро- платежей.

Можете испробовать libwebtopay, запустив подготовленный демонстрационный сценарий. Демонстрацию можете запустить, набрав в адресной строке Интернет-браузера:

http://www.yourwebsiteurl.com/libwebtopay/demo/

Внимание: в адресе указанный путь к demo каталогу может отличаться в зависимости от того, куда вы поместили содержимое архива.

Внимание: для того, чтобы демо успешно функционировало укажите номер вашего проекта в системе Paysera, в поле projectid. Демо не будет работать, если будете пробовать запускать её с Вашего компьютера (localhost).

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

Paysera отправляет ответ по указанному Вами callbackurl адресу. К указанному Вами callbackurl адресу добавляются дополнительные GET параметры, список которых размещён ниже. Все эти параметры передаются с префиксом wp_.

Параметр Описание
to Короткий номер, на который было отправлено сообщение
sms Содержание сообщения с ключевым и суб-ключевым словом (до 160 символов).
from Мобильный номер, с которого было отправлено сообщение.
operator Оператор мобильной сети ("Bitė", "TELE2", "Omnitel", "Orange", "LMT" и т.д.).
amount Цена сообщения для клиента в центах. Например, 100 (1 литовский лит), 500 (5 литовских литов) и т.д.
currency Валюта (USD, EUR), в которой вы предпочитаете получать платежи клиента. Если указанная валюта не может быть принята посредством выбранного метода оплаты, система автоматически конвертирует сумму в поддерживаемую валюту по курсу текущего дня. В ответе на Ваш сайт будут переданы payamount и paycurrency.
country Двухзначный код страны. (LT, EE, LV, UA, RU и т.д.)
id Уникальный номер сообщения в системе Paysera
_ss2 Параметр, с помощью которого проверяется факт получения ответа из нашего сервера. Подобный метод проверки гарантирует максимальную надёжность.
_ss1v2 Параметр, с помощью которого проверяется факт получения ответа из нашего сервера. Подобный метод проверки менее надёжен, чем _ss2
test Параметр, при наличии которого можно тестировать соединение. Оплата не производится и результат возвращается сразу, как будто бы оплата была произведена. Для того, чтобы протестировать, необходимо активировать режим теста возле выбранного проекта. Путь: "Управление проектами" -> "Услуга сбора платежей" (возле конкретного проекта) -> "Разрешить тестовую оплату" (отметить).
key Ключевое слово