Payments API Updates

lib/PayPal/Api/Payer.php

@@ -11,24 +11,20 @@ use PayPal\Common\PayPalModel;
  *
  * @package PayPal\Api
  *
- * @property string payment_method
- * @property string status
- * @property string account_type
- * @property string account_age
+ * @property string                          payment_method
+ * @property string                          status
  * @property \PayPal\Api\FundingInstrument[] funding_instruments
- * @property string funding_option_id
- * @property \PayPal\Api\FundingOption funding_option
- * @property \PayPal\Api\FundingOption related_funding_option
- * @property \PayPal\Api\PayerInfo payer_info
+ * @property string                          funding_option_id
+ * @property \PayPal\Api\PayerInfo           payer_info
  */
 class Payer extends PayPalModel
 {
     /**
      * Payment method being used - PayPal Wallet payment, Bank Direct Debit  or Direct Credit card.
-     * Valid Values: ["credit_card", "bank", "paypal", "pay_upon_invoice", "carrier"]
+     * Valid Values: ["credit_card", "bank", "paypal", "pay_upon_invoice", "carrier", "alternate_payment"]
      *
      * @param string $payment_method
-     * 
+     *
      * @return $this
      */
     public function setPaymentMethod($payment_method)
@@ -52,7 +48,7 @@ class Payer extends PayPalModel
      * Valid Values: ["VERIFIED", "UNVERIFIED"]
      *
      * @param string $status
-     * 
+     *
      * @return $this
      */
     public function setStatus($status)
@@ -75,8 +71,9 @@ class Payer extends PayPalModel
      * Type of account relationship payer has with PayPal.
      * Valid Values: ["BUSINESS", "PERSONAL", "PREMIER"]
      *
+     * @deprecated Not publicly available
      * @param string $account_type
-     * 
+     *
      * @return $this
      */
     public function setAccountType($account_type)
@@ -88,6 +85,7 @@ class Payer extends PayPalModel
     /**
      * Type of account relationship payer has with PayPal.
      *
+     * @deprecated Not publicly available
      * @return string
      */
     public function getAccountType()
@@ -98,8 +96,9 @@ class Payer extends PayPalModel
     /**
      * Duration since the payer established account relationship with PayPal in days.
      *
+     * @deprecated Not publicly available
      * @param string $account_age
-     * 
+     *
      * @return $this
      */
     public function setAccountAge($account_age)
@@ -111,6 +110,7 @@ class Payer extends PayPalModel
     /**
      * Duration since the payer established account relationship with PayPal in days.
      *
+     * @deprecated Not publicly available
      * @return string
      */
     public function getAccountAge()
@@ -119,10 +119,10 @@ class Payer extends PayPalModel
     }
 
     /**
-     * List of funding instruments to fund the payment.
+     * List of funding instruments to fund the payment. 'OneOf' funding_instruments,funding_option_id to be used to identify the specifics of payment method passed.
      *
      * @param \PayPal\Api\FundingInstrument[] $funding_instruments
-     * 
+     *
      * @return $this
      */
     public function setFundingInstruments($funding_instruments)
@@ -132,7 +132,7 @@ class Payer extends PayPalModel
     }
 
     /**
-     * List of funding instruments to fund the payment.
+     * List of funding instruments to fund the payment. 'OneOf' funding_instruments,funding_option_id to be used to identify the specifics of payment method passed.
      *
      * @return \PayPal\Api\FundingInstrument[]
      */
@@ -172,10 +172,10 @@ class Payer extends PayPalModel
     }
 
     /**
-     * Id of user selected funding option for the payment. 'OneOf' funding_instruments or funding_option_id to be present 
+     * Id of user selected funding option for the payment.'OneOf' funding_instruments,funding_option_id to be used to identify the specifics of payment method passed.
      *
      * @param string $funding_option_id
-     * 
+     *
      * @return $this
      */
     public function setFundingOptionId($funding_option_id)
@@ -185,7 +185,7 @@ class Payer extends PayPalModel
     }
 
     /**
-     * Id of user selected funding option for the payment. 'OneOf' funding_instruments or funding_option_id to be present 
+     * Id of user selected funding option for the payment.'OneOf' funding_instruments,funding_option_id to be used to identify the specifics of payment method passed.
      *
      * @return string
      */
@@ -195,10 +195,11 @@ class Payer extends PayPalModel
     }
 
     /**
-     * Default funding option available for the payment 
+     * Default funding option available for the payment
      *
+     * @deprecated Not publicly available
      * @param \PayPal\Api\FundingOption $funding_option
-     * 
+     *
      * @return $this
      */
     public function setFundingOption($funding_option)
@@ -208,8 +209,9 @@ class Payer extends PayPalModel
     }
 
     /**
-     * Default funding option available for the payment 
+     * Default funding option available for the payment
      *
+     * @deprecated Not publicly available
      * @return \PayPal\Api\FundingOption
      */
     public function getFundingOption()
@@ -220,8 +222,9 @@ class Payer extends PayPalModel
     /**
      * Funding option related to default funding option.
      *
+     * @deprecated Not publicly available
      * @param \PayPal\Api\FundingOption $related_funding_option
-     * 
+     *
      * @return $this
      */
     public function setRelatedFundingOption($related_funding_option)
@@ -233,6 +236,7 @@ class Payer extends PayPalModel
     /**
      * Funding option related to default funding option.
      *
+     * @deprecated Not publicly available
      * @return \PayPal\Api\FundingOption
      */
     public function getRelatedFundingOption()
@@ -241,10 +245,10 @@ class Payer extends PayPalModel
     }
 
     /**
-     * Information related to the Payer. 
+     * Information related to the Payer.
      *
      * @param \PayPal\Api\PayerInfo $payer_info
-     * 
+     *
      * @return $this
      */
     public function setPayerInfo($payer_info)
@@ -254,7 +258,7 @@ class Payer extends PayPalModel
     }
 
     /**
-     * Information related to the Payer. 
+     * Information related to the Payer.
      *
      * @return \PayPal\Api\PayerInfo
      */