После того, как ваша компания прошла модерацию, вы можете начать получать средства, используя форму оплаты. Ссылка на форму оплаты доступна в информации о компании и имеет формат https://payz.team/widget /{id}, где{id} - цифровой идентификатор вашего продавца. Чтобы форма работала корректно и открывалась, вы должны отправить клиенту URL-адрес, указав в запросе набор параметров, описанных ниже. Лучший способ - отформатировать параметры отправки с помощью POST-запроса. Это можно сделать с помощью javascript или в скрытой форме, хотя эта форма также будет работать, если параметры просто отправляются методом GET. Но этот метод не считается безопасным Описание параметров формы оплаты client - адрес электронной почты клиентаproduct - Назначение или оплата или название продуктаprice - Цена за одну единицу, умноженная на 100 (если цена составляет 110,55 евро, это значение будет 11055)quantity - Количество, если больше 1, то конечная сумма будет равна количеству*ценаcurrency - Код криптовалюты для оплаты (например usdt)fiat_currency - Код фиатной валюты (rub, uah, kzt) для оплаты, по умолчанию - rubuuid - Уникальный номер платежа в нашей системе. Если вы не используете идентификаторы, просто задайте случайное значение в этом параметреlanguage - Язык транзакции, по умолчанию - rumessage - Краткое сообщение пользователю будет будет отправлено по электронной почте при оплатеdescription - Краткое описание услуги, будет показано в форме оплатыcard_number - Номер карты получателя платежа (Используется только для эквайринга), поле не обязательноеsign - Цифровая подпись данных, строка sha1-кэша, состоящая из спецификации всех параметров запроса и вашего СЕКРЕТНОГО КЛЮЧА:
После совершения платежа пользователь будет отправлен на Успешное перенаправление или Неудачное перенаправление, в зависимости от того, был ли платеж успешным или неудачным соответственно. Ранее отправленный параметр uuid добавляется к Успешному перенаправлению и Неудачному перенаправлению в конце, чтобы вы могли идентифицировать платеж со своей стороны. Поэтому ссылки Success Redirect и Failure Redirect не должны содержать параметров GET.Как только средства поступают на ваш счет, наша система отправляет POST-запрос по указанной ссылке обратного вызова URL. Запрос содержит следующий набор параметров: Пример использования:
status - success для успешной оплаты, fail для отменыclient - электронная почта клиентаcurrency - Валюта платежаamount - Сумма переведенных средствuuid - uuid, который вы отправили при инициализации формы<commission - коммиссия платежного сервисаproduct - Назначение платежа или, наименование продуктаsign - Цифровая подпись данных, строка shal-кэша, состоящая из спецификации всех параметров запроса и вашего SECRET KEY:
Для приема оплаты в криптовалюте параметры ссылки остаются прежними, сумма в параметре price передается в валюте указанной в fiat_currency. Наша система сама пересчитает эквивалент в переданной в параметре currency криптовалюте. На данный момент принимается оплата в ETHEREUM, BITCOIN и USDT (eth, btc, usdt). В случае оплаты через блокчейна, в момент поступления оплаты не представляется возможным определить какой пользователь и за какой товар Вам перевел средства, поэтому и обратный callback не отсылается. Просто приходит уведомление о зачислении средств на ваш счет. Для идентификации необходимо у отправителя запросить идентификатор транзакции и сравнить его со значением идентификатора поступившего платежа в личном кабинете. Если покупка крипты происходила за фиат, то callback будет отправлен.
API для разработчиков
Для создания выплаты необходимо отправить запрос на URL https://payz.team/payout/new, содержащий в body сериализованный объект json, со следующим набором параметров: Для выплаты в крипте: merchant* - Идентификатор магазинаamount* - Сумма средств для зачисления (в абсолютном значении, с плавающей точкой, пр.: 123.45)currency* - Валюта оплатыaddress* - Адрес для переводаtype* - Тип выплатыы (Крипта/фиат). Со значением cryptosign* - Цифровая подпись данных, sha1-хэш строки, состоящей из конкаретации всех значений параметров запроса и Вашего SECRET KEY sha1(merchant+amount+currency+address+type+SecretKey) Для выплаты в фиате: merchant* - Идентификатор магазинаamount* - Сумма средств для зачисления (в абсолютном значении, с плавающей точкой, пр.: 123.45)currency* - Валюта оплатыbank* - Банк выплаты - Альфа кешин,Тинькофф,Сбер,Киви,Тинькофф кешин,Все банки РФ,KZT,EURnumber* - Номер банковской картыmonth* - Месяц из срока действия картыyear* - Год из срока действия картыtype* - Тип выплатыы (Крипта/фиат). Со значением fiatsign* - Цифровая подпись данных, sha1-хэш строки, состоящей из конкаретации всех значений параметров запроса и Вашего SECRET KEY sha1(merchant+amount+currency+number+bank+month+year+type+SecretKey) Если все параметры верны, сервер ответит статусом 201 и пришлет id запроса на выплату
Получение списка выплат
Для создания выплаты необходимо отправить запрос на URL https://payz.team/payout/list, содержащий в body сериализованный объект json, со следующим набором параметров: merchant* - Идентификатор магазинаsign* - Цифровая подпись данных, sha1-хэш строки, состоящей из конкаретации всех значений параметров запроса и Вашего SECRET KEY sha1(merchant+SecretKey) В ответе будет массив items содержащий: id* - ID выплатыstatus* - 0 - создана, 1 - ожидает модерации, 2 - отклонена, 3 - выполненаdata* - Данные переданные при создании выплаты
Wordpress module
Системные требования:- Версия Wordpress - от 3.8- Версия WooCommerce - от 2.0- Версия PHP - от 7.0 Установка:1. Содержимое архива должно быть помещено в папку плагинов Wordpress (по умолчанию - {корень сайта} / wp-content / plugins /)2. Перейдите в раздел администратора сайта (/wp-admin/) и активируйте плагин "WooCommerce - payz" 3. Перейдите в раздел "WooCommerce" - "Настройки" - "Оформить заказ"4. В нижней части страницы в разделе "Платежные шлюзы" нажмите кнопку "Настройки" напротив "payz Payments"5. Введите данные вашего продавца.
Opencart module
Системные требования:- Версия OpenCart - от 3.0- Версия PHP - от 7.0 Установка: 1. Скопируйте папки admin и catalog в корень сайта 2. Перейдите в панель администратора сайта 3. Выберите меню "Дополнения" -> "Оплата" <диапазон> 4. В списке платежей найдите метод "payz" 5. Нажмите кнопку Установить 6. Нажмите кнопку "Изменить" 7. Заполните необходимые поля и сохраните изменения 8. Настройка ЧПУ. Перейдите в раздел "Система" -> "Настройки" -> "Редактировать хранилище" -> Вкладка "Сервер" -> "Включить ЧПУ" (ДА) -> "Сохранить" 9. Настройте перенаправляющую ссылку. Перейдите в раздел "Дизайн" -> "SEO URL" -> "Добавить" -> Ссылка на поле "расширение / оплата / payz / ответ" -> Поле SEO URL "ответ" -> Поле Магазин "По умолчанию" -> Поле язык (выберите язык) * ЧПУ необходимо настроить для каждого языка отдельно 10. Добавьте полученную ссылку (https: // my-site / response) в учетную запись payz “Мой магазин” -> “Настройки” -> “Успешное перенаправление” Полученная ссылка (https: // my-site / response)
Joomla module
Системные требования:- Версия Joomla - от 3.0- Версия Virtuemart - от 3.0- Версия PHP - от 7.0 Установка:1. Чтобы установить модуль приема платежей, вы должны загрузить архив из своего аккаунта payz.2. Установите через установщик модуля в панели администратора (Расширения -> менеджер расширений -> Загрузить файл пакета и т.д.)3. В меню управления модулем активируйте плагин (Расширения -> менеджер расширений -> Управление)4. Затем перейдите на страницу администратора Virtuemart и перейдите в раздел: Компоненты->Virtuemart->Способы оплаты->Добавить способ оплаты)5. Заполните первую вкладку и нажмите "Сохранить"6. Перейдите на вкладку "Конфигурация" (Настройки)7. Заполните поля и нажмите "Сохранить" (для дальнейшей настройки запомните значение параметра cid[] из адресной строки) Настройте ссылки в вашем аккаунте payz - Мой магазин-Настройки1. Успешный URL-адрес - https://joomla.retailcrm.club/index.php/compomemt/com_virtuemart 2. Обратный вызов - https://joomla.retailcrm.club/index.php?option=com_virtuemart&view=pluginresponse&task=pluginnotification&tmpl=component&pm= X (вставьте значение из шага 8 вместо X в конце)3. Неудачный - https://joomla.retailcrm.club/index.php?option=com_virtuemart&view=pluginresponse&task=pluginUserPaymentCancel&pm= X (вставьте значение из шага 8 вместо X в конце)
Drupal module
Системные требования:- Версия Drupal - от 7.х- Версия Commerce - от 1.15- Версия PHP - от 7.1 - 7.4 Установка:Распакуйте архив “{your_site}/admin/modules/install”Войдите в панель администратора и установите -> “КОММЕРЦИЯ (ОПЛАТА) УОЛЛЕКС”. Нажмите кнопку Сохранить.Настройте платежный шлюз payz.. настройки платежного шлюза drupal: drupal commerce & ubercartВведите данные из своего личного кабинета.Настройки платежного шлюза Drupal commerceПлатежный шлюз Drupal от payz позволяет автоматизировать процесс приема платежей с электронных кошельков и любых банковских карт.
1C Bitrix module
Системные требования:- Версия PHP - от 7.2 Установка:Содержимое репозитория должно быть размещено в корневой каталог сайта#После этого необходимо:Перейти в административную часть интернет-магазина.Перейти на страницу "Платежные системы" ("Магазин" - > "Настройки магазина" - > "Платежные системы")Нажмите на кнопку "Добавить платежную систему"Заполните общую информацию о платежной системе.Перейдите на соответствующую вкладку ("Физические лица" или "Юридические лица") и заполните всю необходимую информациюсделайте платежную систему активной и нажмите "Сохранить"Введите ссылки из списка ниже в настройках продавца.URL обратного вызоваhttp://ваш домен/bitrix/tools/payz_result.php Успешное перенаправлениеhttp://ваш домен/личный/заказы/Отмена перенаправлениеhttp://ваш домен/bitrix/tools/payz_fail.php
PHP SDK
Обзор проектаWallet SDK - это набор для разработки программного обеспечения, который предоставляет набор инструментов и утилит для интеграции с платежным шлюзом Payz. Установкаcomposer require sq-dev/payz-sdk
ОсобенностиВ этом разделе описываются основные функции и возможности Wall ex SDK. Функция 1: Создайте платежный виджетuse Payz\Widget;
$payment = new Webhook($_POST); if ($payment->isVerified("secret_key") && $payment->isSuccess()) { // Payment success logic //F.e: $client = $payment->getClient(); // Get client email User::where("email", $client) ->update(["balance" => $payment->getAmount()]); }
Функция 3: выплатыuse Payz\Payout;
$payout = new Payout($merchantId, $secretKey);
$payout->cryptoPay($address, $amount, $currency);
Вклад Мы приветствуем вклад сообщества разработчиков в улучшение Payz SDK. Если вы заинтересованы в добавлении своего вклада в Wall ex SDK, пожалуйста, выполните следующие действия: ЛицензияПакет SDK Payz распространяется по лицензии MIT.
Английский
Казахский
Украинский
