vskut/webmoney-merchant

WebMoney Merchant - PHP Library

О библиотеке WebMoney Merchant

Эта библиотека должна помочь вам в работе с интерфейсом WebMoney Merchant: https://wiki.webmoney.ru/projects/webmoney/wiki/Web_Merchant_Interface, _(*1)

Навигация

1. О библиотеке WebMoney Merchant
   • Навигация
2. Установка через Composer
3. Использование
   • Генерация формы
   • RESULT обработчик
4. Настройка WebMoney Merchant
   • Переходим к настройке кошелька
   • Настройка кошелька

Установка через Composer

1. Устанавливаем Composer:, _(*2)

   curl -sS https://getcomposer.org/installer | php
   

2. Добавляем WebMoney Merchant в зависимость:, _(*3)

   php composer.phar require vskut/webmoney-merchant:*@dev
   

Использование

Генерация формы

Пример: https://github.com/VSKut/WebMoney-Merchant/blob/master/examples/form.php, _(*4)

Подключаем класс любым доступным образом, _(*5)

Native:, _(*6)

require_once('../src/WMMerchantForm.class.php');

Composer:, _(*7)

require_once(__DIR__.'/vendor/autoload.php');

Используем пространство имён, _(*8)

use VSKut\WebMoney_Merchant\WMMerchantForm;

Передаём кошелёк продавца, _(*9)

$merchantForm = new WMMerchantForm('R000000000000');

Устанавливаем сумму для оплаты, _(*10)

$merchantForm->setAmount(123.45);

Устанавливаем описание платежа, _(*11)

$merchantForm->setDescription('Это описание платежа');

Устанавливаем номер платежа, _(*12)

$merchantForm->setPaymentNumber(12);

Устанавливаем дополнительные параметры (не обязательно), _(*13)

$merchantForm->setDataCustom(array(
    'USER_ID' => 15,
    'ITEM_ID' => 24,
    'CATEGORY_ID' => 1,
));

Передаём RESULT Url посредством формы (не обязательно), _(*14)

Для использования своих URL через форму не забудьте выставить в настройках кошелька галочку на "Позволять использовать URL, передаваемые в форме", _(*15)

$merchantForm->setResultUrl('http://vskut.ru/result.php');

Передаём SUCCESS Url и тип вызова посредством формы (не обязательно), _(*16)

Для использования своих URL через форму не забудьте выставить в настройках кошелька галочку на "Позволять использовать URL, передаваемые в форме", _(*17)

$merchantForm->setSuccessUrl('http://vskut.ru/success.php', 2);
/*
 * * Типы вызова:
 * 0 - GET
 * 1 - POST
 * 2 - URL
 * */

Передаём FAIL Url и тип вызова посредством формы (не обязательно), _(*18)

Для использования своих URL через форму не забудьте выставить в настройках кошелька галочку на "Позволять использовать URL, передаваемые в форме", _(*19)

$merchantForm->setFailUrl('http://vskut.ru/fail.php', 2);
/*
 * * Типы вызова:
 * 0 - GET
 * 1 - POST
 * 2 - URL
 * */

В конец формы добавляем JS скрипт с автоматической отправкой формы (не обязательно), _(*20)

$merchantForm->setAutoSendForm();

Получаем HTML сгенерированной формы, _(*21)

$html = $merchantForm->getHTML();

Just do it :), _(*22)

echo $html;

RESULT обработчик

Пример: https://github.com/VSKut/WebMoney-Merchant/blob/master/examples/result.php, _(*23)

Подключаем класс любым доступным образом, _(*24)

Native:, _(*25)

require_once('../src/WMMerchantCallback.class.php');

Composer:, _(*26)

require_once(__DIR__.'/vendor/autoload.php');

Используем пространство имён, _(*27)

use VSKut\WebMoney_Merchant\WMMerchantCallback;

Передаём кошелёк продавца, секретный ключ, POST данные, _(*28)

$merchantCallback = new WMMerchantCallback('R000000000000', '000000000000000', $_POST);

Устанавливаем стоимость (не обязательно), _(*29)

Если не установлено, то стоимость проверяться не будет и скрипт пропустит все платежи вне зависимости от суммы, _(*30)

$merchantCallback->setAmount(123.45);

Проверяем данные запроса на валидность, _(*31)

if ($merchantCallback->isInvalidData()) {

    echo $merchantCallback->getError();
    exit();

}

Проверяем тип запроса (pre-request или finally-request), _(*32)

if ($merchantCallback->isPreRequest()) {

    /*
     * * Пришёл предварительный запрос, деньги от пользователя ещё не переведены
     * 1) Если нужно, то выполняем любые иные проверки
     * */

     $array = $merchantCallback->getData();

     $array = $merchantCallback->getDataCustom();

     /*
     * 2) Возвращаем успешный ответ "YES" и тем самым разрешаем выполнить запрос
     * */

    echo 'YES';

} else {

    /*
     * * Пришёл окончательный запрос, деньги уже у нас на кошельке
     * 1) Если нужно, то выполняем любые иные проверки
     * */

     $array = $merchantCallback->getData();

     $array = $merchantCallback->getDataCustom();

     /*
     * 2) Производим выдачу товара
     * */

}

Настройка WebMoney Merchant

Переходим к настройке кошелька

1. Переходим на https://merchant.webmoney.ru
2. Проходим авторизацию
3. Идём в настройки https://merchant.webmoney.ru/conf/purses.asp
4. Напротив нужного кошелька выбираем настроить

Настройка кошелька

1. Указываем тестовый либо рабочий режим работы
2. Указываем торговое имя
3. Указываем Secret Key
4. Указываем Result URL
5. Выбираем check-box [x] Передавать параметры в предварительном запросе
6. Указываем Success URL и метод его вызова
7. Указываем Fail URL и метод его вызова
8. При необходимости выбираем check-box [x] Позволять использовать URL, передаваемые в форме
9. Выбираем в Метод формирования контрольной подписи - SHA256
10. Сохраняем :)