From fc5ecf3fe7f893712dbfac4c9c27ac6ec4c03705 Mon Sep 17 00:00:00 2001
From: Wouter Boereboom <62436079+wboereboom@users.noreply.github.com>
Date: Fri, 4 Aug 2023 11:41:09 +0200
Subject: [PATCH] move deprecation annotations to class level (#534)

* move deprecation annotations to class level

* remove whitespaces

* add reference to new classes in deprecation warnings
---
 src/Adyen/Service/Account.php         | 6 ++++++
 src/Adyen/Service/BinLookup.php       | 5 ++++-
 src/Adyen/Service/Checkout.php        | 5 ++++-
 src/Adyen/Service/CheckoutUtility.php | 5 ++++-
 src/Adyen/Service/Fund.php            | 6 ++++++
 src/Adyen/Service/Hop.php             | 5 +++++
 src/Adyen/Service/Management.php      | 5 ++++-
 src/Adyen/Service/Modification.php    | 5 ++++-
 src/Adyen/Service/Notification.php    | 6 ++++++
 src/Adyen/Service/Payment.php         | 5 ++++-
 src/Adyen/Service/Payout.php          | 5 ++++-
 src/Adyen/Service/Recurring.php       | 5 ++++-
 src/Adyen/Service/RiskManagement.php  | 3 +++
 13 files changed, 58 insertions(+), 8 deletions(-)

diff --git a/src/Adyen/Service/Account.php b/src/Adyen/Service/Account.php
index 3803c4d54..fdae84fb5 100755
--- a/src/Adyen/Service/Account.php
+++ b/src/Adyen/Service/Account.php
@@ -2,6 +2,11 @@
 
 namespace Adyen\Service;
 
+/**
+ * @deprecated Please consider using the BalancePlatform and LegalEntityManagement services instead
+ * @see \Adyen\Service\BalancePlatform\
+ * @see \Adyen\Service\LegalEntityManagement\
+ */
 class Account extends \Adyen\Service
 {
     /**
@@ -86,6 +91,7 @@ class Account extends \Adyen\Service
 
     /**
      * Account constructor.
+     *
      * @param \Adyen\Client $client
      * @throws \Adyen\AdyenException
      */
diff --git a/src/Adyen/Service/BinLookup.php b/src/Adyen/Service/BinLookup.php
index 0cb19795a..9d591a15f 100644
--- a/src/Adyen/Service/BinLookup.php
+++ b/src/Adyen/Service/BinLookup.php
@@ -2,6 +2,10 @@
 
 namespace Adyen\Service;
 
+/**
+ * @deprecated Please consider using the model based services instead (suffix -Api.php)
+ * @see \Adyen\Service\BinLookupApi
+ */
 class BinLookup extends \Adyen\Service
 {
     /**
@@ -17,7 +21,6 @@ class BinLookup extends \Adyen\Service
     /**
      * BinLookup constructor.
      *
-     * @deprecated Please consider using the model based services instead (suffix -Api.php)
      * @param \Adyen\Client $client
      * @throws \Adyen\AdyenException
      */
diff --git a/src/Adyen/Service/Checkout.php b/src/Adyen/Service/Checkout.php
index 0004a4024..98ad5e99f 100644
--- a/src/Adyen/Service/Checkout.php
+++ b/src/Adyen/Service/Checkout.php
@@ -4,6 +4,10 @@
 
 use Adyen\Service\ResourceModel\Checkout\Recurring;
 
+/**
+ * @deprecated Please consider using the model based services instead (suffix -Api.php)
+ * @see \Adyen\Service\Checkout\
+ */
 class Checkout extends \Adyen\ApiKeyAuthenticatedService
 {
     /**
@@ -101,7 +105,6 @@ class Checkout extends \Adyen\ApiKeyAuthenticatedService
     /**
      * Checkout constructor.
      *
-     * @deprecated Please consider using the model based services instead (suffix -Api.php)
      * @param \Adyen\Client $client
      * @throws \Adyen\AdyenException
      */
diff --git a/src/Adyen/Service/CheckoutUtility.php b/src/Adyen/Service/CheckoutUtility.php
index 05444247d..475099514 100644
--- a/src/Adyen/Service/CheckoutUtility.php
+++ b/src/Adyen/Service/CheckoutUtility.php
@@ -2,6 +2,10 @@
 
 namespace Adyen\Service;
 
+/**
+ * @deprecated Please consider using the model based services instead (suffix -Api.php)
+ * @see \Adyen\Service\Checkout\UtilityApi
+ */
 class CheckoutUtility extends \Adyen\ApiKeyAuthenticatedService
 {
     /**
@@ -12,7 +16,6 @@ class CheckoutUtility extends \Adyen\ApiKeyAuthenticatedService
     /**
      * CheckoutUtility constructor.
      *
-     * @deprecated Please consider using the model based services instead (suffix -Api.php)
      * @param \Adyen\Client $client
      * @throws \Adyen\AdyenException
      */
diff --git a/src/Adyen/Service/Fund.php b/src/Adyen/Service/Fund.php
index 649b735f1..686cd619e 100755
--- a/src/Adyen/Service/Fund.php
+++ b/src/Adyen/Service/Fund.php
@@ -2,6 +2,11 @@
 
 namespace Adyen\Service;
 
+/**
+ * @deprecated Please consider using the BalancePlatform and Transfers services instead
+ * @see \Adyen\Service\BalancePlatform\
+ * @see \Adyen\Service\Transfers\
+ */
 class Fund extends \Adyen\Service
 {
 
@@ -37,6 +42,7 @@ class Fund extends \Adyen\Service
 
     /**
      * Fund constructor.
+     *
      * @param \Adyen\Client $client
      * @throws \Adyen\AdyenException
      */
diff --git a/src/Adyen/Service/Hop.php b/src/Adyen/Service/Hop.php
index 24c969d9e..0cd2a17a4 100644
--- a/src/Adyen/Service/Hop.php
+++ b/src/Adyen/Service/Hop.php
@@ -2,6 +2,10 @@
 
 namespace Adyen\Service;
 
+/**
+ * @deprecated Please consider using the LegalEntityManagement services instead
+ * @see \Adyen\Service\LegalEntityManagement\
+ */
 class Hop extends \Adyen\Service
 {
     /**
@@ -16,6 +20,7 @@ class Hop extends \Adyen\Service
 
     /**
      * Hop constructor.
+     *
      * @param \Adyen\Client $client
      * @throws \Adyen\AdyenException
      */
diff --git a/src/Adyen/Service/Management.php b/src/Adyen/Service/Management.php
index c414f633d..fd55f2e6f 100644
--- a/src/Adyen/Service/Management.php
+++ b/src/Adyen/Service/Management.php
@@ -11,6 +11,10 @@
 use Adyen\Service\ResourceModel\Management\MerchantClientKey;
 use Adyen\Service\ResourceModel\Management\MerchantWebhooks;
 
+/**
+ * @deprecated Please consider using the model based services instead (suffix -Api.php)
+ * @see \Adyen\Service\Management\
+ */
 class Management extends \Adyen\Service
 {
     /**
@@ -52,7 +56,6 @@ class Management extends \Adyen\Service
     /**
      * Management constructor.
      *
-     * @deprecated Please consider using the model based services instead (suffix -Api.php)
      * @param \Adyen\Client $client
      * @throws \Adyen\AdyenException
      */
diff --git a/src/Adyen/Service/Modification.php b/src/Adyen/Service/Modification.php
index 0f4969e06..3346bb75f 100644
--- a/src/Adyen/Service/Modification.php
+++ b/src/Adyen/Service/Modification.php
@@ -2,6 +2,10 @@
 
 namespace Adyen\Service;
 
+/**
+ * @deprecated Please consider using the model based services instead (suffix -Api.php)
+ * @see \Adyen\Service\Payments\ModificationsApi
+ */
 class Modification extends \Adyen\Service
 {
     /**
@@ -37,7 +41,6 @@ class Modification extends \Adyen\Service
     /**
      * Modification constructor.
      *
-     * @deprecated Please consider using the model based services instead (suffix -Api.php)
      * @param \Adyen\Client $client
      * @throws \Adyen\AdyenException
      */
diff --git a/src/Adyen/Service/Notification.php b/src/Adyen/Service/Notification.php
index 00c3b0088..e2d11ba80 100644
--- a/src/Adyen/Service/Notification.php
+++ b/src/Adyen/Service/Notification.php
@@ -12,6 +12,11 @@
 use Adyen\Service\ResourceModel\Notification\TestNotificationConfiguration;
 use Adyen\Service\ResourceModel\Notification\UpdateNotificationConfiguration;
 
+/**
+ * @deprecated Please consider using the model based services instead (suffix -Api.php)
+ * @see \Adyen\Service\BalancePlatform\
+ * @see \Adyen\Service\Transfers\
+ */
 class Notification extends Service
 {
 
@@ -47,6 +52,7 @@ class Notification extends Service
 
     /**
      * Notification constructor.
+     *
      * @param Client $client
      * @throws AdyenException
      */
diff --git a/src/Adyen/Service/Payment.php b/src/Adyen/Service/Payment.php
index 35ae11a94..fff3d2ff2 100644
--- a/src/Adyen/Service/Payment.php
+++ b/src/Adyen/Service/Payment.php
@@ -2,6 +2,10 @@
 
 namespace Adyen\Service;
 
+/**
+ * @deprecated Please consider using the model based services instead (suffix -Api.php)
+ * @see \Adyen\Service\Payments\GeneralApi
+ */
 class Payment extends \Adyen\Service
 {
     /**
@@ -22,7 +26,6 @@ class Payment extends \Adyen\Service
     /**
      * Payment constructor.
      *
-     * @deprecated Please consider using the model based services instead (suffix -Api.php)
      * @param \Adyen\Client $client
      * @throws \Adyen\AdyenException
      */
diff --git a/src/Adyen/Service/Payout.php b/src/Adyen/Service/Payout.php
index ffd948f7c..89c034a6e 100644
--- a/src/Adyen/Service/Payout.php
+++ b/src/Adyen/Service/Payout.php
@@ -15,6 +15,10 @@
 use Adyen\Service\ResourceModel\Payout\ThirdParty\StoreDetailsAndSubmitThirdParty;
 use Adyen\Service\ResourceModel\Payout\ThirdParty\SubmitThirdParty;
 
+/**
+ * @deprecated Please consider using the model based services instead (suffix -Api.php)
+ * @see \Adyen\Service\Payout\
+ */
 class Payout extends Service
 {
     /**
@@ -65,7 +69,6 @@ class Payout extends Service
     /**
      * Payout constructor.
      *
-     * @deprecated Please consider using the model based services instead (suffix -Api.php)
      * @param Client $client
      * @throws AdyenException
      */
diff --git a/src/Adyen/Service/Recurring.php b/src/Adyen/Service/Recurring.php
index 46b5825fa..60215f643 100644
--- a/src/Adyen/Service/Recurring.php
+++ b/src/Adyen/Service/Recurring.php
@@ -2,6 +2,10 @@
 
 namespace Adyen\Service;
 
+/**
+ * @deprecated Please consider using the model based services instead (suffix -Api.php)
+ * @see \Adyen\Service\RecurringApi
+ */
 class Recurring extends \Adyen\Service
 {
     /**
@@ -27,7 +31,6 @@ class Recurring extends \Adyen\Service
     /**
      * Recurring constructor.
      *
-     * @deprecated Please consider using the model based services instead (suffix -Api.php)
      * @param \Adyen\Client $client
      * @throws \Adyen\AdyenException
      */
diff --git a/src/Adyen/Service/RiskManagement.php b/src/Adyen/Service/RiskManagement.php
index 4bda6da56..2aed0eaa9 100644
--- a/src/Adyen/Service/RiskManagement.php
+++ b/src/Adyen/Service/RiskManagement.php
@@ -2,6 +2,9 @@
 
 namespace Adyen\Service;
 
+/**
+ * @deprecated
+ */
 class RiskManagement extends \Adyen\Service
 {
     /**