move deprecation annotations to class level

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
      */

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
      */

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
      */

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
      */

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
      */

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
      */

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
      */

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
      */

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
      */

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
      */

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
      */

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
      */

src/Adyen/Service/RiskManagement.php

@@ -2,6 +2,9 @@
 
 namespace Adyen\Service;
 
+/**
+ * @deprecated
+ */
 class RiskManagement extends \Adyen\Service
 {
     /**