Merge pull request #7 from yourpayments/YP-291__sdelat-zanovo-grafiki-v-cpanel

sdk docs and examples

Author: yourpayments

README.md

@@ -38,11 +38,12 @@ require vendor/autoload.php;
 9. [Возврат средств со сплитом](src/Examples/paymentRefundMarketplace.php)
 10. [Проверка статуса платежа](src/Examples/paymentGetStatus.php)
 11. [Выплаты на банковские карты](src/Examples/payoutCreate.php)
-12. [Запрос отчёта](src/Examples/getReport.php)
-13. [Создание сессии](src/Examples/getSession.php)
-14. [Оплата одноразовым токеном](src/Examples/oneTimeTokenPayment.php)
-15. [Страница после оплаты](src/Examples/returnPage.php)
-16. [Безопасные поля (Secure fields)](src/Examples/secureFields.php)
+12. [Создание сессии](src/Examples/getSession.php)
+13. [Оплата одноразовым токеном](src/Examples/oneTimeTokenPayment.php)
+14. [Страница после оплаты](src/Examples/returnPage.php)
+15. [Безопасные поля (Secure fields)](src/Examples/secureFields.php)
+16. [Запрос отчёта в формате Json](src/Examples/getReportGeneral.php)
+17. [Запрос отчёта в виде графика](src/Examples/getReportChart.php)
 
 ## Ссылки
 - [Основной сайт НКО "Твои Платежи"](https://YPMN.ru/)

example.php

@@ -42,11 +42,12 @@
             case 'paymentWebhook':
             case 'paymentRefund':
             case 'paymentRefundMarketplace':
-            case 'getReport':
             case 'getSession':
             case 'oneTimeTokenPayment':
             case 'returnPage':
             case 'secureFields':
+            case 'getReportGeneral':
+            case 'getReportChart':
                 require './src/Examples/start.php';
                 @include './src/Examples/'.$_GET['function'] . '__prepend.php';
                 require './src/Examples/'.$_GET['function'] . '.php';

example_list.php

@@ -19,79 +19,73 @@
     'simpleGetPaymentLink' => [
         'name'  => 'Самая простая кнопка оплаты',
         'about'  => 'В этом примере показана самая простая реализация. С минимальным набором полей без детализации, просто оплата заказа c определённой суммой.',
-        'docLink'  => 'https://secure.ypmn.ru/docs/#tag/Payment-API/paths/~1v4~1payments~1authorize/post',
+        'docLink'  => 'https://ypmn.ru/ru/documentation/#tag/payment-api/paths/~1v4~1payments~1authorize/post',
         'link'  => '',
     ],
     'getPaymentLink' => [
         'name'  => 'Подробный платёж',
         'about'  => 'Это пример платежа с максимальным набором полей.',
-        'docLink'  => 'https://secure.ypmn.ru/docs/#tag/Payment-API/paths/~1v4~1payments~1authorize/post',
+        'docLink'  => 'https://ypmn.ru/ru/documentation/#tag/payment-api/paths/~1v4~1payments~1authorize/post',
         'link'  => '',
     ],
     'getPaymentLinkMarketplace' => [
         'name'  => 'Платёж со сплитом',
         'about'  => 'Это пример платежа со сплитом (разделением оплаты на несколько плательщиков).',
-        'docLink'  => '',
+        'docLink'  => 'https://ypmn.ru/ru/documentation/#tag/payment-split-api',
         'link'  => '',
     ],
     'getToken' => [
         'name'  => 'Создание токена',
         'about'  => 'Приложение передаёт номер успешно оплаченного заказа в YPMN API, и получает в ответ платёжный токен.<br><br>Это называется "Токенизация карты" (чтобы запомнить карту клиента и не вводить повторно.<br><br>Очень полезная функция для подписок и регулярных платежей.',
-        'docLink'  => 'https://secure.ypmn.ru/docs/#tag/Token-API/paths/~1v4~1token/post',
+        'docLink'  => 'https://ypmn.ru/ru/documentation/#tag/token-api/paths/~1v4~1token/post',
         'link'  => '',
     ],
     'paymentByToken' => [
         'name'  => 'Оплата токеном',
         'about'  => 'Оплата с помощью токена (теперь не нужно повторно вводить данные банковской карты)',
-        'docLink'  => 'https://secure.ypmn.ru/docs/#tag/Payment-API/paths/~1v4~1payments~1authorize/post',
+        'docLink'  => 'https://ypmn.ru/ru/documentation/#tag/payment-api/paths/~1v4~1payments~1authorize/post',
         'link'  => '',
     ],
     'paymentCapture' => [
         'name'  => 'Списание средств',
         'about'  => 'Списание ранее заблокированной на счету суммы. Не обязательно, если у Вас настроена оплата в 1 шаг.',
-        'docLink'  => 'https://secure.ypmn.ru/docs/#tag/Payment-API/paths/~1v4~1payments~1capture/post',
+        'docLink'  => 'https://ypmn.ru/ru/documentation/#tag/payment-api/paths/~1v4~1payments~1capture/post',
         'link'  => '',
     ],
     'paymentRefund' => [
         'name'  => 'Возврат средств',
         'about'  => 'Запрос на полный или частичный возврат средств.',
-        'docLink'  => 'https://secure.ypmn.ru/docs/#tag/Payment-API/paths/~1v4~1payments~1refund/post',
+        'docLink'  => 'https://ypmn.ru/ru/documentation/#tag/payment-api/paths/~1v4~1payments~1refund/post',
         'link'  => '',
     ],
     'paymentRefundMarketplace' => [
         'name'  => 'Возврат средств со сплитом',
         'about'  => 'Запрос на полный или частичный возврат средств с разделением на несколько получателей.',
-        'docLink'  => 'https://secure.ypmn.ru/docs/#tag/Payment-API/paths/~1v4~1payments~1refund/posts',
+        'docLink'  => 'https://ypmn.ru/ru/documentation/#tag/payment-api/paths/~1v4~1payments~1refund/post',
         'link'  => '',
     ],
     'paymentGetStatus' => [
         'name'  => 'Проверка статуса платежа',
         'about'  => 'Запрос к YPMN API о состоянии платежа.',
-        'docLink'  => 'https://secure.ypmn.ru/docs/#tag/Payment-API/paths/~1v4~1payments~1status~1{merchantPaymentReference}/get',
+        'docLink'  => 'https://ypmn.ru/ru/documentation/#tag/payment-api/paths/~1v4~1payments~1status~1%7BmerchantPaymentReference%7D/get',
         'link'  => '',
     ],
     'payoutCreate' => [
         'name'  => 'Создание выплаты',
         'about'  => 'Запрос к YPMN для совершения выплаты на карту (для компаний, сертифицированных по PCI-DSS). У вас должно быть достаточно средств на специальном счету для выплат.<br><br>Тестовая карта (для выплат на тестовом контуре): 4149605380309302',
-        'docLink'  => 'https://secure.ypmn.ru/docs/#tag/Payouts-API',
-        'link'  => '',
-    ],
-    'getReport' => [
-        'name'  => 'Запрос отчёта',
-        'about'  => 'Запрос к YPMN для генерации отчёта',
-        'docLink'  => 'https://dev.ypmn.ru/ru/documents/api-dlia-otchetov/',
+        'docLink'  => 'https://ypmn.ru/ru/documentation/#tag/payouts-api',
         'link'  => '',
     ],
     'getSession' => [
         'name'  => 'Создание сессии',
         'about'  => 'Создание уникальной сессии YPMN',
-        'docLink'  => 'https://secure.ypmn.ru/docs/#tag/Sessions/paths/~1v4~1payments~1sessions/post',
+        'docLink'  => 'https://ypmn.ru/ru/documentation/#tag/sessions/paths/~1v4~1payments~1sessions/post',
         'link'  => '',
     ],
     'oneTimeTokenPayment' => [
         'name'  => 'Оплата одноразовым токеном',
         'about'  => 'Оплата одноразовым токеном',
-        'docLink'  => 'https://secure.ypmn.ru/docs/#tag/Payment-API/paths/~1v4~1payments~1authorize/post',
+        'docLink'  => 'https://ypmn.ru/ru/documentation/#tag/payment-api/paths/~1v4~1payments~1authorize/post',
         'link'  => '',
     ],
     'returnPage' => [
@@ -103,7 +97,19 @@
     'secureFields' => [
         'name'  => 'Безопасные поля (Secure fields)',
         'about'  => 'Это пример формы оплаты с использованием Secure Fields.',
-        'docLink'  => 'https://secure.ypmn.ru/docs/secure-fields/',
+        'docLink'  => 'https://ypmn.ru/ru/documentation/#tag/secure-fields',
+        'link'  => '',
+    ],
+    'getReportGeneral' => [
+        'name'  => 'Запрос отчёта в формате JSON',
+        'about'  => 'Это пример получения отчета в формате JSON.',
+        'docLink'  => 'https://ypmn.ru/ru/documentation/#tag/reports/paths/~1v4~1reports~1general/get',
+        'link'  => '',
+    ],
+    'getReportChart' => [
+        'name'  => 'Запрос отчёта в виде графика',
+        'about'  => 'Это пример получения отчета в виде графика.',
+        'docLink'  => 'https://ypmn.ru/ru/documentation/#tag/reports/paths/~1v4~1reports~1chart/get',
         'link'  => '',
     ],
 ];

src/ApiRequest.php

@@ -53,6 +53,7 @@ public function getHost() : string
         }
     }
 
+    /** @deprecated старая версия */
     public function sendGetReportRequest(?string $startDate = null, ?string $endDate = null, ?array $orderStatus = null): string
     {
         //проверить даты