osCommerce / oscommerce2

catalog/includes/apps/braintree/lib/Braintree/AddressGateway.php

Doc Comments +3 added lines, -4 removed lines

@@ -175,8 +175,7 @@ 
      * customerOrId & addressId are not sent in object context.
      *
      * @access public
-     * @param array $transactionAttribs
-     * @param string $customerId
+     * @param string $customerOrId
      * @return Transaction
      * @throws Exception\ValidationsFailed
      * @see Address::update()
@@ -189,7 +188,7 @@ 
 
     /**
      * creates a full array signature of a valid create request
-     * @return array gateway create request format
+     * @return string[] gateway create request format
      */
     public static function createSignature()
     {
@@ -202,7 +201,7 @@ 
 
     /**
      * creates a full array signature of a valid update request
-     * @return array gateway update request format
+     * @return string[] gateway update request format
      */
     public static function updateSignature()
     {

catalog/includes/apps/braintree/lib/Braintree/ClientTokenGateway.php

Doc Comments +2 added lines, -2 removed lines

@@ -51,9 +51,9 @@
      * sends the generate request to the gateway
      *
      * @ignore
-     * @param var $url
      * @param array $params
-     * @return mixed
+     * @param string $subPath
+     * @return string
      */
     public function _doGenerate($subPath, $params)
     {

catalog/includes/apps/braintree/lib/Braintree/CredentialsParser.php

Doc Comments +4 added lines

@@ -82,6 +82,10 @@
         }
     }
 
+    /**
+     * @param string $credentialType
+     * @param string $expectedValuePrefix
+     */
     private function _parseClientCredential($credentialType, $value, $expectedValuePrefix)
     {
         $explodedCredential = explode('$', $value);

catalog/includes/apps/braintree/lib/Braintree/CreditCardGateway.php

Doc Comments +8 added lines, -6 removed lines

@@ -22,6 +22,9 @@ 
     private $_config;
     private $_http;
 
+    /**
+     * @param Gateway $gateway
+     */
     public function __construct($gateway)
     {
         $this->_gateway = $gateway;
@@ -55,7 +58,6 @@ 
      *
      * @deprecated since version 2.3.0
      * @access public
-     * @param array $attribs
      * @return Result\Successful|Result\Error
      */
     public function createFromTransparentRedirect($queryString)
@@ -190,7 +192,6 @@ 
      * create a credit on the card for the passed transaction
      *
      * @access public
-     * @param array $attribs
      * @return Result\Successful|Result\Error
      */
     public function credit($token, $transactionAttribs)
@@ -210,7 +211,6 @@ 
      * returns a Transaction object on success
      *
      * @access public
-     * @param array $attribs
      * @return Transaction
      * @throws Exception\ValidationError
      */
@@ -311,7 +311,6 @@ 
      *
      * @deprecated since version 2.3.0
      * @access public
-     * @param array $attribs
      * @return object
      */
     public function updateFromTransparentRedirect($queryString)
@@ -340,6 +339,9 @@ 
         return ['makeDefault', 'verificationMerchantAccountId', 'verifyCard', 'verificationAmount', 'venmoSdkSession'];
     }
 
+    /**
+     * @param string[] $options
+     */
     private static function baseSignature($options)
     {
          return [
@@ -423,7 +425,6 @@ 
      * verifies that a valid credit card identifier is being used
      * @ignore
      * @param string $identifier
-     * @param Optional $string $identifierType type of identifier supplied, default "token"
      * @throws InvalidArgumentException
      */
     private function _validateId($identifier = null, $identifierType = "token")
@@ -444,8 +445,9 @@ 
      * sends the update request to the gateway
      *
      * @ignore
-     * @param string $url
      * @param array $params
+     * @param string $httpVerb
+     * @param string $subPath
      * @return mixed
      */
     private function _doUpdate($httpVerb, $subPath, $params)

catalog/includes/apps/braintree/lib/Braintree/Customer.php

Doc Comments +2 added lines, -2 removed lines

@@ -38,7 +38,7 @@ 
 {
     /**
      *
-     * @return Customer[]
+     * @return ResourceCollection
      */
     public static function all()
     {
@@ -190,7 +190,7 @@ 
      * @throws Exception\Unexpected
      * @param int $customerId
      * @param array $attributes
-     * @return CustomerGateway
+     * @return Customer
      */
     public static function updateNoValidate($customerId, $attributes)
     {

catalog/includes/apps/braintree/lib/Braintree/CustomerGateway.php

Doc Comments +11 added lines, -2 removed lines

@@ -21,6 +21,9 @@ 
     private $_config;
     private $_http;
 
+    /**
+     * @param Gateway $gateway
+     */
     public function __construct($gateway)
     {
         $this->_gateway = $gateway;
@@ -42,6 +45,10 @@ 
         return new ResourceCollection($response, $pager);
     }
 
+    /**
+     * @param string $query
+     * @param integer[] $ids
+     */
     public function fetch($query, $ids)
     {
         $criteria = [];
@@ -108,7 +115,7 @@ 
      *
      * @deprecated since version 2.3.0
      * @access public
-     * @param array $attribs
+     * @param string $queryString
      * @return Customer
      */
     public function createFromTransparentRedirect($queryString)
@@ -190,6 +197,7 @@ 
      *
      * @access public
      * @param string id customer Id
+     * @param string $id
      * @return Customer|boolean The customer object or false if the request fails.
      * @throws Exception\NotFound
      */
@@ -297,7 +305,7 @@ 
      * If <b>query</b> is a hash, the search will be an advanced search.
      * For more detailed information and examples, see {@link http://www.braintreepayments.com/gateway/customer-api#searching http://www.braintreepaymentsolutions.com/gateway/customer-api}
      *
-     * @param mixed $query search query
+     * @param string $query search query
      * @return ResourceCollection
      * @throws InvalidArgumentException
      */
@@ -584,6 +592,7 @@ 
      * @ignore
      * @param string $subPath
      * @param array $params
+     * @param string $httpVerb
      * @return mixed
      */
     private function _doUpdate($httpVerb, $subPath, $params)

catalog/includes/apps/braintree/lib/Braintree/Http.php

Doc Comments +19 added lines

@@ -17,6 +17,9 @@ 
         $this->_config = $config;
     }
 
+    /**
+     * @param string $path
+     */
     public function delete($path)
     {
         $response = $this->_doRequest('DELETE', $path);
@@ -27,6 +30,9 @@ 
         }
     }
 
+    /**
+     * @param string $path
+     */
     public function get($path)
     {
         $response = $this->_doRequest('GET', $path);
@@ -37,6 +43,9 @@ 
         }
     }
 
+    /**
+     * @param string $path
+     */
     public function post($path, $params = null)
     {
         $response = $this->_doRequest('POST', $path, $this->_buildXml($params));
@@ -48,6 +57,9 @@ 
         }
     }
 
+    /**
+     * @param string $path
+     */
     public function put($path, $params = null)
     {
         $response = $this->_doRequest('PUT', $path, $this->_buildXml($params));
@@ -96,11 +108,18 @@ 
         $this->_useClientCredentials = true;
     }
 
+    /**
+     * @param string $httpVerb
+     * @param string $requestBody
+     */
     private function _doRequest($httpVerb, $path, $requestBody = null)
     {
         return $this->_doUrlRequest($httpVerb, $this->_config->baseUrl() . $path, $requestBody);
     }
 
+    /**
+     * @param string $url
+     */
     public function _doUrlRequest($httpVerb, $url, $requestBody = null)
     {
         $curl = curl_init();

catalog/includes/apps/braintree/lib/Braintree/MerchantAccountGateway.php

Doc Comments +9 added lines

@@ -7,6 +7,9 @@ 
     private $_config;
     private $_http;
 
+    /**
+     * @param Gateway $gateway
+     */
     public function __construct($gateway)
     {
         $this->_gateway = $gateway;
@@ -119,6 +122,9 @@ 
         ];
     }
 
+    /**
+     * @param string $subPath
+     */
     public function _doCreate($subPath, $params)
     {
         $fullPath = $this->_config->merchantPath() . $subPath;
@@ -127,6 +133,9 @@ 
         return $this->_verifyGatewayResponse($response);
     }
 
+    /**
+     * @param string $subPath
+     */
     private function _doUpdate($subPath, $params)
     {
         $fullPath = $this->_config->merchantPath() . $subPath;

catalog/includes/apps/braintree/lib/Braintree/OAuthGateway.php

Doc Comments +15 added lines

@@ -15,6 +15,9 @@ 
     private $_config;
     private $_http;
 
+    /**
+     * @param Gateway $gateway
+     */
     public function __construct($gateway)
     {
         $this->_gateway = $gateway;
@@ -73,6 +76,9 @@ 
         }
     }
 
+    /**
+     * @param Result\Error $result
+     */
     public function _mapError($result)
     {
         $error = $result->errors->deepAll()[0];
@@ -88,12 +94,18 @@ 
         return $result;
     }
 
+    /**
+     * @param Result\Successful $result
+     */
     public function _mapAccessTokenRevokeSuccess($result)
     {
         $result->revocationResult = $result->success;
         return $result;
     }
 
+    /**
+     * @param Result\Successful $result
+     */
     public function _mapSuccess($result)
     {
         $credentials = $result->credentials;
@@ -114,6 +126,9 @@ 
         return $url . '&signature=' . $this->computeSignature($url) . '&algorithm=SHA256';
     }
 
+    /**
+     * @param string $url
+     */
     public function computeSignature($url)
     {
         $key = hash('sha256', $this->_config->getClientSecret(), true);