From a87db72c41d1011600d5af272feec81cfa448374 Mon Sep 17 00:00:00 2001
From: Olivier Bellone <ob@stripe.com>
Date: Wed, 29 Jan 2020 14:19:48 -0800
Subject: [PATCH] More PHPDoc fixes

---
 lib/Account.php               | 44 ++++++++++++++++----------------
 lib/ApplicationFee.php        |  8 +++---
 lib/Charge.php                | 14 +++++-----
 lib/CreditNote.php            | 10 ++++++--
 lib/Customer.php              | 32 +++++++++++------------
 lib/Invoice.php               | 17 +++++++------
 lib/Issuing/Authorization.php | 12 ++++-----
 lib/Order.php                 |  8 +++---
 lib/PaymentIntent.php         | 10 ++++----
 lib/PaymentMethod.php         | 12 ++++-----
 lib/SetupIntent.php           |  6 ++---
 lib/Source.php                | 48 +++++++++++++++++------------------
 lib/Subscription.php          |  7 ++---
 lib/SubscriptionItem.php      |  4 +--
 lib/SubscriptionSchedule.php  | 10 +++-----
 lib/Transfer.php              |  8 +++---
 16 files changed, 128 insertions(+), 122 deletions(-)

diff --git a/lib/Account.php b/lib/Account.php
index 57581f828..acb28d179 100644
--- a/lib/Account.php
+++ b/lib/Account.php
@@ -7,23 +7,23 @@
  *
  * @property string $id
  * @property string $object
- * @property mixed|null $business_profile
+ * @property \Stripe\StripeObject|null $business_profile
  * @property string|null $business_type
- * @property mixed $capabilities
+ * @property \Stripe\StripeObject $capabilities
  * @property bool $charges_enabled
- * @property mixed $company
+ * @property \Stripe\StripeObject $company
  * @property string $country
  * @property int $created
  * @property string $default_currency
  * @property bool $details_submitted
  * @property string|null $email
  * @property \Stripe\Collection $external_accounts
- * @property mixed $individual
+ * @property \Stripe\Person $individual
  * @property \Stripe\StripeObject $metadata
  * @property bool $payouts_enabled
- * @property mixed $requirements
- * @property mixed|null $settings
- * @property mixed $tos_acceptance
+ * @property \Stripe\StripeObject $requirements
+ * @property \Stripe\StripeObject|null $settings
+ * @property \Stripe\StripeObject $tos_acceptance
  * @property string $type
  *
  * @package Stripe
@@ -165,7 +165,7 @@ public function deauthorize($clientId = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return Capability
+     * @return \Stripe\Capability
      */
     public static function retrieveCapability($id, $capabilityId, $params = null, $opts = null)
     {
@@ -180,7 +180,7 @@ public static function retrieveCapability($id, $capabilityId, $params = null, $o
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return Capability
+     * @return \Stripe\Capability
      */
     public static function updateCapability($id, $capabilityId, $params = null, $opts = null)
     {
@@ -194,7 +194,7 @@ public static function updateCapability($id, $capabilityId, $params = null, $opt
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return Collection The list of capabilities.
+     * @return \Stripe\Collection The list of capabilities.
      */
     public static function allCapabilities($id, $params = null, $opts = null)
     {
@@ -208,7 +208,7 @@ public static function allCapabilities($id, $params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return BankAccount|Card
+     * @return \Stripe\BankAccount|\Stripe\Card
      */
     public static function createExternalAccount($id, $params = null, $opts = null)
     {
@@ -223,7 +223,7 @@ public static function createExternalAccount($id, $params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return BankAccount|Card
+     * @return \Stripe\BankAccount|\Stripe\Card
      */
     public static function retrieveExternalAccount($id, $externalAccountId, $params = null, $opts = null)
     {
@@ -238,7 +238,7 @@ public static function retrieveExternalAccount($id, $externalAccountId, $params
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return BankAccount|Card
+     * @return \Stripe\BankAccount|\Stripe\Card
      */
     public static function updateExternalAccount($id, $externalAccountId, $params = null, $opts = null)
     {
@@ -253,7 +253,7 @@ public static function updateExternalAccount($id, $externalAccountId, $params =
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return BankAccount|Card
+     * @return \Stripe\BankAccount|\Stripe\Card
      */
     public static function deleteExternalAccount($id, $externalAccountId, $params = null, $opts = null)
     {
@@ -267,7 +267,7 @@ public static function deleteExternalAccount($id, $externalAccountId, $params =
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return Collection The list of external accounts (BankAccount or Card).
+     * @return \Stripe\Collection The list of external accounts (BankAccount or Card).
      */
     public static function allExternalAccounts($id, $params = null, $opts = null)
     {
@@ -281,7 +281,7 @@ public static function allExternalAccounts($id, $params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return LoginLink
+     * @return \Stripe\LoginLink
      */
     public static function createLoginLink($id, $params = null, $opts = null)
     {
@@ -294,7 +294,7 @@ public static function createLoginLink($id, $params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return Collection The list of persons.
+     * @return \Stripe\Collection The list of persons.
      */
     public function persons($params = null, $opts = null)
     {
@@ -312,7 +312,7 @@ public function persons($params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return Person
+     * @return \Stripe\Person
      */
     public static function createPerson($id, $params = null, $opts = null)
     {
@@ -327,7 +327,7 @@ public static function createPerson($id, $params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return Person
+     * @return \Stripe\Person
      */
     public static function retrievePerson($id, $personId, $params = null, $opts = null)
     {
@@ -342,7 +342,7 @@ public static function retrievePerson($id, $personId, $params = null, $opts = nu
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return Person
+     * @return \Stripe\Person
      */
     public static function updatePerson($id, $personId, $params = null, $opts = null)
     {
@@ -357,7 +357,7 @@ public static function updatePerson($id, $personId, $params = null, $opts = null
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return Person
+     * @return \Stripe\Person
      */
     public static function deletePerson($id, $personId, $params = null, $opts = null)
     {
@@ -371,7 +371,7 @@ public static function deletePerson($id, $personId, $params = null, $opts = null
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return Collection The list of persons.
+     * @return \Stripe\Collection The list of persons.
      */
     public static function allPersons($id, $params = null, $opts = null)
     {
diff --git a/lib/ApplicationFee.php b/lib/ApplicationFee.php
index 07f6f0acd..5479f2e73 100644
--- a/lib/ApplicationFee.php
+++ b/lib/ApplicationFee.php
@@ -39,7 +39,7 @@ class ApplicationFee extends ApiResource
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return ApplicationFeeRefund
+     * @return \Stripe\ApplicationFeeRefund
      */
     public static function createRefund($id, $params = null, $opts = null)
     {
@@ -54,7 +54,7 @@ public static function createRefund($id, $params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return ApplicationFeeRefund
+     * @return \Stripe\ApplicationFeeRefund
      */
     public static function retrieveRefund($id, $refundId, $params = null, $opts = null)
     {
@@ -69,7 +69,7 @@ public static function retrieveRefund($id, $refundId, $params = null, $opts = nu
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return ApplicationFeeRefund
+     * @return \Stripe\ApplicationFeeRefund
      */
     public static function updateRefund($id, $refundId, $params = null, $opts = null)
     {
@@ -83,7 +83,7 @@ public static function updateRefund($id, $refundId, $params = null, $opts = null
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return Collection The list of fee refunds.
+     * @return \Stripe\Collection The list of fee refunds.
      */
     public static function allRefunds($id, $params = null, $opts = null)
     {
diff --git a/lib/Charge.php b/lib/Charge.php
index f14f27ca4..6dded1417 100644
--- a/lib/Charge.php
+++ b/lib/Charge.php
@@ -13,7 +13,7 @@
  * @property string|null $application_fee
  * @property int|null $application_fee_amount
  * @property string|null $balance_transaction
- * @property mixed $billing_details
+ * @property \Stripe\StripeObject $billing_details
  * @property bool $captured
  * @property int $created
  * @property string $currency
@@ -24,31 +24,31 @@
  * @property bool $disputed
  * @property string|null $failure_code
  * @property string|null $failure_message
- * @property mixed|null $fraud_details
+ * @property \Stripe\StripeObject|null $fraud_details
  * @property string|null $invoice
  * @property bool $livemode
  * @property \Stripe\StripeObject $metadata
  * @property string|null $on_behalf_of
  * @property string|null $order
- * @property mixed|null $outcome
+ * @property \Stripe\StripeObject|null $outcome
  * @property bool $paid
  * @property string|null $payment_intent
  * @property string|null $payment_method
- * @property mixed|null $payment_method_details
+ * @property \Stripe\StripeObject|null $payment_method_details
  * @property string|null $receipt_email
  * @property string|null $receipt_number
  * @property string $receipt_url
  * @property bool $refunded
  * @property \Stripe\Collection $refunds
  * @property string|null $review
- * @property mixed|null $shipping
- * @property mixed|null $source
+ * @property \Stripe\StripeObject|null $shipping
+ * @property \Stripe\StripeObject|null $source
  * @property string|null $source_transfer
  * @property string|null $statement_descriptor
  * @property string|null $statement_descriptor_suffix
  * @property string $status
  * @property string $transfer
- * @property mixed|null $transfer_data
+ * @property \Stripe\StripeObject|null $transfer_data
  * @property string|null $transfer_group
  *
  * @package Stripe
diff --git a/lib/CreditNote.php b/lib/CreditNote.php
index 1919cdb55..33bb79299 100644
--- a/lib/CreditNote.php
+++ b/lib/CreditNote.php
@@ -12,15 +12,21 @@
  * @property string $currency
  * @property string $customer
  * @property string|null $customer_balance_transaction
+ * @property int $discount_amount
  * @property string $invoice
+ * @property \Stripe\Collection $lines
  * @property bool $livemode
  * @property string|null $memo
  * @property \Stripe\StripeObject $metadata
  * @property string $number
+ * @property int|null $out_of_band_amount
  * @property string $pdf
  * @property string|null $reason
  * @property string|null $refund
  * @property string $status
+ * @property int $subtotal
+ * @property \Stripe\StripeObject[] $tax_amounts
+ * @property int $total
  * @property string $type
  * @property int|null $voided_at
  *
@@ -67,7 +73,7 @@ class CreditNote extends ApiResource
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return CreditNote The previewed credit note.
+     * @return \Stripe\CreditNote The previewed credit note.
      */
     public static function preview($params = null, $opts = null)
     {
@@ -101,7 +107,7 @@ public function voidCreditNote($params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return Collection The list of lines (CreditNoteLineItem).
+     * @return \Stripe\Collection The list of credit note line items.
      */
     public static function allLines($id, $params = null, $opts = null)
     {
diff --git a/lib/Customer.php b/lib/Customer.php
index 336ddc7b4..b183bfd09 100644
--- a/lib/Customer.php
+++ b/lib/Customer.php
@@ -7,7 +7,7 @@
  *
  * @property string $id
  * @property string $object
- * @property mixed|null $address
+ * @property \Stripe\StripeObject|null $address
  * @property int $balance
  * @property int $created
  * @property string|null $currency
@@ -17,13 +17,13 @@
  * @property \Stripe\Discount|null $discount
  * @property string|null $email
  * @property string|null $invoice_prefix
- * @property mixed $invoice_settings
+ * @property \Stripe\StripeObject $invoice_settings
  * @property bool $livemode
  * @property \Stripe\StripeObject $metadata
  * @property string|null $name
  * @property string|null $phone
  * @property string[]|null $preferred_locales
- * @property mixed|null $shipping
+ * @property \Stripe\StripeObject|null $shipping
  * @property \Stripe\Collection $sources
  * @property \Stripe\Collection $subscriptions
  * @property string|null $tax_exempt
@@ -85,7 +85,7 @@ public function deleteDiscount($params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return ApiResource
+     * @return \Stripe\AlipayAccount|\Stripe\BankAccount|\Stripe\BitcoinReceiver|\Stripe\Card|\Stripe\Source
      */
     public static function createSource($id, $params = null, $opts = null)
     {
@@ -100,7 +100,7 @@ public static function createSource($id, $params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return ApiResource
+     * @return \Stripe\AlipayAccount|\Stripe\BankAccount|\Stripe\BitcoinReceiver|\Stripe\Card|\Stripe\Source
      */
     public static function retrieveSource($id, $sourceId, $params = null, $opts = null)
     {
@@ -115,7 +115,7 @@ public static function retrieveSource($id, $sourceId, $params = null, $opts = nu
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return ApiResource
+     * @return \Stripe\AlipayAccount|\Stripe\BankAccount|\Stripe\BitcoinReceiver|\Stripe\Card|\Stripe\Source
      */
     public static function updateSource($id, $sourceId, $params = null, $opts = null)
     {
@@ -130,7 +130,7 @@ public static function updateSource($id, $sourceId, $params = null, $opts = null
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return ApiResource
+     * @return \Stripe\AlipayAccount|\Stripe\BankAccount|\Stripe\BitcoinReceiver|\Stripe\Card|\Stripe\Source
      */
     public static function deleteSource($id, $sourceId, $params = null, $opts = null)
     {
@@ -144,7 +144,7 @@ public static function deleteSource($id, $sourceId, $params = null, $opts = null
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return Collection The list of sources.
+     * @return \Stripe\Collection The list of sources.
      */
     public static function allSources($id, $params = null, $opts = null)
     {
@@ -158,7 +158,7 @@ public static function allSources($id, $params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return TaxId
+     * @return \Stripe\TaxId
      */
     public static function createTaxId($id, $params = null, $opts = null)
     {
@@ -173,7 +173,7 @@ public static function createTaxId($id, $params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return TaxId
+     * @return \Stripe\TaxId
      */
     public static function retrieveTaxId($id, $taxIdId, $params = null, $opts = null)
     {
@@ -188,7 +188,7 @@ public static function retrieveTaxId($id, $taxIdId, $params = null, $opts = null
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return TaxId
+     * @return \Stripe\TaxId
      */
     public static function deleteTaxId($id, $taxIdId, $params = null, $opts = null)
     {
@@ -202,7 +202,7 @@ public static function deleteTaxId($id, $taxIdId, $params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return Collection The list of tax ids.
+     * @return \Stripe\Collection The list of tax ids.
      */
     public static function allTaxIds($id, $params = null, $opts = null)
     {
@@ -216,7 +216,7 @@ public static function allTaxIds($id, $params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return BalanceTransaction
+     * @return \Stripe\BalanceTransaction
      */
     public static function createBalanceTransaction($id, $params = null, $opts = null)
     {
@@ -231,7 +231,7 @@ public static function createBalanceTransaction($id, $params = null, $opts = nul
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return BalanceTransaction
+     * @return \Stripe\BalanceTransaction
      */
     public static function retrieveBalanceTransaction($id, $balanceTransactionId, $params = null, $opts = null)
     {
@@ -246,7 +246,7 @@ public static function retrieveBalanceTransaction($id, $balanceTransactionId, $p
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return BalanceTransaction
+     * @return \Stripe\BalanceTransaction
      */
     public static function updateBalanceTransaction($id, $balanceTransactionId, $params = null, $opts = null)
     {
@@ -260,7 +260,7 @@ public static function updateBalanceTransaction($id, $balanceTransactionId, $par
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return Collection The list of balance transactions.
+     * @return \Stripe\Collection The list of balance transactions.
      */
     public static function allBalanceTransactions($id, $params = null, $opts = null)
     {
diff --git a/lib/Invoice.php b/lib/Invoice.php
index a5427d445..1cb73e36f 100644
--- a/lib/Invoice.php
+++ b/lib/Invoice.php
@@ -21,18 +21,18 @@
  * @property string|null $collection_method
  * @property int $created
  * @property string $currency
- * @property array|null $custom_fields
+ * @property \Stripe\StripeObject[]|null $custom_fields
  * @property string $customer
- * @property mixed|null $customer_address
+ * @property \Stripe\StripeObject|null $customer_address
  * @property string|null $customer_email
  * @property string|null $customer_name
  * @property string|null $customer_phone
- * @property mixed|null $customer_shipping
+ * @property \Stripe\StripeObject|null $customer_shipping
  * @property string|null $customer_tax_exempt
- * @property array|null $customer_tax_ids
+ * @property \Stripe\StripeObject[]|null $customer_tax_ids
  * @property string|null $default_payment_method
  * @property string|null $default_source
- * @property array|null $default_tax_rates
+ * @property \Stripe\TaxRate[]|null $default_tax_rates
  * @property string|null $description
  * @property \Stripe\Discount|null $discount
  * @property int|null $due_date
@@ -55,14 +55,15 @@
  * @property int $starting_balance
  * @property string|null $statement_descriptor
  * @property string|null $status
- * @property mixed $status_transitions
+ * @property \Stripe\StripeObject $status_transitions
  * @property string|null $subscription
  * @property int $subscription_proration_date
  * @property int $subtotal
  * @property int|null $tax
- * @property mixed $threshold_reason
+ * @property float|null $tax_percent
+ * @property \Stripe\StripeObject $threshold_reason
  * @property int $total
- * @property array|null $total_tax_amounts
+ * @property \Stripe\StripeObject[]|null $total_tax_amounts
  * @property int|null $webhooks_delivered_at
  *
  * @package Stripe
diff --git a/lib/Issuing/Authorization.php b/lib/Issuing/Authorization.php
index 6ce2f735e..fa1136c37 100644
--- a/lib/Issuing/Authorization.php
+++ b/lib/Issuing/Authorization.php
@@ -11,22 +11,22 @@
  * @property string $authorization_method
  * @property int $authorized_amount
  * @property string $authorized_currency
- * @property \Stripe\Collection $balance_transactions
- * @property Card $card
+ * @property \Stripe\BalanceTransaction[] $balance_transactions
+ * @property \Stripe\Issuing\Card $card
  * @property string|null $cardholder
  * @property int $created
  * @property int $held_amount
  * @property string $held_currency
  * @property bool $is_held_amount_controllable
  * @property bool $livemode
- * @property mixed $merchant_data
+ * @property \Stripe\StripeObject $merchant_data
  * @property \Stripe\StripeObject $metadata
  * @property int $pending_authorized_amount
  * @property int $pending_held_amount
- * @property mixed $request_history
+ * @property \Stripe\StripeObject[] $request_history
  * @property string $status
- * @property array $transactions
- * @property mixed $verification_data
+ * @property \Stripe\Issuing\Transaction[] $transactions
+ * @property \Stripe\StripeObject $verification_data
  * @property string|null $wallet_provider
  *
  * @package Stripe\Issuing
diff --git a/lib/Order.php b/lib/Order.php
index ef284be1d..db9993d8f 100644
--- a/lib/Order.php
+++ b/lib/Order.php
@@ -17,15 +17,15 @@
  * @property string|null $customer
  * @property string|null $email
  * @property string $external_coupon_code
- * @property OrderItem[] $items
+ * @property \Stripe\OrderItem[] $items
  * @property bool $livemode
  * @property \Stripe\StripeObject $metadata
  * @property \Stripe\Collection|null $returns
  * @property string|null $selected_shipping_method
- * @property mixed|null $shipping
- * @property array|null $shipping_methods
+ * @property \Stripe\StripeObject|null $shipping
+ * @property \Stripe\StripeObject[]|null $shipping_methods
  * @property string $status
- * @property mixed|null $status_transitions
+ * @property \Stripe\StripeObject|null $status_transitions
  * @property int|null $updated
  * @property string $upstream_id
  *
diff --git a/lib/PaymentIntent.php b/lib/PaymentIntent.php
index 4dd65f906..cd7f7f7dd 100644
--- a/lib/PaymentIntent.php
+++ b/lib/PaymentIntent.php
@@ -23,23 +23,23 @@
  * @property string|null $customer
  * @property string|null $description
  * @property string|null $invoice
- * @property mixed|null $last_payment_error
+ * @property \Stripe\StripeObject|null $last_payment_error
  * @property bool $livemode
  * @property \Stripe\StripeObject $metadata
- * @property mixed|null $next_action
+ * @property \Stripe\StripeObject|null $next_action
  * @property string|null $on_behalf_of
  * @property string|null $payment_method
- * @property mixed|null $payment_method_options
+ * @property \Stripe\StripeObject|null $payment_method_options
  * @property string[] $payment_method_types
  * @property string|null $receipt_email
  * @property string|null $review
  * @property string|null $setup_future_usage
- * @property mixed|null $shipping
+ * @property \Stripe\StripeObject|null $shipping
  * @property string|null $source
  * @property string|null $statement_descriptor
  * @property string|null $statement_descriptor_suffix
  * @property string $status
- * @property mixed|null $transfer_data
+ * @property \Stripe\StripeObject|null $transfer_data
  * @property string|null $transfer_group
  *
  * @package Stripe
diff --git a/lib/PaymentMethod.php b/lib/PaymentMethod.php
index 301541613..df7810506 100644
--- a/lib/PaymentMethod.php
+++ b/lib/PaymentMethod.php
@@ -7,16 +7,16 @@
  *
  * @property string $id
  * @property string $object
- * @property mixed|null $au_becs_debit
- * @property mixed $billing_details
- * @property mixed $card
- * @property mixed $card_present
+ * @property \Stripe\StripeObject $au_becs_debit
+ * @property \Stripe\StripeObject $billing_details
+ * @property \Stripe\StripeObject $card
+ * @property \Stripe\StripeObject $card_present
  * @property int $created
  * @property string|null $customer
- * @property mixed|null $ideal
+ * @property \Stripe\StripeObject $ideal
  * @property bool $livemode
  * @property \Stripe\StripeObject $metadata
- * @property mixed|null $sepa_debit
+ * @property \Stripe\StripeObject $sepa_debit
  * @property string $type
  *
  * @package Stripe
diff --git a/lib/SetupIntent.php b/lib/SetupIntent.php
index 3e21c7851..d167be7c9 100644
--- a/lib/SetupIntent.php
+++ b/lib/SetupIntent.php
@@ -13,14 +13,14 @@
  * @property int $created
  * @property string|null $customer
  * @property string|null $description
- * @property mixed|null $last_setup_error
+ * @property \Stripe\StripeObject|null $last_setup_error
  * @property bool $livemode
  * @property string|null $mandate
  * @property \Stripe\StripeObject $metadata
- * @property mixed|null $next_action
+ * @property \Stripe\StripeObject|null $next_action
  * @property string|null $on_behalf_of
  * @property string|null $payment_method
- * @property mixed|null $payment_method_options
+ * @property \Stripe\StripeObject|null $payment_method_options
  * @property string[] $payment_method_types
  * @property string|null $single_use_mandate
  * @property string $status
diff --git a/lib/Source.php b/lib/Source.php
index c22c0f5dc..5345499f5 100644
--- a/lib/Source.php
+++ b/lib/Source.php
@@ -7,42 +7,42 @@
  *
  * @property string $id
  * @property string $object
- * @property mixed $ach_credit_transfer
- * @property mixed $ach_debit
- * @property mixed $acss_debit
- * @property mixed $alipay
+ * @property \Stripe\StripeObject $ach_credit_transfer
+ * @property \Stripe\StripeObject $ach_debit
+ * @property \Stripe\StripeObject $acss_debit
+ * @property \Stripe\StripeObject $alipay
  * @property int|null $amount
- * @property mixed $au_becs_debit
- * @property mixed $bancontact
- * @property mixed $card
- * @property mixed $card_present
+ * @property \Stripe\StripeObject $au_becs_debit
+ * @property \Stripe\StripeObject $bancontact
+ * @property \Stripe\StripeObject $card
+ * @property \Stripe\StripeObject $card_present
  * @property string $client_secret
- * @property mixed $code_verification
+ * @property \Stripe\StripeObject $code_verification
  * @property int $created
  * @property string|null $currency
  * @property string $customer
- * @property mixed $eps
+ * @property \Stripe\StripeObject $eps
  * @property string $flow
- * @property mixed $giropay
- * @property mixed $ideal
- * @property mixed $klarna
+ * @property \Stripe\StripeObject $giropay
+ * @property \Stripe\StripeObject $ideal
+ * @property \Stripe\StripeObject $klarna
  * @property bool $livemode
  * @property \Stripe\StripeObject|null $metadata
- * @property mixed $multibanco
- * @property mixed|null $owner
- * @property mixed $p24
- * @property mixed $receiver
- * @property mixed $redirect
- * @property mixed $sepa_credit_transfer
- * @property mixed $sepa_debit
- * @property mixed $sofort
- * @property mixed $source_order
+ * @property \Stripe\StripeObject $multibanco
+ * @property \Stripe\StripeObject|null $owner
+ * @property \Stripe\StripeObject $p24
+ * @property \Stripe\StripeObject $receiver
+ * @property \Stripe\StripeObject $redirect
+ * @property \Stripe\StripeObject $sepa_credit_transfer
+ * @property \Stripe\StripeObject $sepa_debit
+ * @property \Stripe\StripeObject $sofort
+ * @property \Stripe\StripeObject $source_order
  * @property string|null $statement_descriptor
  * @property string $status
- * @property mixed $three_d_secure
+ * @property \Stripe\StripeObject $three_d_secure
  * @property string $type
  * @property string|null $usage
- * @property mixed $wechat
+ * @property \Stripe\StripeObject $wechat
  *
  * @package Stripe
  */
diff --git a/lib/Subscription.php b/lib/Subscription.php
index d9f35ddef..db8a2cc1d 100644
--- a/lib/Subscription.php
+++ b/lib/Subscription.php
@@ -9,7 +9,7 @@
  * @property string $object
  * @property float|null $application_fee_percent
  * @property int $billing_cycle_anchor
- * @property mixed|null $billing_thresholds
+ * @property \Stripe\StripeObject|null $billing_thresholds
  * @property int|null $cancel_at
  * @property bool $cancel_at_period_end
  * @property int|null $canceled_at
@@ -21,7 +21,7 @@
  * @property int|null $days_until_due
  * @property string|null $default_payment_method
  * @property string|null $default_source
- * @property array|null $default_tax_rates
+ * @property \Stripe\TaxRate[]|null $default_tax_rates
  * @property \Stripe\Discount|null $discount
  * @property int|null $ended_at
  * @property \Stripe\Collection $items
@@ -29,8 +29,9 @@
  * @property bool $livemode
  * @property \Stripe\StripeObject $metadata
  * @property int|null $next_pending_invoice_item_invoice
- * @property mixed|null $pending_invoice_item_interval
+ * @property \Stripe\StripeObject|null $pending_invoice_item_interval
  * @property string|null $pending_setup_intent
+ * @property \Stripe\StripeObject|null $pending_update
  * @property \Stripe\Plan|null $plan
  * @property int|null $quantity
  * @property string|null $schedule
diff --git a/lib/SubscriptionItem.php b/lib/SubscriptionItem.php
index 338a1c8d2..86b5a62f9 100644
--- a/lib/SubscriptionItem.php
+++ b/lib/SubscriptionItem.php
@@ -7,13 +7,13 @@
  *
  * @property string $id
  * @property string $object
- * @property mixed|null $billing_thresholds
+ * @property \Stripe\StripeObject|null $billing_thresholds
  * @property int $created
  * @property \Stripe\StripeObject $metadata
  * @property \Stripe\Plan $plan
  * @property int $quantity
  * @property string $subscription
- * @property array|null $tax_rates
+ * @property \Stripe\TaxRate[]|null $tax_rates
  *
  * @package Stripe
  */
diff --git a/lib/SubscriptionSchedule.php b/lib/SubscriptionSchedule.php
index 307a05600..6bb8f5529 100644
--- a/lib/SubscriptionSchedule.php
+++ b/lib/SubscriptionSchedule.php
@@ -7,22 +7,20 @@
  *
  * @property string $id
  * @property string $object
- * @property mixed|null $billing_thresholds
  * @property int|null $canceled_at
- * @property string|null $collection_method
  * @property int|null $completed_at
  * @property int $created
- * @property mixed|null $current_phase
+ * @property \Stripe\StripeObject|null $current_phase
  * @property string $customer
- * @property string|null $default_payment_method
+ * @property \Stripe\StripeObject $default_settings
  * @property string $end_behavior
  * @property mixed|null $invoice_settings
  * @property bool $livemode
  * @property \Stripe\StripeObject|null $metadata
- * @property mixed $phases
+ * @property \Stripe\StripeObject[] $phases
  * @property int|null $released_at
  * @property string|null $released_subscription
- * @property mixed|null $renewal_interval
+ * @property \Stripe\StripeObject|null $renewal_interval
  * @property string $status
  * @property string|null $subscription
  *
diff --git a/lib/Transfer.php b/lib/Transfer.php
index 1a44ee30d..15e377da5 100644
--- a/lib/Transfer.php
+++ b/lib/Transfer.php
@@ -69,7 +69,7 @@ public function cancel($params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return TransferReversal
+     * @return \Stripe\TransferReversal
      */
     public static function createReversal($id, $params = null, $opts = null)
     {
@@ -84,7 +84,7 @@ public static function createReversal($id, $params = null, $opts = null)
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return TransferReversal
+     * @return \Stripe\TransferReversal
      */
     public static function retrieveReversal($id, $reversalId, $params = null, $opts = null)
     {
@@ -99,7 +99,7 @@ public static function retrieveReversal($id, $reversalId, $params = null, $opts
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return TransferReversal
+     * @return \Stripe\TransferReversal
      */
     public static function updateReversal($id, $reversalId, $params = null, $opts = null)
     {
@@ -113,7 +113,7 @@ public static function updateReversal($id, $reversalId, $params = null, $opts =
      *
      * @throws \Stripe\Exception\ApiErrorException if the request fails
      *
-     * @return Collection The list of transfer reversals.
+     * @return \Stripe\Collection The list of transfer reversals.
      */
     public static function allReversals($id, $params = null, $opts = null)
     {