RubyGems - stripe - Versions diffs - 2.1.0 → 2.2.0 - Mend

stripe 2.1.0 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (18) hide show

checksums.yaml +4 -4
data/History.txt +4 -0
data/README.md +5 -1
data/Rakefile +2 -2
data/VERSION +1 -1
data/lib/stripe.rb +2 -0
data/lib/stripe/payout.rb +16 -0
data/lib/stripe/recipient_transfer.rb +4 -0
data/lib/stripe/util.rb +2 -0
data/lib/stripe/version.rb +1 -1
data/openapi/fixtures.json +1363 -1292
data/openapi/fixtures.yaml +1160 -1096
data/openapi/{spec.json → spec2.json} +1037 -608
data/openapi/{spec.yaml → spec2.yaml} +1266 -648
data/test/api_fixtures.rb +1 -1
data/test/api_stub_helpers.rb +1 -1
data/test/stripe/payout_test.rb +50 -0
metadata +8 -4

data/openapi/{spec.yaml → spec2.yaml} RENAMED

@@ -63,7 +63,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -86,7 +87,7 @@ definitions:
         type:
         - object
       id:
-        description: A unique identifier for the account.
+        description: Unique identifier for the object.
         type:
         - string
       legal_entity:
@@ -101,17 +102,32 @@ definitions:
         type:
         - string
       metadata:
-        description: A set of key/value pairs that you can attach to an account object.
-          It can be useful for storing additional information about the account in
-          a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       orders:
         "$ref": "#/definitions/settings"
+      payout_schedule:
+        "$ref": "#/definitions/transfer_schedule"
+      payout_statement_descriptor:
+        description: The text that will appear on the account's bank account statement
+          for payouts. If not set, this will default to your platform's bank descriptor
+          set on the Dashboard.
+        type:
+        - string
+      payouts_enabled:
+        description: Whether or not Stripe will send automatic transfers for this
+          account. This is only false when Stripe is waiting for additional information
+          from the account holder.
+        type:
+        - boolean
       product_description:
         description: An internal-only description of the product or service provided.
           This is used by Stripe in the event the account gets flagged for potential
@@ -132,26 +148,13 @@ definitions:
         type:
         - string
       timezone:
-        description: The timezone used in the Stripe dashboard for this account. A
-          list of possible timezone values is maintained at the [IANA Timezone Database](http://www.iana.org/time-zones).
+        description: The time zone used in the Stripe dashboard for this account.
+          A list of possible time zone values is maintained at the [IANA Time Zone
+          Database](http://www.iana.org/time-zones).
         type:
         - string
       tos_acceptance:
         "$ref": "#/definitions/account_tos_acceptance"
-      transfer_schedule:
-        "$ref": "#/definitions/transfer_schedule"
-      transfer_statement_descriptor:
-        description: The text that will appear on the account's bank account statement
-          for payouts. If not set, this will default to your platform's bank descriptor
-          set on the Dashboard.
-        type:
-        - string
-      transfers_enabled:
-        description: Whether or not Stripe will send automatic transfers for this
-          account. This is only false when Stripe is waiting for additional information
-          from the account holder.
-        type:
-        - boolean
       verification:
         "$ref": "#/definitions/account_verification"
     required:
@@ -167,9 +170,9 @@ definitions:
     - legal_entity
     - managed
     - object
+    - payout_schedule
+    - payouts_enabled
     - tos_acceptance
-    - transfer_schedule
-    - transfers_enabled
     - verification
     title: Account
     type:
@@ -305,7 +308,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -328,7 +332,7 @@ definitions:
         type:
         - object
       id:
-        description: A unique identifier for the account.
+        description: Unique identifier for the object.
         type:
         - string
       keys:
@@ -347,17 +351,32 @@ definitions:
         type:
         - string
       metadata:
-        description: A set of key/value pairs that you can attach to an account object.
-          It can be useful for storing additional information about the account in
-          a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       orders:
         "$ref": "#/definitions/settings"
+      payout_schedule:
+        "$ref": "#/definitions/transfer_schedule"
+      payout_statement_descriptor:
+        description: The text that will appear on the account's bank account statement
+          for payouts. If not set, this will default to your platform's bank descriptor
+          set on the Dashboard.
+        type:
+        - string
+      payouts_enabled:
+        description: Whether or not Stripe will send automatic transfers for this
+          account. This is only false when Stripe is waiting for additional information
+          from the account holder.
+        type:
+        - boolean
       product_description:
         description: An internal-only description of the product or service provided.
           This is used by Stripe in the event the account gets flagged for potential
@@ -378,26 +397,13 @@ definitions:
         type:
         - string
       timezone:
-        description: The timezone used in the Stripe dashboard for this account. A
-          list of possible timezone values is maintained at the [IANA Timezone Database](http://www.iana.org/time-zones).
+        description: The time zone used in the Stripe dashboard for this account.
+          A list of possible time zone values is maintained at the [IANA Time Zone
+          Database](http://www.iana.org/time-zones).
         type:
         - string
       tos_acceptance:
         "$ref": "#/definitions/account_tos_acceptance"
-      transfer_schedule:
-        "$ref": "#/definitions/transfer_schedule"
-      transfer_statement_descriptor:
-        description: The text that will appear on the account's bank account statement
-          for payouts. If not set, this will default to your platform's bank descriptor
-          set on the Dashboard.
-        type:
-        - string
-      transfers_enabled:
-        description: Whether or not Stripe will send automatic transfers for this
-          account. This is only false when Stripe is waiting for additional information
-          from the account holder.
-        type:
-        - boolean
       verification:
         "$ref": "#/definitions/account_verification"
     required:
@@ -414,9 +420,9 @@ definitions:
     - legal_entity
     - managed
     - object
+    - payout_schedule
+    - payouts_enabled
     - tos_acceptance
-    - transfer_schedule
-    - transfers_enabled
     - verification
     title: AccountWithKeys
     type:
@@ -455,7 +461,8 @@ definitions:
   alipay_account:
     properties:
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       customer:
@@ -468,21 +475,23 @@ definitions:
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       metadata:
-        description: A set of key/value pairs that you can attach to a customer object.
-          It can be useful for storing additional information about the customer in
-          a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       payment_amount:
@@ -526,7 +535,8 @@ definitions:
   apple_pay_domain:
     properties:
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       domain_name:
@@ -534,15 +544,17 @@ definitions:
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
     required:
@@ -590,11 +602,13 @@ definitions:
         type:
         - array
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       pending:
@@ -624,15 +638,18 @@ definitions:
         type:
         - integer
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: ''
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       description:
-        description: ''
+        description: An arbitrary string attached to the object. Often useful for
+          displaying to users.
         type:
         - string
       fee:
@@ -642,7 +659,7 @@ definitions:
       fee_details:
         "$ref": "#/definitions/fee"
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       net:
@@ -650,7 +667,8 @@ definitions:
         type:
         - integer
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       source:
@@ -735,8 +753,8 @@ definitions:
         type:
         - string
       currency:
-        description: Three-letter ISO currency code representing the currency paid
-          out to the bank account.
+        description: Three-letter [ISO code for the currency](https://support.stripe.com/questions/which-currencies-does-stripe-support)
+          paid out to the bank account.
         type:
         - string
       customer:
@@ -758,7 +776,7 @@ definitions:
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       last4:
@@ -766,13 +784,14 @@ definitions:
         type:
         - string
       metadata:
-        description: A set of key/value pairs that you can attach to a bank account
-          object. It can be useful for storing additional information about the bank
-          account in a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       reusable:
@@ -844,12 +863,13 @@ definitions:
         type:
         - string
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: Three-letter ISO currency code representing the currency to which
-          the bitcoin will be converted.
+        description: Three-letter [ISO code for the currency](https://support.stripe.com/questions/which-currencies-does-stripe-support)
+          to which the bitcoin will be converted.
         type:
         - string
       customer:
@@ -857,7 +877,8 @@ definitions:
         type:
         - string
       description:
-        description: ''
+        description: An arbitrary string attached to the object. Often useful for
+          displaying to users.
         type:
         - string
       email:
@@ -871,7 +892,7 @@ definitions:
         type:
         - boolean
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       inbound_address:
@@ -880,17 +901,19 @@ definitions:
         type:
         - string
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       metadata:
-        description: A set of key/value pairs that you can attach to a customer object.
-          It can be useful for storing additional information about the customer in
-          a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       payment:
@@ -899,8 +922,7 @@ definitions:
         type:
         - string
       refund_address:
-        description: The refund address for these bitcoin, if communicated by the
-          customer.
+        description: ''
         type:
         - string
       transactions:
@@ -916,7 +938,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -980,19 +1003,22 @@ definitions:
         type:
         - integer
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: The currency to which this transaction was converted.
+        description: Three-letter [ISO code for the currency](https://support.stripe.com/questions/which-currencies-does-stripe-support)
+          to which this transaction was converted.
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       receiver:
@@ -1019,7 +1045,7 @@ definitions:
         type:
         - string
       address_city:
-        description: ''
+        description: City/District/Suburb/Town/Village.
         type:
         - string
       address_country:
@@ -1027,7 +1053,7 @@ definitions:
         type:
         - string
       address_line1:
-        description: ''
+        description: Address line 1 (Street address/PO Box/Company name).
         type:
         - string
       address_line1_check:
@@ -1036,15 +1062,15 @@ definitions:
         type:
         - string
       address_line2:
-        description: ''
+        description: Address line 2 (Apartment/Suite/Unit/Building).
         type:
         - string
       address_state:
-        description: ''
+        description: State/County/Province/Region.
         type:
         - string
       address_zip:
-        description: ''
+        description: Zip/Postal Code.
         type:
         - string
       address_zip_check:
@@ -1070,8 +1096,9 @@ definitions:
         type:
         - string
       currency:
-        description: Only applicable on accounts (not customers or recipients). The
-          card can be used as a transfer destination for funds in this currency.
+        description: Three-letter [ISO code for currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
+          Only applicable on accounts (not customers or recipients). The card can
+          be used as a transfer destination for funds in this currency.
         type:
         - string
       customer:
@@ -1100,11 +1127,11 @@ definitions:
         type:
         - string
       exp_month:
-        description: ''
+        description: Two digit number representing the card's expiration month.
         type:
         - integer
       exp_year:
-        description: ''
+        description: Four digit number representing the card's expiration year.
         type:
         - integer
       fingerprint:
@@ -1122,18 +1149,17 @@ definitions:
         type:
         - string
       id:
-        description: ID of card (used in conjunction with a customer or recipient
-          ID).
+        description: Unique identifier for the object.
         type:
         - string
       last4:
-        description: ''
+        description: The last 4 digits of the card.
         type:
         - string
       metadata:
-        description: A set of key/value pairs that you can attach to a card object.
-          It can be useful for storing additional information about the card in a
-          structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       name:
@@ -1141,7 +1167,8 @@ definitions:
         type:
         - string
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       recipient:
@@ -1223,12 +1250,13 @@ definitions:
       card:
         "$ref": "#/definitions/card"
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: Three-letter ISO currency code representing the currency in which
-          the charge was made.
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       customer:
@@ -1236,7 +1264,8 @@ definitions:
         type:
         - string
       description:
-        description: ''
+        description: An arbitrary string attached to the object. Often useful for
+          displaying to users.
         type:
         - string
       destination:
@@ -1267,7 +1296,7 @@ definitions:
         type:
         - object
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       invoice:
@@ -1275,17 +1304,19 @@ definitions:
         type:
         - string
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       metadata:
-        description: A set of key/value pairs that you can attach to a charge object.
-          It can be useful for storing additional information about the charge in
-          a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       on_behalf_of:
@@ -1333,7 +1364,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -1459,11 +1491,13 @@ definitions:
         type:
         - string
       id:
-        description: The ISO Country code for this country.
+        description: Unique identifier for the object. Represented as the ISO country
+          code for this country.
         type:
         - string
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       supported_bank_account_currencies:
@@ -1510,12 +1544,14 @@ definitions:
         type:
         - integer
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: If `amount_off` has been set, the currency of the amount to take
-          off.
+        description: If `amount_off` has been set, the three-letter [ISO code for
+          the currency](https://support.stripe.com/questions/which-currencies-does-stripe-support)
+          of the amount to take off.
         type:
         - string
       duration:
@@ -1529,11 +1565,12 @@ definitions:
         type:
         - integer
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       max_redemptions:
@@ -1542,13 +1579,14 @@ definitions:
         type:
         - integer
       metadata:
-        description: A set of key/value pairs that you can attach to a coupon object.
-          It can be useful for storing additional information about the coupon in
-          a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       percent_off:
@@ -1608,7 +1646,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -1643,7 +1682,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -1682,7 +1722,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -1705,12 +1746,13 @@ definitions:
         type:
         - object
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: The currency the customer can be charged in for recurring billing
-          purposes.
+        description: Three-letter [ISO code for the currency](https://support.stripe.com/questions/which-currencies-does-stripe-support)
+          the customer can be charged in for recurring billing purposes.
         type:
         - string
       default_bank_account:
@@ -1731,31 +1773,34 @@ definitions:
         type:
         - boolean
       description:
-        description: ''
+        description: An arbitrary string attached to the object. Often useful for
+          displaying to users.
         type:
         - string
       discount:
         "$ref": "#/definitions/discount"
       email:
-        description: ''
+        description: The customer's email address.
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       metadata:
-        description: A set of key/value pairs that you can attach to a customer object.
-          It can be useful for storing additional information about the customer in
-          a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       shipping:
@@ -1774,7 +1819,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -1809,7 +1855,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -1871,17 +1918,18 @@ definitions:
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       metadata:
-        description: A set of key/value pairs that you can attach to a bank account
-          object. It can be useful for storing additional information about the bank
-          account in a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
     required:
@@ -1933,7 +1981,8 @@ definitions:
         type:
         - integer
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       start:
@@ -1968,12 +2017,13 @@ definitions:
         type:
         - string
       created:
-        description: Date dispute was opened.
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: Three-letter ISO currency code representing the currency of the
-          amount that was disputed.
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       evidence:
@@ -1986,7 +2036,7 @@ definitions:
         type:
         - object
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       is_charge_refundable:
@@ -1996,17 +2046,19 @@ definitions:
         type:
         - boolean
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       metadata:
-        description: A set of key/value pairs that you can attach to a dispute object.
-          It can be useful for storing additional information about the dispute in
-          a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       reason:
@@ -2092,21 +2144,24 @@ definitions:
         type:
         - string
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       data:
         "$ref": "#/definitions/event_data"
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       pending_webhooks:
@@ -2142,8 +2197,9 @@ definitions:
   event_data:
     properties:
       object:
-        description: describes the object the event is about. For example, an `invoice.created`
-          event will have a full invoice object as the value of the object key.
+        description: Static string describing the type of the object described by
+          this change. For example, an `invoice.created` event will have a full invoice
+          object as the value of the object key.
         type:
         - object
       previous_attributes:
@@ -2189,8 +2245,8 @@ definitions:
         type:
         - string
       currency:
-        description: Three-letter ISO currency code representing the currency paid
-          out to the bank account.
+        description: Three-letter [ISO code for the currency](https://support.stripe.com/questions/which-currencies-does-stripe-support)
+          paid out to the bank account.
         type:
         - string
       customer:
@@ -2208,7 +2264,7 @@ definitions:
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       last4:
@@ -2216,13 +2272,14 @@ definitions:
         type:
         - string
       metadata:
-        description: A set of key/value pairs that you can attach to a bank account
-          object. It can be useful for storing additional information about the bank
-          account in a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
     required:
@@ -2238,7 +2295,7 @@ definitions:
   fee:
     properties:
       amount:
-        description: ''
+        description: Amount of the fee, in cents.
         type:
         - integer
       application:
@@ -2246,11 +2303,13 @@ definitions:
         type:
         - string
       currency:
-        description: ''
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       description:
-        description: ''
+        description: An arbitrary string attached to the object. Often useful for
+          displaying to users.
         type:
         - string
       type:
@@ -2278,11 +2337,13 @@ definitions:
         type:
         - string
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: Three-letter ISO code representing the currency.
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       fee:
@@ -2290,16 +2351,18 @@ definitions:
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       metadata:
-        description: A set of key/value pairs that you can attach to the object. It
-          can be useful for storing additional information in a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
     required:
@@ -2388,7 +2451,8 @@ definitions:
         type:
         - boolean
       currency:
-        description: ''
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       customer:
@@ -2396,11 +2460,13 @@ definitions:
         type:
         - string
       date:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       description:
-        description: ''
+        description: An arbitrary string attached to the object. Often useful for
+          displaying to users.
         type:
         - string
       discount:
@@ -2421,7 +2487,7 @@ definitions:
         type:
         - boolean
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       lines:
@@ -2437,7 +2503,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -2460,13 +2527,14 @@ definitions:
         type:
         - object
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       metadata:
-        description: A set of key/value pairs that you can attach to an invoice object.
-          It can be useful for storing additional information about the invoice in
-          a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       next_payment_attempt:
@@ -2479,7 +2547,8 @@ definitions:
         type:
         - string
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       paid:
@@ -2577,15 +2646,17 @@ definitions:
   invoice_item:
     properties:
       amount:
-        description: ''
+        description: Amount (in the `currency` specified) of the invoice item.
         type:
         - integer
       currency:
-        description: ''
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       customer:
-        description: ''
+        description: The ID of the customer who will be billed when this invoice item
+          is billed.
         type:
         - string
       date:
@@ -2593,7 +2664,8 @@ definitions:
         type:
         - integer
       description:
-        description: ''
+        description: An arbitrary string attached to the object. Often useful for
+          displaying to users.
         type:
         - string
       discountable:
@@ -2602,25 +2674,27 @@ definitions:
         type:
         - boolean
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       invoice:
-        description: ''
+        description: The ID of the invoice this invoice item belongs to.
         type:
         - string
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       metadata:
-        description: A set of key/value pairs that you can attach to an invoice item
-          object. It can be useful for storing additional information about the invoice
-          item in a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       period:
@@ -2670,12 +2744,13 @@ definitions:
         type:
         - integer
       currency:
-        description: ''
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       description:
-        description: A text description of the line item, if the line item is an invoice
-          item.
+        description: An arbitrary string attached to the object. Often useful for
+          displaying to users.
         type:
         - string
       discountable:
@@ -2684,8 +2759,7 @@ definitions:
         type:
         - boolean
       id:
-        description: The ID of the source of this line item, either an invoice item
-          or a subscription.
+        description: Unique identifier for the object.
         type:
         - string
       livemode:
@@ -2693,12 +2767,14 @@ definitions:
         type:
         - boolean
       metadata:
-        description: Key-value pairs attached to object that underlies this line item
-          (either subscription or invoice item).
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: The type of object. Always has the value "line_item".
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       period:
@@ -2771,11 +2847,13 @@ definitions:
         type:
         - string
       created:
-        description: Time that this record of the transfer was first created.
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: ''
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       date:
@@ -2809,7 +2887,7 @@ definitions:
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       legacy_date:
@@ -2817,13 +2895,14 @@ definitions:
         type:
         - integer
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       metadata:
-        description: A set of key/value pairs that you can attach to a transfer object.
-          It can be useful for storing additional information about the transfer in
-          a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       method:
@@ -2834,7 +2913,8 @@ definitions:
         type:
         - string
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       reversals:
@@ -2850,7 +2930,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -3203,12 +3284,13 @@ definitions:
         type:
         - string
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: 3-letter [ISO code](https://support.stripe.com/questions/which-currencies-does-stripe-support)
-          representing the currency in which the order was made.
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       customer:
@@ -3224,23 +3306,25 @@ definitions:
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       items:
         "$ref": "#/definitions/order_item"
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       metadata:
-        description: A set of key/value pairs that you can attach to an order object.
-          It can be useful for storing additional information about the order in a
-          structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       returns:
@@ -3256,7 +3340,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -3328,8 +3413,8 @@ definitions:
         type:
         - integer
       currency:
-        description: 3-letter [ISO code](https://support.stripe.com/questions/which-currencies-does-stripe-support)
-          representing the currency of the line item.
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       description:
@@ -3338,7 +3423,8 @@ definitions:
         type:
         - string
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       parent:
@@ -3391,26 +3477,29 @@ definitions:
         type:
         - integer
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: 3-letter [ISO code](https://support.stripe.com/questions/which-currencies-does-stripe-support)
-          representing the currency of the return.
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       items:
         "$ref": "#/definitions/order_item"
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       order:
@@ -3460,6 +3549,121 @@ definitions:
     type:
     - object
     x-resourceId: package_dimensions
+  payout:
+    properties:
+      amount:
+        description: Amount (in %s) to be transferred to your bank account or debit
+          card.
+        type:
+        - integer
+      arrival_date:
+        description: Date the payout is expected to arrive in the bank. This factors
+          in delays like weekends or bank holidays.
+        type:
+        - integer
+      balance_transaction:
+        description: ID of the balance transaction that describes the impact of this
+          payout on your account balance.
+        type:
+        - string
+      created:
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
+        type:
+        - integer
+      currency:
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
+        type:
+        - string
+      destination:
+        description: ID of the bank account or card the payout was sent to.
+        type:
+        - string
+      failure_balance_transaction:
+        description: If the payout failed or was canceled, this will be the ID of
+          the balance transaction that reversed the initial balance transaction, and
+          puts the funds from the failed payout back in your balance.
+        type:
+        - string
+      failure_code:
+        description: Error code explaining reason for payout failure if available.
+          See [Types of payout failures](/docs/api#payout_failures) for a list of
+          failure codes.
+        type:
+        - string
+      failure_message:
+        description: Message to user further explaining reason for payout failure
+          if available.
+        type:
+        - string
+      id:
+        description: Unique identifier for the object.
+        type:
+        - string
+      livemode:
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
+        type:
+        - boolean
+      metadata:
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
+        type:
+        - object
+      method:
+        description: The method used to send this payout, which can be `standard`
+          or `instant`. `instant` is only supported for payouts to debit cards. (See
+          [Instant payouts for marketplaces](/blog/instant-payouts-for-marketplaces)
+          for more information.)
+        type:
+        - string
+      object:
+        description: String representing the object's type. Objects of the same type
+          share the same value.
+        type:
+        - string
+      source_type:
+        description: The source balance this payout came from. One of `card`, `bank_account`,
+          `bitcoin_receiver`, or `alipay_account`.
+        type:
+        - string
+      statement_descriptor:
+        description: Extra information about a payout to be displayed on the user's
+          bank statement.
+        type:
+        - string
+      status:
+        description: Current status of the payout (`paid`, `pending`, `in_transit`,
+          `canceled` or `failed`). A payout will be `pending` until it is submitted
+          to the bank, at which point it becomes `in_transit`. It will then change
+          to `paid` if the transaction goes through. If it does not go through successfully,
+          its status will change to `failed` or `canceled`.
+        type:
+        - string
+      type:
+        description: Can be `bank_account` or `card`.
+        type:
+        - string
+    required:
+    - amount
+    - arrival_date
+    - created
+    - currency
+    - destination
+    - id
+    - livemode
+    - metadata
+    - method
+    - object
+    - source_type
+    - status
+    - type
+    title: Payout
+    type:
+    - object
+    x-resourceId: payout
   plan:
     properties:
       amount:
@@ -3467,15 +3671,17 @@ definitions:
         type:
         - integer
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: Currency in which subscription will be charged.
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       interval:
@@ -3490,13 +3696,14 @@ definitions:
         type:
         - integer
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       metadata:
-        description: A set of key/value pairs that you can attach to a plan object.
-          It can be useful for storing additional information about the plan in a
-          structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       name:
@@ -3504,7 +3711,8 @@ definitions:
         type:
         - string
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       statement_descriptor:
@@ -3561,23 +3769,27 @@ definitions:
         type:
         - string
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: Three-letter ISO code representing the currency of the charge.
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       originating_transaction:
@@ -3603,7 +3815,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -3660,7 +3873,8 @@ definitions:
         type:
         - string
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       deactivate_on:
@@ -3673,7 +3887,7 @@ definitions:
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       images:
@@ -3682,13 +3896,14 @@ definitions:
         type:
         - array
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       metadata:
-        description: A set of key/value pairs that you can attach to a product object.
-          It can be useful for storing additional information about the product in
-          a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       name:
@@ -3696,7 +3911,8 @@ definitions:
         type:
         - string
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       package_dimensions:
@@ -3718,7 +3934,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -3780,28 +3997,33 @@ definitions:
         type:
         - string
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: Three-letter ISO code representing the currency.
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       description:
-        description: ''
+        description: An arbitrary string attached to the object. Often useful for
+          displaying to users.
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       metadata:
-        description: A set of key/value pairs that you can attach to the object. It
-          can be useful for storing additional information in a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       reason:
@@ -3903,19 +4125,19 @@ definitions:
         type:
         - integer
       currency:
-        description: 3-letter [ISO code](https://support.stripe.com/questions/which-currencies-does-stripe-support)
-          representing the currency of the line item.
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       delivery_estimate:
         "$ref": "#/definitions/delivery_estimate"
       description:
-        description: Description of the line item, meant to be displayable to the
-          user (e.g., `"Express shipping"`).
+        description: An arbitrary string attached to the object. Often useful for
+          displaying to users.
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
     required:
@@ -3934,12 +4156,13 @@ definitions:
         type:
         - integer
       currency:
-        description: Currency in which shipping cost will be assessed. Present when
-          `type` is `flat_rate`.
+        description: Three-letter [ISO code for the currency](https://support.stripe.com/questions/which-currencies-does-stripe-support)
+          in which shipping cost will be assessed. Present when `type` is `flat_rate`.
         type:
         - string
       description:
-        description: ''
+        description: An arbitrary string attached to the object. Often useful for
+          displaying to users.
         type:
         - string
       free_above:
@@ -3985,13 +4208,13 @@ definitions:
         type:
         - integer
       currency:
-        description: 3-letter [ISO code](https://support.stripe.com/questions/which-currencies-does-stripe-support)
-          representing the currency of the line item.
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       description:
-        description: Description of the line item, meant to be displayable to the
-          user (e.g., `"Express shipping"`).
+        description: An arbitrary string attached to the object. Often useful for
+          displaying to users.
         type:
         - string
     required:
@@ -4016,16 +4239,17 @@ definitions:
         type:
         - object
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: 3-letter [ISO code](https://support.stripe.com/questions/which-currencies-does-stripe-support)
-          for currency.
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       image:
@@ -4036,17 +4260,19 @@ definitions:
       inventory:
         "$ref": "#/definitions/inventory"
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       metadata:
-        description: A set of key/value pairs that you can attach to a SKU object.
-          It can be useful for storing additional information about the SKU in a structured
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
           format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       package_dimensions:
@@ -4098,13 +4324,14 @@ definitions:
       code_verification:
         "$ref": "#/definitions/source_code_verification_flow"
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: The currency associated with the source. This is the currency
-          for which the source will be chargeable once ready. Required for `single-use`
-          sources.
+        description: Three-letter [ISO code for the currency](https://support.stripe.com/questions/which-currencies-does-stripe-support)
+          associated with the source. This is the currency for which the source will
+          be chargeable once ready. Required for `single-use` sources.
         type:
         - string
       flow:
@@ -4113,21 +4340,23 @@ definitions:
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       metadata:
-        description: A set of key/value pairs that you can attach to a source object.
-          It can be useful for storing additional information about the source in
-          a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       owner:
@@ -4335,7 +4564,8 @@ definitions:
         type:
         - integer
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       current_period_end:
@@ -4366,7 +4596,7 @@ definitions:
         type:
         - integer
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       items:
@@ -4382,7 +4612,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -4405,7 +4636,8 @@ definitions:
         type:
         - object
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       max_occurrences:
@@ -4413,13 +4645,14 @@ definitions:
         type:
         - integer
       metadata:
-        description: A set of key/value pairs that you can attach to a subscription
-          object. It can be useful for storing additional information about the subscription
-          in a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       on_behalf_of:
@@ -4488,15 +4721,17 @@ definitions:
   subscription_item:
     properties:
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       plan:
@@ -4519,7 +4754,8 @@ definitions:
   tax_settings:
     properties:
       description:
-        description: ''
+        description: An arbitrary string attached to the object. Often useful for
+          displaying to users.
         type:
         - string
       provider:
@@ -4559,23 +4795,27 @@ definitions:
       card:
         "$ref": "#/definitions/card"
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: ''
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       redirect_url:
@@ -4618,19 +4858,22 @@ definitions:
         type:
         - string
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       type:
@@ -4703,8 +4946,8 @@ definitions:
         type:
         - string
       currency:
-        description: Three-letter ISO currency code representing the currency paid
-          out to the bank account.
+        description: Three-letter [ISO code for the currency](https://support.stripe.com/questions/which-currencies-does-stripe-support)
+          paid out to the bank account.
         type:
         - string
       fingerprint:
@@ -4713,7 +4956,7 @@ definitions:
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       last4:
@@ -4721,7 +4964,8 @@ definitions:
         type:
         - string
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       reusable:
@@ -4763,7 +5007,7 @@ definitions:
   token_card:
     properties:
       address_city:
-        description: ''
+        description: City/District/Suburb/Town/Village.
         type:
         - string
       address_country:
@@ -4771,7 +5015,7 @@ definitions:
         type:
         - string
       address_line1:
-        description: ''
+        description: Address line 1 (Street address/PO Box/Company name).
         type:
         - string
       address_line1_check:
@@ -4780,15 +5024,15 @@ definitions:
         type:
         - string
       address_line2:
-        description: ''
+        description: Address line 2 (Apartment/Suite/Unit/Building).
         type:
         - string
       address_state:
-        description: ''
+        description: State/County/Province/Region.
         type:
         - string
       address_zip:
-        description: ''
+        description: Zip/Postal Code.
         type:
         - string
       address_zip_check:
@@ -4808,7 +5052,8 @@ definitions:
         type:
         - string
       currency:
-        description: ''
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       cvc_check:
@@ -4822,11 +5067,11 @@ definitions:
         type:
         - string
       exp_month:
-        description: ''
+        description: Two digit number representing the card's expiration month.
         type:
         - integer
       exp_year:
-        description: ''
+        description: Four digit number representing the card's expiration year.
         type:
         - integer
       fingerprint:
@@ -4844,18 +5089,17 @@ definitions:
         type:
         - string
       id:
-        description: ID of card (used in conjunction with a customer or recipient
-          ID).
+        description: Unique identifier for the object.
         type:
         - string
       last4:
-        description: ''
+        description: The last 4 digits of the card.
         type:
         - string
       metadata:
-        description: A set of key/value pairs that you can attach to a card object.
-          It can be useful for storing additional information about the card in a
-          structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       name:
@@ -4863,7 +5107,8 @@ definitions:
         type:
         - string
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       three_d_secure:
@@ -4891,47 +5136,55 @@ definitions:
   transfer:
     properties:
       amount:
-        description: ''
+        description: Amount in %s to be transferred.
         type:
         - integer
       amount_reversed:
-        description: ''
+        description: Amount in %s reversed (can be less than the amount attribute
+          on the transfer if a partial reversal was issued).
         type:
         - integer
       balance_transaction:
-        description: ''
+        description: Balance transaction that describes the impact of this transfer
+          on your account balance.
         type:
         - string
       created:
-        description: ''
+        description: Time that this record of the transfer was first created.
         type:
         - integer
       currency:
-        description: ''
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       destination:
-        description: ''
+        description: ID of the Stripe account the transfer was sent to.
         type:
         - string
       destination_payment:
-        description: ''
+        description: If the destination is a Stripe account, this will be the ID of
+          the payment that the destination account received for the transfer.
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       metadata:
-        description: ''
+        description: A set of key/value pairs that you can attach to a transfer object.
+          It can be useful for storing additional information about the transfer in
+          a structured format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       reversals:
@@ -4947,7 +5200,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -4970,13 +5224,20 @@ definitions:
         type:
         - object
       reversed:
-        description: ''
+        description: Whether or not the transfer has been fully reversed. If the transfer
+          is only partially reversed, this attribute will still be false.
         type:
         - boolean
-      transfer_group:
+      source_type:
         description: ''
         type:
         - string
+      transfer_group:
+        description: A string that identifies this transaction as part of a group.
+          See the [Connect documentation](/docs/connect/charges-transfers#grouping-transactions)
+          for details.
+        type:
+        - string
     required:
     - amount
     - amount_reversed
@@ -5009,7 +5270,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -5032,7 +5294,8 @@ definitions:
         type:
         - object
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       default_card:
@@ -5040,7 +5303,8 @@ definitions:
         type:
         - string
       description:
-        description: ''
+        description: An arbitrary string attached to the object. Often useful for
+          displaying to users.
         type:
         - string
       email:
@@ -5048,17 +5312,18 @@ definitions:
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       metadata:
-        description: A set of key/value pairs that you can attach to a recipient object.
-          It can be useful for storing additional information about the recipient
-          in a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       migrated_to:
@@ -5072,7 +5337,8 @@ definitions:
         type:
         - string
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       tin:
@@ -5111,24 +5377,28 @@ definitions:
         type:
         - string
       created:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       currency:
-        description: Three-letter ISO code representing the currency.
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       id:
-        description: ''
+        description: Unique identifier for the object.
         type:
         - string
       metadata:
-        description: A set of key/value pairs that you can attach to the object. It
-          can be useful for storing additional information in a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       transfer:
@@ -5277,7 +5547,8 @@ definitions:
         type:
         - boolean
       currency:
-        description: ''
+        description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+          in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
         type:
         - string
       customer:
@@ -5285,11 +5556,13 @@ definitions:
         type:
         - string
       date:
-        description: ''
+        description: Time at which the object was created. Measured in seconds since
+          the Unix epoch.
         type:
         - integer
       description:
-        description: ''
+        description: An arbitrary string attached to the object. Often useful for
+          displaying to users.
         type:
         - string
       discount:
@@ -5322,7 +5595,8 @@ definitions:
             type:
             - boolean
           object:
-            description: The type of object. Always has the value "list".
+            description: String representing the object's type. Objects of the same
+              type share the same value. Always has the value "list".
             enum:
             - list
             type:
@@ -5345,13 +5619,14 @@ definitions:
         type:
         - object
       livemode:
-        description: ''
+        description: Flag indicating whether the object exists in live mode or test
+          mode.
         type:
         - boolean
       metadata:
-        description: A set of key/value pairs that you can attach to an invoice object.
-          It can be useful for storing additional information about the invoice in
-          a structured format.
+        description: Set of key/value pairs that you can attach to an object. It can
+          be useful for storing additional information about the object in a structured
+          format.
         type:
         - object
       next_payment_attempt:
@@ -5364,7 +5639,8 @@ definitions:
         type:
         - string
       object:
-        description: ''
+        description: String representing the object's type. Objects of the same type
+          share the same value.
         type:
         - string
       paid:
@@ -5468,7 +5744,7 @@ info:
     details.
   termsOfService: https://stripe.com/us/terms/
   title: Stripe API
-  version: '2017-02-14'
+  version: '2017-04-06'
 paths:
   "/v1/3d_secure":
     post:
@@ -5494,8 +5770,8 @@ paths:
               type:
               - string
             currency:
-              description: Currency of the charge that you will create when authentication
-                completes.
+              description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+                in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
               title: currency
               type:
               - string
@@ -5544,12 +5820,12 @@ paths:
             "$ref": "#/definitions/error"
   "/v1/account":
     delete:
-      description: |-
-        <p>With <a href="/docs/connect">Connect</a>, you may delete Stripe accounts you manage.</p>
-        <p>Managed accounts created using test-mode keys can be deleted at any time. Managed accounts created using live-mode keys may only be deleted once all balances are zero.</p>
-        <p>If you are looking to close your own account, use the <a href="http://dashboard:6090/account/data">data tab in your account settings</a> instead.</p>
+      description: <p>With <a href="/docs/connect">Connect</a>, you may delete Stripe
+        accounts you manage.</p><p>Managed accounts created using test-mode keys can
+        be deleted at any time. Managed accounts created using live-mode keys may
+        only be deleted once all balances are zero.</p><p>If you are looking to close
+        your own account, use the <a href="https://dashboard.stripe.com/account/data">data
+        tab in your account settings</a> instead.</p>
       operationId: AccountDelete
       parameters:
       - description: Body parameters for the request.
@@ -5593,10 +5869,12 @@ paths:
           schema:
             "$ref": "#/definitions/error"
     post:
-      description: |-
-        <p>Updates an account by setting the values of the parameters passed. Any parameters not provided will be left unchanged.</p>
-        <p><strong>You may only update accounts that you <a href="/docs/connect/managed-accounts">manage</a></strong>. To update your own account, you can currently only do so via the <a href="http://dashboard:6090/account">dashboard</a>. For more information on updating Managed Accounts, see <a href="/docs/connect/updating-accounts">our guide</a>.</p>
+      description: <p>Updates an account by setting the values of the parameters passed.
+        Any parameters not provided will be left unchanged.</p><p><strong>You may
+        only update accounts that you <a href="/docs/connect/managed-accounts">manage</a></strong>.
+        To update your own account, you can currently only do so via the <a href="https://dashboard.stripe.com/account">dashboard</a>.
+        For more information on updating Managed Accounts, see <a href="/docs/connect/updating-accounts">our
+        guide</a>.</p>
       operationId: AccountUpdate
       parameters:
       - description: Body parameters for the request.
@@ -5630,7 +5908,7 @@ paths:
             debit_negative_balances:
               description: A boolean for whether or not Stripe should try to reclaim
                 negative balances from the account holder's bank account. See our
-                [managed account bank transfer guide](/docs/connect/bank-transfers#negative-balances)
+                [managed account bank transfer guide](/docs/connect/account-balances)
                 for more information.
               title: debit_negative_balances
               type:
@@ -5644,7 +5922,7 @@ paths:
             default_currency:
               description: Three-letter ISO currency code representing the default
                 currency for the account. This must be a currency that [Stripe supports
-                in the account's country](http://127.0.0.1:6041/questions/which-currencies-does-stripe-support).
+                in the account's country](https://support.stripe.com/questions/which-currencies-does-stripe-support).
               title: default_currency
               type:
               - string
@@ -5693,6 +5971,21 @@ paths:
               title: orders
               type:
               - object
+            payout_schedule:
+              description: Details on when this account will make funds from charges
+                available, and when they will be paid out to the account holder's
+                bank account. See our [managed account bank transfer guide](/docs/connect/bank-transfers#payout-information)
+                for more information.
+              title: payout_schedule
+              type:
+              - object
+            payout_statement_descriptor:
+              description: The text that will appear on the account's bank account
+                statement for payouts. If not set, this will default to your platform's
+                bank descriptor set on the Dashboard.
+              title: payout_statement_descriptor
+              type:
+              - string
             product_description:
               description: Internal-only description of the product being sold or
                 service being provided by this account. It's used by Stripe for risk
@@ -5724,28 +6017,13 @@ paths:
               title: support_url
               type:
               - string
-            tos_acceptance:
-              description: Details on who accepted the Stripe terms of service, and
-                when they accepted it. See our [updating managed accounts guide](/docs/connect/updating-accounts#tos_acceptance)
-                for more information.
-              title: tos_acceptance
-              type:
-              - object
-            transfer_schedule:
-              description: Details on when this account will make funds from charges
-                available, and when they will be paid out to the account holder's
-                bank account. See our [managed account bank transfer guide](/docs/connect/bank-transfers#payout-information)
+            tos_acceptance:
+              description: Details on who accepted the Stripe terms of service, and
+                when they accepted it. See our [updating managed accounts guide](/docs/connect/updating-accounts#tos-acceptance)
                 for more information.
-              title: transfer_schedule
+              title: tos_acceptance
               type:
               - object
-            transfer_statement_descriptor:
-              description: The text that will appear on the account's bank account
-                statement for payouts. If not set, this will default to your platform's
-                bank descriptor set on the Dashboard.
-              title: transfer_statement_descriptor
-              type:
-              - string
       responses:
         '200':
           description: Successful response.
@@ -5899,7 +6177,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -6069,7 +6348,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -6136,7 +6416,7 @@ paths:
             debit_negative_balances:
               description: A boolean for whether or not Stripe should try to reclaim
                 negative balances from the account holder's bank account. See our
-                [managed account bank transfer guide](/docs/connect/bank-transfers#negative-balances)
+                [managed account bank transfer guide](/docs/connect/account-balances)
                 for more information.
               title: debit_negative_balances
               type:
@@ -6150,7 +6430,7 @@ paths:
             default_currency:
               description: Three-letter ISO currency code representing the default
                 currency for the account. This must be a currency that [Stripe supports
-                in the account's country](http://127.0.0.1:6041/questions/which-currencies-does-stripe-support).
+                in the account's country](https://support.stripe.com/questions/which-currencies-does-stripe-support).
               title: default_currency
               type:
               - string
@@ -6204,6 +6484,21 @@ paths:
               title: orders
               type:
               - object
+            payout_schedule:
+              description: Details on when this account will make funds from charges
+                available, and when they will be paid out to the account holder's
+                bank account. See our [managed account bank transfer guide](/docs/connect/bank-transfers#payout-information)
+                for more information.
+              title: payout_schedule
+              type:
+              - object
+            payout_statement_descriptor:
+              description: The text that will appear on the account's bank account
+                statement for payouts. If not set, this will default to your platform's
+                bank descriptor set on the Dashboard.
+              title: payout_statement_descriptor
+              type:
+              - string
             platform_account:
               description: ''
               title: platform_account
@@ -6242,26 +6537,11 @@ paths:
               - string
             tos_acceptance:
               description: Details on who accepted the Stripe terms of service, and
-                when they accepted it. See our [updating managed accounts guide](/docs/connect/updating-accounts#tos_acceptance)
+                when they accepted it. See our [updating managed accounts guide](/docs/connect/updating-accounts#tos-acceptance)
                 for more information.
               title: tos_acceptance
               type:
               - object
-            transfer_schedule:
-              description: Details on when this account will make funds from charges
-                available, and when they will be paid out to the account holder's
-                bank account. See our [managed account bank transfer guide](/docs/connect/bank-transfers#payout-information)
-                for more information.
-              title: transfer_schedule
-              type:
-              - object
-            transfer_statement_descriptor:
-              description: The text that will appear on the account's bank account
-                statement for payouts. If not set, this will default to your platform's
-                bank descriptor set on the Dashboard.
-              title: transfer_statement_descriptor
-              type:
-              - string
       responses:
         '200':
           description: Successful response.
@@ -6273,12 +6553,12 @@ paths:
             "$ref": "#/definitions/error"
   "/v1/accounts/{account}":
     delete:
-      description: |-
-        <p>With <a href="/docs/connect">Connect</a>, you may delete Stripe accounts you manage.</p>
-        <p>Managed accounts created using test-mode keys can be deleted at any time. Managed accounts created using live-mode keys may only be deleted once all balances are zero.</p>
-        <p>If you are looking to close your own account, use the <a href="http://dashboard:6090/account/data">data tab in your account settings</a> instead.</p>
+      description: <p>With <a href="/docs/connect">Connect</a>, you may delete Stripe
+        accounts you manage.</p><p>Managed accounts created using test-mode keys can
+        be deleted at any time. Managed accounts created using live-mode keys may
+        only be deleted once all balances are zero.</p><p>If you are looking to close
+        your own account, use the <a href="https://dashboard.stripe.com/account/data">data
+        tab in your account settings</a> instead.</p>
       operationId: AccountDelete
       parameters:
       - description: The identifier of the account to be deleted. If none is provided,
@@ -6316,10 +6596,12 @@ paths:
           schema:
             "$ref": "#/definitions/error"
     post:
-      description: |-
-        <p>Updates an account by setting the values of the parameters passed. Any parameters not provided will be left unchanged.</p>
-        <p><strong>You may only update accounts that you <a href="/docs/connect/managed-accounts">manage</a></strong>. To update your own account, you can currently only do so via the <a href="http://dashboard:6090/account">dashboard</a>. For more information on updating Managed Accounts, see <a href="/docs/connect/updating-accounts">our guide</a>.</p>
+      description: <p>Updates an account by setting the values of the parameters passed.
+        Any parameters not provided will be left unchanged.</p><p><strong>You may
+        only update accounts that you <a href="/docs/connect/managed-accounts">manage</a></strong>.
+        To update your own account, you can currently only do so via the <a href="https://dashboard.stripe.com/account">dashboard</a>.
+        For more information on updating Managed Accounts, see <a href="/docs/connect/updating-accounts">our
+        guide</a>.</p>
       operationId: AccountUpdate
       parameters:
       - description: Body parameters for the request.
@@ -6353,7 +6635,7 @@ paths:
             debit_negative_balances:
               description: A boolean for whether or not Stripe should try to reclaim
                 negative balances from the account holder's bank account. See our
-                [managed account bank transfer guide](/docs/connect/bank-transfers#negative-balances)
+                [managed account bank transfer guide](/docs/connect/account-balances)
                 for more information.
               title: debit_negative_balances
               type:
@@ -6367,7 +6649,7 @@ paths:
             default_currency:
               description: Three-letter ISO currency code representing the default
                 currency for the account. This must be a currency that [Stripe supports
-                in the account's country](http://127.0.0.1:6041/questions/which-currencies-does-stripe-support).
+                in the account's country](https://support.stripe.com/questions/which-currencies-does-stripe-support).
               title: default_currency
               type:
               - string
@@ -6416,6 +6698,21 @@ paths:
               title: orders
               type:
               - object
+            payout_schedule:
+              description: Details on when this account will make funds from charges
+                available, and when they will be paid out to the account holder's
+                bank account. See our [managed account bank transfer guide](/docs/connect/bank-transfers#payout-information)
+                for more information.
+              title: payout_schedule
+              type:
+              - object
+            payout_statement_descriptor:
+              description: The text that will appear on the account's bank account
+                statement for payouts. If not set, this will default to your platform's
+                bank descriptor set on the Dashboard.
+              title: payout_statement_descriptor
+              type:
+              - string
             product_description:
               description: Internal-only description of the product being sold or
                 service being provided by this account. It's used by Stripe for risk
@@ -6449,26 +6746,11 @@ paths:
               - string
             tos_acceptance:
               description: Details on who accepted the Stripe terms of service, and
-                when they accepted it. See our [updating managed accounts guide](/docs/connect/updating-accounts#tos_acceptance)
+                when they accepted it. See our [updating managed accounts guide](/docs/connect/updating-accounts#tos-acceptance)
                 for more information.
               title: tos_acceptance
               type:
               - object
-            transfer_schedule:
-              description: Details on when this account will make funds from charges
-                available, and when they will be paid out to the account holder's
-                bank account. See our [managed account bank transfer guide](/docs/connect/bank-transfers#payout-information)
-                for more information.
-              title: transfer_schedule
-              type:
-              - object
-            transfer_statement_descriptor:
-              description: The text that will appear on the account's bank account
-                statement for payouts. If not set, this will default to your platform's
-                bank descriptor set on the Dashboard.
-              title: transfer_statement_descriptor
-              type:
-              - string
       responses:
         '200':
           description: Successful response.
@@ -6622,7 +6904,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -6747,10 +7030,10 @@ paths:
             "$ref": "#/definitions/error"
   "/v1/accounts/{account}/reject":
     post:
-      description: |-
-        <p>With <a href="/docs/connect">Connect</a>, you may flag managed accounts as suspicious.</p>
-        <p>Managed accounts created using test-mode keys can be rejected at any time. Managed accounts created using live-mode keys may only be rejected once all balances are zero.</p>
+      description: <p>With <a href="/docs/connect">Connect</a>, you may flag managed
+        accounts as suspicious.</p><p>Managed accounts created using test-mode keys
+        can be rejected at any time. Managed accounts created using live-mode keys
+        may only be rejected once all balances are zero.</p>
       operationId: AccountReject
       parameters:
       - description: The identifier of the account to be rejected.
@@ -6831,7 +7114,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -6980,7 +7264,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -7034,10 +7319,9 @@ paths:
           schema:
             "$ref": "#/definitions/error"
     post:
-      description: |-
-        <p>Updates the specified application fee refund by setting the values of the parameters passed. Any parameters not provided will be left unchanged.</p>
-        <p>This request only accepts metadata as an argument.</p>
+      description: "<p>Updates the specified application fee refund by setting the
+        values of the parameters passed. Any parameters not provided will be left
+        unchanged.</p><p>This request only accepts metadata as an argument.</p>"
       operationId: UpdatePlatformEarningRefund
       parameters:
       - description: Body parameters for the request.
@@ -7172,7 +7456,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -7284,10 +7569,10 @@ paths:
         name: ending_before
         required: false
         type: string
-      - description: For automatic Stripe transfers only, only returns transactions
-          that were transferred out on the specified transfer ID.
+      - description: For automatic Stripe payouts only, only returns transactions
+          that were payed out on the specified payout ID.
         in: query
-        name: transfer
+        name: payout
         required: false
         type: string
       - description: ''
@@ -7301,8 +7586,8 @@ paths:
         required: false
         type: integer
       - description: 'Only returns transactions of the given type. One of: `charge`,
-          `refund`, `adjustment`, `application_fee`, `application_fee_refund`, `payment`,
-          `transfer`, or `transfer_failure`.'
+          `refund`, `adjustment`, `application_fee`, `application_fee_refund`, `transfer`,
+          `payment`, `payout`, or `payout_failure`.'
         in: query
         name: type
         required: false
@@ -7333,7 +7618,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -7507,7 +7793,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -7552,8 +7839,9 @@ paths:
               type:
               - integer
             currency:
-              description: The currency to which the bitcoin will be converted. You
-                will be paid out in this currency. Only USD is currently supported.
+              description: Three-letter [ISO code for the currency](https://support.stripe.com/questions/which-currencies-does-stripe-support)
+                to which the bitcoin will be converted. You will be paid out in this
+                currency. Only USD is currently supported.
               title: currency
               type:
               - string
@@ -7762,7 +8050,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -7845,7 +8134,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -7957,7 +8247,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -8176,10 +8467,10 @@ paths:
           schema:
             "$ref": "#/definitions/error"
     post:
-      description: |-
-        <p>Updates the specified charge by setting the values of the parameters passed. Any parameters not provided will be left unchanged.</p>
-        <p>This request accepts only the <code>description</code>, <code>metadata</code>, <code>receipt_email</code>, <code>fraud_details</code>, and <code>shipping</code> as arguments.</p>
+      description: "<p>Updates the specified charge by setting the values of the parameters
+        passed. Any parameters not provided will be left unchanged.</p><p>This request
+        accepts only the <code>description</code>, <code>metadata</code>, <code>receipt_email</code>,
+        <code>fraud_details</code>, and <code>shipping</code> as arguments.</p>"
       operationId: UpdateCharge
       parameters:
       - description: Body parameters for the request.
@@ -8209,9 +8500,11 @@ paths:
               type:
               - object
             metadata:
-              description: A set of key/value pairs that you can attach to a charge
-                object. It can be useful for storing additional information about
-                the charge in a structured format.
+              description: Set of key/value pairs that you can attach to an object.
+                It can be useful for storing additional information about the object
+                in a structured format. Individual keys can be unset by posting an
+                empty value to them. All keys can be unset by posting an empty value
+                to metadata.
               title: metadata
               type:
               - object
@@ -8247,10 +8540,12 @@ paths:
             "$ref": "#/definitions/error"
   "/v1/charges/{charge}/capture":
     post:
-      description: |-
-        <p>Capture the payment of an existing, uncaptured, charge. This is the second half of the two-step payment flow, where first you <a href="#create_charge">created a charge</a> with the capture option set to false.</p>
-        <p>Uncaptured payments expire exactly seven days after they are created. If they are not captured by that point in time, they will be marked as refunded and will no longer be capturable.</p>
+      description: <p>Capture the payment of an existing, uncaptured, charge. This
+        is the second half of the two-step payment flow, where first you <a href="#create_charge">created
+        a charge</a> with the capture option set to false.</p><p>Uncaptured payments
+        expire exactly seven days after they are created. If they are not captured
+        by that point in time, they will be marked as refunded and will no longer
+        be capturable.</p>
       operationId: ChargeCapture
       parameters:
       - description: ''
@@ -8501,7 +8796,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -8681,7 +8977,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -8780,7 +9077,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -8808,10 +9106,17 @@ paths:
           schema:
             "$ref": "#/definitions/error"
     post:
-      description: |-
-        <p>You can create coupons easily via the <a href="https://dashboard.stripe.com/coupons">coupon management</a> page of the Stripe dashboard. Coupon creation is also accessible via the API if you need to create coupons on the fly.</p>
-        <p>A coupon has either a <code>percent_off</code> or an <code>amount_off</code> and <code>currency</code>. If you set an <code>amount_off</code>, that amount will be subtracted from any invoice’s subtotal. For example, an invoice with a subtotal of <currency>100</currency> will have a final total of <currency>0</currency> if a coupon with an <code>amount_off</code> of <amount>200</amount> is applied to it and an invoice with a subtotal of <currency>300</currency> will have a final total of <currency>100</currency> if a coupon with an <code>amount_off</code> of <amount>200</amount> is applied to it.</p>
+      description: <p>You can create coupons easily via the <a href="https://dashboard.stripe.com/coupons">coupon
+        management</a> page of the Stripe dashboard. Coupon creation is also accessible
+        via the API if you need to create coupons on the fly.</p><p>A coupon has either
+        a <code>percent_off</code> or an <code>amount_off</code> and <code>currency</code>.
+        If you set an <code>amount_off</code>, that amount will be subtracted from
+        any invoice’s subtotal. For example, an invoice with a subtotal of <currency>100</currency>
+        will have a final total of <currency>0</currency> if a coupon with an <code>amount_off</code>
+        of <amount>200</amount> is applied to it and an invoice with a subtotal of
+        <currency>300</currency> will have a final total of <currency>100</currency>
+        if a coupon with an <code>amount_off</code> of <amount>200</amount> is applied
+        to it.</p>
       operationId: CreateCoupon
       parameters:
       - description: Body parameters for the request.
@@ -8827,8 +9132,8 @@ paths:
               type:
               - integer
             currency:
-              description: Currency of the `amount_off` parameter (required if `amount_off`
-                is passed).
+              description: Three-letter [ISO code for the currency](https://support.stripe.com/questions/which-currencies-does-stripe-support)
+                of the `amount_off` parameter (required if `amount_off` is passed).
               title: currency
               type:
               - string
@@ -8894,7 +9199,7 @@ paths:
             "$ref": "#/definitions/error"
   "/v1/coupons/{coupon}":
     delete:
-      description: <p>You can delete coupons via the <a href="http://dashboard:6090/coupons">coupon
+      description: <p>You can delete coupons via the <a href="https://dashboard.stripe.com/coupons">coupon
         management</a> page of the Stripe dashboard. However, deleting a coupon does
         not affect any customers who have already applied the coupon; it means that
         new customers can’t redeem the coupon. You can also delete coupons via the
@@ -9021,7 +9326,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -9328,7 +9634,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -9479,7 +9786,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -9758,7 +10066,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -10022,7 +10331,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -10297,7 +10607,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -10349,7 +10660,7 @@ paths:
                 invoice subtotal that will be transferred to the application owner's
                 Stripe account. The request must be made with an OAuth key in order
                 to set an application fee percentage. For more information, see the
-                application fees [documentation](http://127.0.0.1:6040/docs/connect/collecting-fees#subscriptions).
+                application fees [documentation]('https://stripe.com/docs/connect/subscriptions#collecting-fees-on-subscriptions).
               title: application_fee_percent
               type:
               - number
@@ -10423,15 +10734,15 @@ paths:
               - boolean
             source:
               description: The source can either be a token, like the ones returned
-                by [Elements](http://127.0.0.1:6040/docs/elements), or a dictionary
-                containing a user's credit card details (with the options shown below).
-                You must provide a source if the customer does not already have a
-                valid source attached, and you are subscribing the customer for a
-                plan that is not free. Passing `source` will create a new source object,
-                make it the customer default source, and delete the old customer default
-                if one exists. If you want to add an additional source to use with
-                subscriptions, instead use the [card creation API](http://127.0.0.1:6040/docs/api#create_card)
-                to add the card and then the [customer update API](http://127.0.0.1:6040/docs/api#update
+                by [Elements](https://stripe.com/docs/elements), or a dictionary containing
+                a user's credit card details (with the options shown below). You must
+                provide a source if the customer does not already have a valid source
+                attached, and you are subscribing the customer for a plan that is
+                not free. Passing `source` will create a new source object, make it
+                the customer default source, and delete the old customer default if
+                one exists. If you want to add an additional source to use with subscriptions,
+                instead use the [card creation API](https://stripe.com/docs/api#create_card)
+                to add the card and then the [customer update API](https://stripe.com/docs/api#update
                 customer) to set it as the default. Whenever you attach a card to
                 a customer, Stripe will automatically validate the card.
               title: source
@@ -10476,10 +10787,22 @@ paths:
             "$ref": "#/definitions/error"
   "/v1/customers/{customer}/subscriptions/{subscription_exposed_id}":
     delete:
-      description: |-
-        <p>Cancels a customer’s subscription. If you set the <code>at_period_end</code> parameter to true, the subscription will remain active until the end of the period, at which point it will be canceled and not renewed. By default, the subscription is terminated immediately. In either case, the customer will not be charged again for the subscription. Note, however, that any pending invoice items that you’ve created will still be charged for at the end of the period unless manually <a href="#delete_invoiceitem">deleted</a>. If you’ve set the subscription to cancel at period end, any pending prorations will also be left in place and collected at the end of the period, but if the subscription is set to cancel immediately, pending prorations will be removed.</p>
-        <p>By default, all unpaid invoices for the customer will be closed upon subscription cancellation. We do this in order to prevent unexpected payment retries once the customer has canceled a subscription. However, you can reopen the invoices manually after subscription cancellation to have us proceed with automatic retries, or you could even re-attempt payment yourself on all unpaid invoices before allowing the customer to cancel the subscription at all.</p>
+      description: <p>Cancels a customer’s subscription. If you set the <code>at_period_end</code>
+        parameter to true, the subscription will remain active until the end of the
+        period, at which point it will be canceled and not renewed. By default, the
+        subscription is terminated immediately. In either case, the customer will
+        not be charged again for the subscription. Note, however, that any pending
+        invoice items that you’ve created will still be charged for at the end of
+        the period unless manually <a href="#delete_invoiceitem">deleted</a>. If you’ve
+        set the subscription to cancel at period end, any pending prorations will
+        also be left in place and collected at the end of the period, but if the subscription
+        is set to cancel immediately, pending prorations will be removed.</p><p>By
+        default, all unpaid invoices for the customer will be closed upon subscription
+        cancellation. We do this in order to prevent unexpected payment retries once
+        the customer has canceled a subscription. However, you can reopen the invoices
+        manually after subscription cancellation to have us proceed with automatic
+        retries, or you could even re-attempt payment yourself on all unpaid invoices
+        before allowing the customer to cancel the subscription at all.</p>
       operationId: DeleteCustomerSubscription
       parameters:
       - description: Body parameters for the request.
@@ -10541,7 +10864,7 @@ paths:
                 invoice subtotal that will be transferred to the application owner's
                 Stripe account. The request must be made with an OAuth key in order
                 to set an application fee percentage. For more information, see the
-                application fees [documentation](http://127.0.0.1:6040/docs/connect/collecting-fees#subscriptions).
+                application fees [documentation](https://stripe.com/docs/connect/subscriptions#collecting-fees-on-subscriptions')}).
               title: application_fee_percent
               type:
               - number
@@ -10632,15 +10955,15 @@ paths:
               - boolean
             source:
               description: The source can either be a token, like the ones returned
-                by [Elements](http://127.0.0.1:6040/docs/elements), or a dictionary
-                containing a user's credit card details (with the options shown below).
-                You must provide a source if the customer does not already have a
-                valid source attached, and you are subscribing the customer for a
-                plan that is not free. Passing `source` will create a new source object,
-                make it the customer default source, and delete the old customer default
-                if one exists. If you want to add an additional source to use with
-                subscriptions, instead use the [card creation API](http://127.0.0.1:6040/docs/api#create_card)
-                to add the card and then the [customer update API](http://127.0.0.1:6040/docs/api#update
+                by [Elements](https://stripe.com/docs/elements), or a dictionary containing
+                a user's credit card details (with the options shown below). You must
+                provide a source if the customer does not already have a valid source
+                attached, and you are subscribing the customer for a plan that is
+                not free. Passing `source` will create a new source object, make it
+                the customer default source, and delete the old customer default if
+                one exists. If you want to add an additional source to use with subscriptions,
+                instead use the [card creation API](https://stripe.com/docs/api#create_card)
+                to add the card and then the [customer update API](https://stripe.com/docs/api#update
                 customer) to set it as the default. Whenever you attach a card to
                 a customer, Stripe will automatically validate the card.
               title: source
@@ -10757,7 +11080,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -10804,10 +11128,13 @@ paths:
           schema:
             "$ref": "#/definitions/error"
     post:
-      description: |-
-        <p>When you get a dispute, contacting your customer is always the best first step. If that doesn’t work, you can submit evidence in order to help us resolve the dispute in your favor. You can do this in your <a href="http://dashboard:6090/disputes">dashboard</a>, but if you prefer, you can use the API to submit evidence programmatically.</p>
-        <p>Depending on your dispute type, different evidence fields will give you a better chance of winning your dispute. You may want to consult our <a href="http://127.0.0.1:6040/help/dispute-types">guide to dispute types</a> to help you figure out which evidence fields to provide.</p>
+      description: <p>When you get a dispute, contacting your customer is always the
+        best first step. If that doesn’t work, you can submit evidence in order to
+        help us resolve the dispute in your favor. You can do this in your <a href="https://dashboard.stripe.com/disputes">dashboard</a>,
+        but if you prefer, you can use the API to submit evidence programmatically.</p><p>Depending
+        on your dispute type, different evidence fields will give you a better chance
+        of winning your dispute. You may want to consult our <a href="https://stripe.com/help/dispute-types">guide
+        to dispute types</a> to help you figure out which evidence fields to provide.</p>
       operationId: UpdateDispute
       parameters:
       - description: ID of the dispute to update.
@@ -10845,10 +11172,11 @@ paths:
             "$ref": "#/definitions/error"
   "/v1/disputes/{dispute}/close":
     post:
-      description: |-
-        <p>Closing the dispute for a charge indicates that you do not have any evidence to submit and are essentially ‘dismissing’ the dispute, acknowledging it as lost</p>
-        <p>The status of the dispute will change from <code>needs_response</code> to <code>lost</code>. <strong>Closing a dispute is irreversible</strong>.</p>
+      description: "<p>Closing the dispute for a charge indicates that you do not
+        have any evidence to submit and are essentially ‘dismissing’ the dispute,
+        acknowledging it as lost</p><p>The status of the dispute will change from
+        <code>needs_response</code> to <code>lost</code>. <strong>Closing a dispute
+        is irreversible</strong>.</p>"
       operationId: CloseDispute
       parameters:
       - description: ID of dispute to close.
@@ -10929,7 +11257,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -11053,7 +11382,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -11099,7 +11429,8 @@ paths:
               type:
               - integer
             currency:
-              description: 3-letter [ISO code for currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
+              description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+                in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
               title: currency
               type:
               - string
@@ -11309,7 +11640,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -11337,10 +11669,12 @@ paths:
           schema:
             "$ref": "#/definitions/error"
     post:
-      description: |-
-        <p>If you need to invoice your customer outside the regular billing cycle, you can create an invoice that pulls in all pending invoice items, including prorations. The customer’s billing cycle and regular subscription won’t be affected.</p>
-        <p>Once you create the invoice, it’ll be picked up and paid automatically, though you can choose to <a href="#pay_invoice">pay it right</a> away.</p>
+      description: <p>If you need to invoice your customer outside the regular billing
+        cycle, you can create an invoice that pulls in all pending invoice items,
+        including prorations. The customer’s billing cycle and regular subscription
+        won’t be affected.</p><p>Once you create the invoice, it’ll be picked up and
+        paid automatically, though you can choose to <a href="#pay_invoice">pay it
+        right</a> away.</p>
       operationId: CreateInvoice
       parameters:
       - description: Body parameters for the request.
@@ -11353,7 +11687,7 @@ paths:
               description: A fee in %s that will be applied to the invoice and transferred
                 to the application owner's Stripe account. The request must be made
                 with an OAuth key or the Stripe-Account header in order to take an
-                application fee. For more information, see the application fees [documentation](/docs/connect/collecting-fees#subscriptions).
+                application fee. For more information, see the application fees [documentation](/docs/connect/subscriptions#working-with-invoices).
               title: application_fee
               type:
               - integer
@@ -11424,12 +11758,24 @@ paths:
             "$ref": "#/definitions/error"
   "/v1/invoices/upcoming":
     get:
-      description: |-
-        <p>At any time, you can preview the upcoming invoice for a customer. This will show you all the charges that are pending, including subscription renewal charges, invoice item charges, etc. It will also show you any discount that is applicable to the customer.</p>
-        <p>Note that when you are viewing an upcoming invoice, you are simply viewing a preview – the invoice has not yet been created. As such, the upcoming invoice will not show up in invoice listing calls, and you cannot use the API to pay or edit the invoice. If you want to change the amount that your customer will be billed, you can add, remove, or update pending invoice items, or update the customer’s discount.</p>
-        <p>You can preview the effects of updating a subscription, including a preview of what proration will take place. To ensure that the actual proration is calculated exactly the same as the previewed proration, you should pass a <code>proration_date</code> parameter when doing the actual subscription update. The value passed in should be the same as the <code>subscription_proration_date</code> returned on the upcoming invoice resource. The recommended way to get only the prorations being previewed is to consider only proration line items where <code>period[start]</code> is equal to the <code>subscription_proration_date</code> on the upcoming invoice resource.</p>
+      description: "<p>At any time, you can preview the upcoming invoice for a customer.
+        This will show you all the charges that are pending, including subscription
+        renewal charges, invoice item charges, etc. It will also show you any discount
+        that is applicable to the customer.</p><p>Note that when you are viewing an
+        upcoming invoice, you are simply viewing a preview – the invoice has not yet
+        been created. As such, the upcoming invoice will not show up in invoice listing
+        calls, and you cannot use the API to pay or edit the invoice. If you want
+        to change the amount that your customer will be billed, you can add, remove,
+        or update pending invoice items, or update the customer’s discount.</p><p>You
+        can preview the effects of updating a subscription, including a preview of
+        what proration will take place. To ensure that the actual proration is calculated
+        exactly the same as the previewed proration, you should pass a <code>proration_date</code>
+        parameter when doing the actual subscription update. The value passed in should
+        be the same as the <code>subscription_proration_date</code> returned on the
+        upcoming invoice resource. The recommended way to get only the prorations
+        being previewed is to consider only proration line items where <code>period[start]</code>
+        is equal to the <code>subscription_proration_date</code> on the upcoming invoice
+        resource.</p>"
       operationId: RetrieveCustomerUpcomingInvoice
       parameters:
       - description: The identifier of the customer whose upcoming invoice you'd like
@@ -11552,7 +11898,7 @@ paths:
               description: A fee in %s that will be applied to the invoice and transferred
                 to the application owner's Stripe account. The request must be made
                 with an OAuth key or the Stripe-Account header in order to take an
-                application fee. For more information, see the application fees [documentation](/docs/connect/collecting-fees#subscriptions).
+                application fee. For more information, see the application fees [documentation](/docs/connect/subscriptions#working-with-invoices).
               title: application_fee
               type:
               - integer
@@ -11734,7 +12080,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -11764,7 +12111,7 @@ paths:
     post:
       description: <p>Stripe automatically creates and then attempts to pay invoices
         for customers on subscriptions. We’ll also retry unpaid invoices according
-        to your <a href="http://dashboard:6090/account/recurring">retry settings</a>.
+        to your <a href="https://dashboard.stripe.com/account/recurring">retry settings</a>.
         However, if you’d like to attempt to collect payment on an invoice out of
         the normal retry schedule or for some other reason, you can do so.</p>
       operationId: PayInvoice
@@ -11839,7 +12186,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -11965,7 +12313,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -12010,10 +12359,8 @@ paths:
               type:
               - string
             currency:
-              description: 3-letter [ISO code](https://support.stripe.com/questions/which-currencies-does-stripe-support)
-                representing the currency in which the order should be made. Stripe
-                will validate that all entries in `items` match the currency specified
-                here.
+              description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+                in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
               title: currency
               type:
               - string
@@ -12297,7 +12644,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -12343,6 +12691,258 @@ paths:
           description: Error response.
           schema:
             "$ref": "#/definitions/error"
+  "/v1/payouts":
+    get:
+      description: "<p>Returns a list of existing payouts sent to third-party bank
+        accounts or that Stripe has sent you. The payouts are returned in sorted order,
+        with the most recently created payouts appearing first.</p>"
+      operationId: PayoutAll
+      parameters:
+      - description: A limit on the number of objects to be returned. Limit can range
+          between 1 and 100 items.
+        in: query
+        name: limit
+        required: false
+        type: integer
+      - description: A cursor for use in pagination. `starting_after` is an object
+          ID that defines your place in the list. For instance, if you make a list
+          request and receive 100 objects, ending with `obj_foo`, your subsequent
+          call can include `starting_after=obj_foo` in order to fetch the next page
+          of the list.
+        in: query
+        name: starting_after
+        required: false
+        type: string
+      - description: A cursor for use in pagination. `ending_before` is an object
+          ID that defines your place in the list. For instance, if you make a list
+          request and receive 100 objects, starting with `obj_bar`, your subsequent
+          call can include `ending_before=obj_bar` in order to fetch the previous
+          page of the list.
+        in: query
+        name: ending_before
+        required: false
+        type: string
+      - description: ''
+        in: query
+        name: arrival_date
+        required: false
+        type: integer
+      - description: ''
+        in: query
+        name: created
+        required: false
+        type: integer
+      - description: The ID of an external account - only return payouts sent to this
+          external account.
+        in: query
+        name: destination
+        required: false
+        type: string
+      - description: 'Only return payouts that have the given status: `pending`, `paid`,
+          `failed`, `in_transit`, or `canceled`.'
+        in: query
+        name: status
+        required: false
+        type: string
+      responses:
+        '200':
+          description: Successful response.
+          schema:
+            properties:
+              data:
+                items:
+                  "$ref": "#/definitions/payout"
+                type:
+                - array
+              has_more:
+                description: True if this list has another page of items after this
+                  one that can be fetched.
+                type:
+                - boolean
+              object:
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
+                enum:
+                - list
+                type:
+                - string
+              total_count:
+                description: The total number of items available. This value is not
+                  included by default, but you can request it by specifying ?include[]=total_count.
+                type:
+                - integer
+              url:
+                description: The URL where this list can be accessed.
+                enum:
+                - "/v1/payouts"
+                type:
+                - string
+            required:
+            - data
+            - has_more
+            - object
+            - url
+            title: PayoutList
+            type:
+            - object
+        default:
+          description: Error response.
+          schema:
+            "$ref": "#/definitions/error"
+    post:
+      description: <p>To send funds to your own bank account, you create a new payout
+        object. Your <a href="#balance">Stripe balance</a> must be able to cover the
+        payout amount, or you’ll receive an “Insufficient Funds” error.</p><p>If your
+        API key is in test mode, money won’t actually be sent, though everything else
+        will occur as if in live mode.</p><p>If you are creating a manual payout on
+        a Stripe account that uses multiple payment source types, you’ll need to specify
+        the source type balance that the payout should draw from. The <a href="#balance_object">balance
+        object</a> details available and pending amounts by source type.</p>
+      operationId: PayoutCreate
+      parameters:
+      - description: Body parameters for the request.
+        in: body
+        name: payload
+        required: true
+        schema:
+          properties:
+            amount:
+              description: A positive integer in cents representing how much to payout.
+              title: amount
+              type:
+              - integer
+            currency:
+              description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+                in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
+              title: currency
+              type:
+              - string
+            destination:
+              description: The id of a bank account or a card to send the payout to.
+                If no destination is supplied, the default external account for the
+                specified currency will be used.
+              title: destination
+              type:
+              - string
+            metadata:
+              description: A set of key/value pairs that you can attach to a payout
+                object. It can be useful for storing additional information about
+                the payout in a structured format.
+              title: metadata
+              type:
+              - object
+            method:
+              description: The method used to send this payout, which can be `standard`
+                or `instant`. `instant` is only supported for payouts to debit cards.
+                (See [Instant payouts for marketplaces for more information](https://stripe.com/blog/instant-payouts-for-marketplaces).)
+              title: method
+              type:
+              - string
+            source_type:
+              description: 'The source balance to draw this payout from. Balances
+                for different payment sources are kept separately. You can find the
+                amounts with the balances API. Valid options are: `alipay_account`,
+                `bank_account`, `bitcoin_receiver`, and `card`.'
+              title: source_type
+              type:
+              - string
+            statement_descriptor:
+              description: 'A string to be displayed on the recipient''s bank or card
+                statement. This may be at most 22 characters. Attempting to use a
+                `statement_descriptor` longer than 22 characters will return an error.
+                Note: Most banks will truncate this information and/or display it
+                inconsistently. Some may not display it at all.'
+              title: statement_descriptor
+              type:
+              - string
+          required:
+          - amount
+          - currency
+      responses:
+        '200':
+          description: Successful response.
+          schema:
+            "$ref": "#/definitions/payout"
+        default:
+          description: Error response.
+          schema:
+            "$ref": "#/definitions/error"
+  "/v1/payouts/{id}":
+    get:
+      description: "<p>Retrieves the details of an existing payout. Supply the unique
+        payout ID from either a payout creation request or the payout list, and Stripe
+        will return the corresponding payout information.</p>"
+      operationId: PayoutRetrieve
+      parameters:
+      - description: The identifier of the payout to be retrieved.
+        in: path
+        name: id
+        required: true
+        type: string
+      responses:
+        '200':
+          description: Successful response.
+          schema:
+            "$ref": "#/definitions/payout"
+        default:
+          description: Error response.
+          schema:
+            "$ref": "#/definitions/error"
+    post:
+      description: "<p>Updates the specified payout by setting the values of the parameters
+        passed. Any parameters not provided will be left unchanged. This request accepts
+        only the metadata as arguments.</p>"
+      operationId: PayoutUpdate
+      parameters:
+      - description: The identifier of the payout to be updated.
+        in: path
+        name: id
+        required: true
+        type: string
+      - description: Body parameters for the request.
+        in: body
+        name: payload
+        required: false
+        schema:
+          properties:
+            metadata:
+              description: A set of key/value pairs that you can attach to a payout
+                object. It can be useful for storing additional information about
+                the payout in a structured format.
+              title: metadata
+              type:
+              - object
+      responses:
+        '200':
+          description: Successful response.
+          schema:
+            "$ref": "#/definitions/payout"
+        default:
+          description: Error response.
+          schema:
+            "$ref": "#/definitions/error"
+  "/v1/payouts/{id}/cancel":
+    post:
+      description: "<p>A previously created payout can be canceled if it has not yet
+        been paid out. Funds will be refunded to your available balance, and the fees
+        you were originally charged on the payout will be refunded. You may not cancel
+        automatic Stripe payouts.</p>"
+      operationId: PayoutCancel
+      parameters:
+      - description: The identifier of the payout to be canceled.
+        in: path
+        name: id
+        required: true
+        type: string
+      responses:
+        '200':
+          description: Successful response.
+          schema:
+            "$ref": "#/definitions/payout"
+        default:
+          description: Error response.
+          schema:
+            "$ref": "#/definitions/error"
   "/v1/plans":
     get:
       description: "<p>Returns a list of your plans.</p>"
@@ -12395,7 +12995,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -12441,7 +13042,8 @@ paths:
               type:
               - integer
             currency:
-              description: 3-letter [ISO code for currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
+              description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+                in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
               title: currency
               type:
               - string
@@ -12517,7 +13119,7 @@ paths:
             "$ref": "#/definitions/error"
   "/v1/plans/{plan}":
     delete:
-      description: <p>You can delete plans via the <a href="http://dashboard:6090/plans">plan
+      description: <p>You can delete plans via the <a href="https://dashboard.stripe.com/plans">plan
         management</a> page of the Stripe dashboard. However, deleting a plan does
         not affect any current subscribers to the plan; it merely means that new subscribers
         can’t be added to that plan. You can also delete plans via the API.</p>
@@ -12683,7 +13285,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -12844,10 +13447,11 @@ paths:
           schema:
             "$ref": "#/definitions/error"
     post:
-      description: |-
-        <p>Updates the specific product by setting the values of the parameters passed. Any parameters not provided will be left unchanged.</p>
-        <p>Note that a product’s <code>attributes</code> are not editable. Instead, you would need to deactivate the existing product and create a new one with the new attribute values.</p>
+      description: "<p>Updates the specific product by setting the values of the parameters
+        passed. Any parameters not provided will be left unchanged.</p><p>Note that
+        a product’s <code>attributes</code> are not editable. Instead, you would need
+        to deactivate the existing product and create a new one with the new attribute
+        values.</p>"
       operationId: UpdateProduct
       parameters:
       - description: Body parameters for the request.
@@ -12998,7 +13602,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -13338,7 +13943,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -13559,7 +14165,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -13662,10 +14269,9 @@ paths:
           schema:
             "$ref": "#/definitions/error"
     post:
-      description: |-
-        <p>Updates the specified refund by setting the values of the parameters passed. Any parameters not provided will be left unchanged.</p>
-        <p>This request only accepts <code>metadata</code> as an argument.</p>
+      description: "<p>Updates the specified refund by setting the values of the parameters
+        passed. Any parameters not provided will be left unchanged.</p><p>This request
+        only accepts <code>metadata</code> as an argument.</p>"
       operationId: UpdateRefund
       parameters:
       - description: Body parameters for the request.
@@ -13768,7 +14374,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -13820,8 +14427,8 @@ paths:
               type:
               - object
             currency:
-              description: 3-letter [ISO code](https://support.stripe.com/questions/which-currencies-does-stripe-support)
-                for currency.
+              description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+                in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
               title: currency
               type:
               - string
@@ -13926,10 +14533,11 @@ paths:
           schema:
             "$ref": "#/definitions/error"
     post:
-      description: |-
-        <p>Updates the specific SKU by setting the values of the parameters passed. Any parameters not provided will be left unchanged.</p>
-        <p>Note that a SKU’s <code>attributes</code> are not editable. Instead, you would need to deactivate the existing SKU and create a new one with the new attribute values.</p>
+      description: "<p>Updates the specific SKU by setting the values of the parameters
+        passed. Any parameters not provided will be left unchanged.</p><p>Note that
+        a SKU’s <code>attributes</code> are not editable. Instead, you would need
+        to deactivate the existing SKU and create a new one with the new attribute
+        values.</p>"
       operationId: UpdateSKU
       parameters:
       - description: Body parameters for the request.
@@ -13954,8 +14562,8 @@ paths:
               type:
               - object
             currency:
-              description: 3-letter [ISO code](https://support.stripe.com/questions/which-currencies-does-stripe-support)
-                for currency.
+              description: Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html),
+                in lowercase. Must be a [supported currency](https://support.stripe.com/questions/which-currencies-does-stripe-support).
               title: currency
               type:
               - string
@@ -14021,11 +14629,6 @@ paths:
         required: false
         schema:
           properties:
-            alipay:
-              description: ''
-              title: alipay
-              type:
-              - object
             amount:
               description: Amount associated with the source. This is the amount for
                 which the source will be chargeable once ready. Required for `single-use`
@@ -14034,8 +14637,9 @@ paths:
               type:
               - integer
             currency:
-              description: The currency associated with the source. This is the currency
-                for which the source will be chargeable once ready.
+              description: Three-letter [ISO code for the currency](https://support.stripe.com/questions/which-currencies-does-stripe-support)
+                associated with the source. This is the currency for which the source
+                will be chargeable once ready.
               title: currency
               type:
               - string
@@ -14123,10 +14727,9 @@ paths:
           schema:
             "$ref": "#/definitions/error"
     post:
-      description: |-
-        <p>Updates the specified source by setting the values of the parameters passed. Any parameters not provided will be left unchanged.</p>
-        <p>This request accepts only the <code>metadata</code> and <code>owner</code> as arguments.</p>
+      description: "<p>Updates the specified source by setting the values of the parameters
+        passed. Any parameters not provided will be left unchanged.</p><p>This request
+        accepts only the <code>metadata</code> and <code>owner</code> as arguments.</p>"
       operationId: SourceUpdate
       parameters:
       - description: Body parameters for the request.
@@ -14239,7 +14842,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -14496,7 +15100,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -14544,7 +15149,7 @@ paths:
                 invoice subtotal that will be transferred to the application owner's
                 Stripe account. The request must be made with an OAuth key in order
                 to set an application fee percentage. For more information, see the
-                application fees [documentation](http://127.0.0.1:6040/docs/connect/collecting-fees#subscriptions).
+                application fees [documentation]('https://stripe.com/docs/connect/subscriptions#collecting-fees-on-subscriptions).
               title: application_fee_percent
               type:
               - number
@@ -14623,15 +15228,15 @@ paths:
               - boolean
             source:
               description: The source can either be a token, like the ones returned
-                by [Elements](http://127.0.0.1:6040/docs/elements), or a dictionary
-                containing a user's credit card details (with the options shown below).
-                You must provide a source if the customer does not already have a
-                valid source attached, and you are subscribing the customer for a
-                plan that is not free. Passing `source` will create a new source object,
-                make it the customer default source, and delete the old customer default
-                if one exists. If you want to add an additional source to use with
-                subscriptions, instead use the [card creation API](http://127.0.0.1:6040/docs/api#create_card)
-                to add the card and then the [customer update API](http://127.0.0.1:6040/docs/api#update
+                by [Elements](https://stripe.com/docs/elements), or a dictionary containing
+                a user's credit card details (with the options shown below). You must
+                provide a source if the customer does not already have a valid source
+                attached, and you are subscribing the customer for a plan that is
+                not free. Passing `source` will create a new source object, make it
+                the customer default source, and delete the old customer default if
+                one exists. If you want to add an additional source to use with subscriptions,
+                instead use the [card creation API](https://stripe.com/docs/api#create_card)
+                to add the card and then the [customer update API](https://stripe.com/docs/api#update
                 customer) to set it as the default. Whenever you attach a card to
                 a customer, Stripe will automatically validate the card.
               title: source
@@ -14678,10 +15283,22 @@ paths:
             "$ref": "#/definitions/error"
   "/v1/subscriptions/{subscription_exposed_id}":
     delete:
-      description: |-
-        <p>Cancels a customer’s subscription. If you set the <code>at_period_end</code> parameter to true, the subscription will remain active until the end of the period, at which point it will be canceled and not renewed. By default, the subscription is terminated immediately. In either case, the customer will not be charged again for the subscription. Note, however, that any pending invoice items that you’ve created will still be charged for at the end of the period unless manually <a href="#delete_invoiceitem">deleted</a>. If you’ve set the subscription to cancel at period end, any pending prorations will also be left in place and collected at the end of the period, but if the subscription is set to cancel immediately, pending prorations will be removed.</p>
-        <p>By default, all unpaid invoices for the customer will be closed upon subscription cancellation. We do this in order to prevent unexpected payment retries once the customer has canceled a subscription. However, you can reopen the invoices manually after subscription cancellation to have us proceed with automatic retries, or you could even re-attempt payment yourself on all unpaid invoices before allowing the customer to cancel the subscription at all.</p>
+      description: <p>Cancels a customer’s subscription. If you set the <code>at_period_end</code>
+        parameter to true, the subscription will remain active until the end of the
+        period, at which point it will be canceled and not renewed. By default, the
+        subscription is terminated immediately. In either case, the customer will
+        not be charged again for the subscription. Note, however, that any pending
+        invoice items that you’ve created will still be charged for at the end of
+        the period unless manually <a href="#delete_invoiceitem">deleted</a>. If you’ve
+        set the subscription to cancel at period end, any pending prorations will
+        also be left in place and collected at the end of the period, but if the subscription
+        is set to cancel immediately, pending prorations will be removed.</p><p>By
+        default, all unpaid invoices for the customer will be closed upon subscription
+        cancellation. We do this in order to prevent unexpected payment retries once
+        the customer has canceled a subscription. However, you can reopen the invoices
+        manually after subscription cancellation to have us proceed with automatic
+        retries, or you could even re-attempt payment yourself on all unpaid invoices
+        before allowing the customer to cancel the subscription at all.</p>
       operationId: DeleteCustomerSubscription
       parameters:
       - description: Body parameters for the request.
@@ -14743,7 +15360,7 @@ paths:
                 invoice subtotal that will be transferred to the application owner's
                 Stripe account. The request must be made with an OAuth key in order
                 to set an application fee percentage. For more information, see the
-                application fees [documentation](http://127.0.0.1:6040/docs/connect/collecting-fees#subscriptions).
+                application fees [documentation](https://stripe.com/docs/connect/subscriptions#collecting-fees-on-subscriptions')}).
               title: application_fee_percent
               type:
               - number
@@ -14834,15 +15451,15 @@ paths:
               - boolean
             source:
               description: The source can either be a token, like the ones returned
-                by [Elements](http://127.0.0.1:6040/docs/elements), or a dictionary
-                containing a user's credit card details (with the options shown below).
-                You must provide a source if the customer does not already have a
-                valid source attached, and you are subscribing the customer for a
-                plan that is not free. Passing `source` will create a new source object,
-                make it the customer default source, and delete the old customer default
-                if one exists. If you want to add an additional source to use with
-                subscriptions, instead use the [card creation API](http://127.0.0.1:6040/docs/api#create_card)
-                to add the card and then the [customer update API](http://127.0.0.1:6040/docs/api#update
+                by [Elements](https://stripe.com/docs/elements), or a dictionary containing
+                a user's credit card details (with the options shown below). You must
+                provide a source if the customer does not already have a valid source
+                attached, and you are subscribing the customer for a plan that is
+                not free. Passing `source` will create a new source object, make it
+                the customer default source, and delete the old customer default if
+                one exists. If you want to add an additional source to use with subscriptions,
+                instead use the [card creation API](https://stripe.com/docs/api#create_card)
+                to add the card and then the [customer update API](https://stripe.com/docs/api#update
                 customer) to set it as the default. Whenever you attach a card to
                 a customer, Stripe will automatically validate the card.
               title: source
@@ -14948,7 +15565,9 @@ paths:
             "$ref": "#/definitions/error"
   "/v1/transfers":
     get:
-      description: ''
+      description: "<p>Returns a list of existing transfers sent to connected accounts.
+        The transfers are returned in sorted order, with the most recently created
+        transfers appearing first.</p>"
       operationId: AllTransfers
       parameters:
       - description: A limit on the number of objects to be returned. Limit can range
@@ -14975,31 +15594,22 @@ paths:
         name: ending_before
         required: false
         type: string
-      - description: ''
-        in: query
-        name: amount
-        required: false
-        type: integer
       - description: ''
         in: query
         name: created
         required: false
         type: integer
-      - description: ''
+      - description: Only return transfers for the destination specified by this account
+          ID.
         in: query
         name: destination
         required: false
         type: string
-      - description: ''
+      - description: Only return transfers with the specified transfer group.
         in: query
         name: transfer_group
         required: false
         type: string
-      - description: ''
-        in: query
-        name: currency
-        required: false
-        type: string
       responses:
         '200':
           description: Successful response.
@@ -15016,7 +15626,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -15079,6 +15690,11 @@ paths:
               title: source_transaction
               type:
               - string
+            source_type:
+              description: ''
+              title: source_type
+              type:
+              - string
             transfer_group:
               description: ''
               title: transfer_group
@@ -15098,10 +15714,12 @@ paths:
             "$ref": "#/definitions/error"
   "/v1/transfers/{id}":
     get:
-      description: ''
+      description: "<p>Retrieves the details of an existing transfer. Supply the unique
+        transfer ID from either a transfer creation request or the transfer list,
+        and Stripe will return the corresponding transfer information.</p>"
       operationId: RetrieveTransfer
       parameters:
-      - description: ''
+      - description: The identifier of the transfer to be retrieved.
         in: path
         name: id
         required: true
@@ -15217,7 +15835,8 @@ paths:
                 type:
                 - boolean
               object:
-                description: The type of object. Always has the value "list".
+                description: String representing the object's type. Objects of the
+                  same type share the same value. Always has the value "list".
                 enum:
                 - list
                 type:
@@ -15314,10 +15933,9 @@ paths:
           schema:
             "$ref": "#/definitions/error"
     post:
-      description: |-
-        <p>Updates the specified reversal by setting the values of the parameters passed. Any parameters not provided will be left unchanged.</p>
-        <p>This request only accepts metadata and description as arguments.</p>
+      description: "<p>Updates the specified reversal by setting the values of the
+        parameters passed. Any parameters not provided will be left unchanged.</p><p>This
+        request only accepts metadata and description as arguments.</p>"
       operationId: UpdateTransferReversal
       parameters:
       - description: ''