Merge pull request #17 from yourpayments/YP-743__api-zaprosa-rasshirennoj-informatsii-po-zakazu

YP-743__api-zaprosa-rasshirennoj-informatsii-po-zakazu

Author: yourpayments

README.md

@@ -34,6 +34,7 @@ composer require yourpayments/php-api-client
 19. [Запрос отчёта в формате Json](src/Examples/getReportGeneral.php)
 20. [Запрос отчёта в виде графика](src/Examples/getReportChart.php)
 21. [Запрос быстрого отчёта по заказам для сверки](src/Examples/getReportOrder.php)
+22. [Запрос детального отчета по заказу](src/Examples/getReportOrderDetails.php)
 
 ## Ссылки
 - [НКО «Твои платежи»](https://YPMN.ru/)

example.php

@@ -49,6 +49,7 @@
             case 'getReportGeneral':
             case 'getReportChart':
             case 'getReportOrder':
+            case 'getReportOrderDetails':
             case 'getFasterPayment':
             case 'getBindingFasterPayment':
             case 'paymentByFasterBinding':

src/ApiRequest.php

@@ -22,6 +22,7 @@ class ApiRequest implements ApiRequestInterface
     const REPORT_CHART_API = '/api/v4/reports/chart';
     const REPORT_GENERAL_API = '/api/v4/reports/general';
     const REPORT_ORDERS_API_V4 = '/api/v4/reports/orders';
+    const REPORT_ORDER_DETAILS_API = '/api/v4/reports/order-details';
     const PODELI_MERCHANT_REGISTRATION_API = '/api/v4/registration/merchant/podeli';
     const HOST = 'https://secure.ypmn.ru';
     const SANDBOX_HOST = 'https://sandbox.ypmn.ru';
@@ -461,11 +462,18 @@ public function sendReportGeneralRequest(array $params): array
         return $this->sendGetRequest(self::REPORT_GENERAL_API . '/?' . http_build_query($params));
     }
 
+    /** @inheritdoc  */
     public function sendReportOrderRequest(array $params): array
     {
         return $this->sendGetRequest(self::REPORT_ORDERS_API_V4 . '/?' . http_build_query($params));
     }
 
+    /** @inheritdoc  */
+    public function sendReportOrderDetailsRequest(array $params): array
+    {
+        return $this->sendGetRequest(self::REPORT_ORDER_DETAILS_API . '/?' . http_build_query($params));
+    }
+
     /**
      * Подпись запроса
      * @param MerchantInterface $merchant Мерчант

src/ApiRequestInterface.php

@@ -118,6 +118,18 @@ public function sendReportChartUpdateRequest(array $params);
      */
     public function sendReportGeneralRequest(array $params);
 
+    /**
+     * Отправить запрос быстрого отчёта по заказам для сверки
+     * @param array $params
+     */
+    public function sendReportOrderRequest(array $params);
+
+    /**
+     * Отправить запрос для получения детального отчета по заказу
+     * @param array $params
+     */
+    public function sendReportOrderDetailsRequest(array $params);
+
     /** @return string Хост для отправки запросов */
     public function getHost() : string;
 

src/Examples/getReportOrderDetails.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+use Ypmn\ApiRequest;
+
+// Подключим файл, в котором заданы параметры мерчанта
+include_once 'start.php';
+
+// Получение отчета в формате JSON
+
+// Создадим HTTP-запрос к API
+$apiRequest = new ApiRequest($merchant);
+// Включить режим отладки (закомментируйте или удалите в рабочей программе!)
+$apiRequest->setDebugMode();
+// Переключиться на тестовый сервер (закомментируйте или удалите в рабочей программе!)
+$apiRequest->setSandboxMode();
+
+$data = [
+    'merchantPaymentReference' => '2297597',
+];
+
+// Отправим запрос
+$responseData = $apiRequest->sendReportOrderDetailsRequest($data);