README

Перед подключением платежной системы, убедитесь что соблюдаете следующие требования.

Установка

Wordpress, Magento, CS-Cart, Opencart, PrestaShop, используйте следующие плагины
для установки во фреймворк или в написанный вами код используйте текущую библиотеку

Установить библиотеку можно с помощью интерфейса командной строки при наличии Composer:

composer require sitemd/paynet

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

После установки потребуется подключить автозагрузчик Composer:

require "vendor/autoload.php";

Создайте новый экземпляр класса Paynet.

use Paynet\Paynet;

$paynet = new Paynet($merchantCode, $merchantSecretKey, $merchantSaleAreaCode, $merchantUser, $merchantPassword);

	Тип	Поле
$merchantCode	string	PartnerID (MerchantCode)
$merchantSecretKey	string	SecretKey
$merchantSaleAreaCode	string	SaleAreaCode
$merchantUser	string	User login
$merchantPassword	string	Password

Доступные методы

Версия API Paynet

$paynet->version();

Выбор типа подключения

Если не будет указан тип подключения, по умолчанию будет использоваться тестовый.

$paynet->setMode();

Параметр	Тип	Описание
0	int	тест
1	int	реальный режим

Язык страницы Paynet

Если не будет указан язык, по умолчанию будет использоваться 'ru'.

$paynet->setLang("en");

Параметр	Тип	Описание
ru	string	Русский
ro	string	Română
en	string	English

Уникальный идентификатор заказа

$paynet->setExternalID($id);

Список услуг включённых в платёж

$paynet->setServices($name, $description, $products);

Параметр	Тип	Описание
$name	string	Наименование услуги
$description	string	Описание услуги
$products	array	Набор продуктов

В качестве параметра $products необходимо отправить массив с ниже указанными ключами.

Ключ	Тип	Описание
Name	string	Наименовние продукта
Description	string	Расширенное описание продукта
UnitPrice	int	Стоимость одной единицы продукта
UnitProduct	int	Количество продуктов
Quantity	int	Количество продуктов
Amount	int	Общая стоимость продукта
Barcode	int	Бар код продукта
Code	string	Код продукта
LineNo	int	Порядковый номер продукта
GroupId	string	Идентификатор группы продукта
GroupName	string	Описание группы продукта

Для отправки несколько продуктов необходимо создать многомерный массив $products.

Информация о клиенте

$paynet->setCustomer($code, $nameFirst, $nameLast, $phoneNumber, $email, $country, $city, $address);

Параметр	Тип	Описание
$code	string	Код клиента
$nameFirst	string	Имя клиента
$nameLast	string	Фамилия клиента
$phoneNumber	string	Телефон клиента
$email	string	Электронный адрес клиента
$country	string	Страна клиента
$city	string	Город клиента
$address	string	Адрес клиента

Адрес для перенаправления при успешной оплаты

$paynet->setUrlSucces($url);

Адрес для перенаправления при отклонение оплаты

$paynet->setUrlCancel($url);

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

При успешной авторизации и отправки соответствующих полей будет возвращена форма для перенаправления к сервису Paynet.

echo $paynet->initPayment();

Получение информации о зарегистрированном платеже

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

$paynet->getStatus($id);

Дополнительные методы

Аутентификация и получение токена

Можно использовать для проверки статуса подключении.

$paynet->getToken();

Пример

use Paynet\Paynet;
// Подключение автозагрузчика
require "vendor/autoload.php";
// Укажите ваши данные
$merchantCode = "";
$merchantSecretKey = "";
$merchantSaleAreaCode = "";
$merchantUser = "";
$merchantPassword = "";
$paynet = new Paynet($merchantCode, $merchantSecretKey, $merchantSaleAreaCode, $merchantUser, $merchantPassword);
// Тип подключения, (0 тест, 1 реальный режим)
$paynet->setMode(0);
// Уникальный идентификатор заказа
$id = rand();
$paynet->setExternalID($id);
// Список услуг включённых в платёж
$name = "Service Name 1";
$description = "Service Name Decription 1";
$products = [
   array(
      "Name" => "Product 1", // Наименовние продукта
      "Description" => "Description of product", // Расширенное описание продукта
      "UnitPrice" => 11.12, // Стоимость одной единицы продукта
      "UnitProduct" => 2, // Количество продуктов
      "Amount" => 22.24, // Стоимость продукта
      "Barcode" => 123456, // Бар код продукта
      "Code" => "Product-1", // Код продукта
      "LineNo" => 1, // Порядковый номер продукта
      "GroupId" => "1", // Идентификатор группы продукта
      "GroupName" => "A group name of this product" // Описание группы продукта
   ),
   array(
      "Name" => "Product 2",
      "Description" => "Description of product",
      "UnitPrice" => 11.12,
      "UnitProduct" => 1,
      "Amount" => 11.12,
      "Barcode" => 234567,
      "Code" => "Product-2",
      "LineNo" => 1,
      "GroupId" => "1",
      "GroupName" => "A group name of this product"
   )
];
$paynet->setServices($name, $description, $products);
// Информация о клиенте
$code = "Customer Code";
$nameFirst = "Payer first name";
$nameLast = "Payer last name";
$phoneNumber = "Payer phone number";
$email = "Payer email";
$country = "Payer country";
$city = "Payer city";
$address = "Payer address";
$paynet->setCustomer($code, $nameFirst, $nameLast, $phoneNumber, $email, $country, $city, $address);
$paynet->setUrlSucces('https://example.com/success');
$paynet->setUrlCancel('https://example.com/cancel');
// Инициализация оплаты
echo $paynet->initPayment();

sitemd / paynet

Maintainers

Details