docs update

Author: payuru

README.md

@@ -33,30 +33,29 @@
 
 Пример быстрого старта для приёма платежей:
 ```php
-$merchant = new Merchant('MERCHANT_CODE', 'SECRET_KEY');
+$merchant = new Merchant('MERCHANT_CODE', 'SECRET_KEY'); // Коды подключения API
+$merchantPaymentReference = 123; // Номер заказа в вашей системе
 $billing = (new Billing)
-  ->setCountryCode('RU')
-  ->setFirstName('Иван')
-  ->setLastName('Петров')
-  ->setEmail('test1@ypmn.ru')
-  ->setPhone('+74996492009')
-  ->setCity('Москва');
+  ->setCountryCode('RU') // Страна Плательщика
+  ->setFirstName('Иван') // Имя Плательщика
+  ->setLastName('Петров') // Фамилия Плательщика
+  ->setEmail('test1@ypmn.ru') // Почта Плательщика
+  ->setPhone('+74996492009') // Телефон Плательщика
+  ->setCity('Москва');  // Город Плательщика
 
-$client = (new Client)
-  ->setBilling($billing);
-
+$client = (new Client)->setBilling($billing);
 $payment = (new Payment)
   ->addProduct(new Product([
     'name'  => 'Заказ №' . $merchantPaymentReference,
-    'sku'  => $merchantPaymentReference,
+    'sku'  => 'artikul_test',
     'unitPrice'  => 20.42,
     'quantity'  => 1,
 ]));
 $payment_method = $_GET['method'] ?? PaymentMethods::CCVISAMC; // Определим платёжный метод
 $authorization = new Authorization($payment_method, true);
 $payment->setAuthorization($authorization);
 $payment->setMerchantPaymentReference($merchantPaymentReference);
-$payment->setReturnUrl('https://' . @$_SERVER['HTTP_HOST'] . '/php-api-client/?function=returnPage');
+$payment->setReturnUrl('https://' . $_SERVER['HTTP_HOST'] . '/php-api-client/?function=returnPage');
 $payment->setClient($client);
 $apiRequest = new ApiRequest($merchant);
 $responseData = $apiRequest->sendAuthRequest($payment, $merchant);
@@ -67,7 +66,7 @@ if (isset($responseData["paymentResult"])) {
         $qr = $responseData['paymentResult']['bankResponseDetails']['customBankNode']['qr'];
     }
 
-    // Выведем кнопку оплаты, рекомендуется
+    // Выведем кнопку оплаты (рекомендуется)
     echo Std::drawYpmnButton([
         'qr' => ($qr ?? null),
         'url' => $responseData['paymentResult']['url'] ?? '',
@@ -87,7 +86,7 @@ if (isset($responseData["paymentResult"])) {
 - безопасность и точность расчётов
 
 Библиотека содержит:
-- Клиент API
+- Клиент для работы с API платежей, выплат, отчётов
 - Простой встроенный сервер с примерами
 - Описание контейнера для запуска в Docker
 

src/ApiRequest.php

@@ -368,7 +368,7 @@ private function sendPostPutRequest(
         $curl = curl_init();
         $date = (new DateTime())->format(DateTimeInterface::ATOM);
 
-        $useragent = "SDK_" . @PHP_VERSION;
+        $useragent = "SDK_PHP_" . @PHP_VERSION;
         $referer =  @$_SERVER['HTTP_HOST'] ?? @$_SERVER['SERVER_NAME'] ?? "" . @$_SERVER['REQUEST_URI'] ?? "";
 
         $setOptArray = [

src/Examples/returnPage.php

@@ -1,7 +1,12 @@
 <?php
 /**
- * Страница после оплаты.
- * Параметры передаются в $_GET или $_POST, в зависимости от настройки мерчанта в YPMN:
+ * @deprecated Используйте новые параметры
+ * `successUrl` после успешной оплаты
+ * и `failUrl` после неудачной оплаты
+ * https://ypmn.ru/doc/#tag/payment-api-return-url
+ *
+ * Ниже старая (единая) страница после оплаты.
+ * В ней параметры передаются в $_GET или $_POST, в зависимости от настройки мерчанта в YPMN
  */
 $statusResponseFromServer = (json_decode($_POST['body'] ?? '{}', true))['status'] ?? null;