phpstan fixes (php doc blocks)

MangoPay/ApiCards.php

@@ -45,7 +45,7 @@ public function Update($card)
      * Gets a Card's PreAuthorizations
      * @param int $cardId ID of the Card for which to retrieve PreAuthorizations
      * @param \MangoPay\Pagination $pagination Pagination object
-     * @param \MangoPay\FilterPreAuthorizations filter Filtering object
+     * @param \MangoPay\FilterPreAuthorizations $filter Filtering object
      * @param \MangoPay\Sorting $sorting Sorting object
      * @return \MangoPay\CardPreAuthorization[] List of the Card's PreAuthorizations
      */

MangoPay/ApiClients.php

@@ -37,7 +37,8 @@ public function Update($client)
      * Upload a logo for client.
      * Only GIF, PNG, JPG, JPEG, BMP, PDF and DOC formats are accepted,
      * and file must be less than about 7MB
-     * @param \MangoPay\ClientLogoUpload $logo ClientLogoUpload object
+     * @param \MangoPay\ClientLogoUpload $logoUpload ClientLogoUpload object
+     * @param string|null $idempotencyKey
      */
     public function UploadLogo($logoUpload, $idempotencyKey = null)
     {

MangoPay/ApiDisputes.php

@@ -47,7 +47,7 @@ public function GetPendingSettlements(& $pagination = null, $sorting = null)
 
     /**
      * Updates dispute's tag
-     * @param \MangoPay\Dispute Dispute object to update
+     * @param \MangoPay\Dispute $dispute Dispute object to update
      * @return \MangoPay\Dispute Transfer instance returned from API
      */
     public function Update($dispute)

MangoPay/ApiPayOuts.php

@@ -61,7 +61,7 @@ public function GetBankwire($payOutId)
      * Returns a list of Refunds pertaining to a certain PayOut.
      * @param string $payOutId ID of the PayOut for which to retrieve Refunds
      * @param \MangoPay\Pagination $pagination Pagination object
-     * @param \MangoPay\FilterRefunds filter Filtering object
+     * @param \MangoPay\FilterRefunds $filter Filtering object
      * @param \MangoPay\Sorting $sorting Sorting object
      * @return \MangoPay\Refund[] List of Refunds for the PayOut
      */

MangoPay/BankingAliasOTHER.php

@@ -5,22 +5,26 @@
 class BankingAliasOTHER extends BankingAlias
 {
     /**
-     * @var Type
+     * Type
+     * @var string
      */
     public $Type;
 
     /**
      * Account Number
+     * @var string
      */
     public $AccountNumber;
 
     /**
      * BIC
+     * @var string
      */
     public $BIC;
 
     /**
      * Country
+     * @var string
      */
     public $Country;
 }

MangoPay/Libraries/ApiBase.php

@@ -236,7 +236,8 @@ protected function getLogger()
 
     /**
      * Constructor
-     * @param \MangoPay\MangoPayApi Root/parent instance that holds the OAuthToken and Configuration instance
+     * Root/parent instance that holds the OAuthToken and Configuration instance
+     * @param \MangoPay\MangoPayApi $root
      */
     public function __construct($root)
     {
@@ -303,7 +304,6 @@ protected function CreateObject($methodKey, $entity, $responseClassName = null,
      * Get entity object from API
      * @param string $methodKey Key with request data
      * @param object $responseClassName Name of entity class from response
-     * @param array $params path variable in urls
      * @return object Response data
      * @throws Exception
      */

MangoPay/Libraries/ApiOAuth.php

@@ -30,6 +30,7 @@ public function CreateToken()
             $rest->AddRequestHttpHeader('x-tenant-id: uk');
         }
         $response = $rest->Request($urlMethod, $requestType, $requestData);
+        /** @var \MangoPay\Libraries\OAuthToken $token */
         $token = $this->CastResponseToEntity($response, '\MangoPay\Libraries\OAuthToken');
         $token->autentication_key = $authHlp->GetAutenticationKey();
 

MangoPay/Libraries/AuthenticationHelper.php

@@ -12,7 +12,8 @@ class AuthenticationHelper
 
     /**
      * Constructor
-     * @param \MangoPay\MangoPayApi Root/parent instance that holds the OAuth token and Configuration instance
+     * Root/parent instance that holds the OAuthToken and Configuration instance
+     * @param \MangoPay\MangoPayApi $root
      */
     public function __construct($root)
     {

MangoPay/Libraries/UrlTool.php

@@ -12,7 +12,8 @@ class UrlTool
 
     /**
      * Constructor
-     * @param \MangoPay\MangoPayApi Root/parent instance that holds the OAuthToken and Configuration instance
+     * Root/parent instance that holds the OAuthToken and Configuration instance
+     * @param \MangoPay\MangoPayApi $root
      */
     public function __construct($root)
     {

MangoPay/PayInExecutionDetailsDirect.php

@@ -72,5 +72,7 @@ public function GetSubObjects()
         $subObjects = parent::GetSubObjects();
         $subObjects['Billing'] = '\MangoPay\Billing';
         $subObjects['SecurityInfo'] = '\MangoPay\SecurityInfo';
+
+        return $subObjects;
     }
 }

MangoPay/PayInPaymentDetailsPayconiq.php

@@ -9,7 +9,7 @@ class PayInPaymentDetailsPayconiq extends Libraries\Dto implements PayInPaymentD
 {
     /**
      * The country of your user (should be BE, NL or LU)
-     * @var $Country
+     * @var string
      */
     public $Country;