stripe 17.0.1 → 19.0.0

data/lib/stripe/resources/tax/settings.rb

@@ -5,7 +5,7 @@ module Stripe
   module Tax
     # You can use Tax `Settings` to manage configurations used by Stripe Tax calculations.
     #
-    # Related guide: [Using the Settings API](https://stripe.com/docs/tax/settings-api)
+    # Related guide: [Using the Settings API](https://docs.stripe.com/tax/settings-api)
     class Settings < SingletonAPIResource
       include Stripe::APIOperations::SingletonSave
 
@@ -14,7 +14,7 @@ module Stripe
         "tax.settings"
       end
 
-      class Defaults < Stripe::StripeObject
+      class Defaults < ::Stripe::StripeObject
         # The tax calculation provider this account uses. Defaults to `stripe` when not using a [third-party provider](/tax/third-party-apps).
         attr_reader :provider
         # Default [tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#tax-behavior) used to specify whether the price is considered inclusive of taxes or exclusive of taxes. If the item's price has a tax behavior set, it will take precedence over the default tax behavior.
@@ -31,8 +31,8 @@ module Stripe
         end
       end
 
-      class HeadOffice < Stripe::StripeObject
-        class Address < Stripe::StripeObject
+      class HeadOffice < ::Stripe::StripeObject
+        class Address < ::Stripe::StripeObject
           # City, district, suburb, town, or village.
           attr_reader :city
           # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -43,7 +43,7 @@ module Stripe
           attr_reader :line2
           # ZIP or postal code.
           attr_reader :postal_code
-          # State, county, province, or region.
+          # State, county, province, or region ([ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2)).
           attr_reader :state
 
           def self.inner_class_types
@@ -66,8 +66,8 @@ module Stripe
         end
       end
 
-      class StatusDetails < Stripe::StripeObject
-        class Active < Stripe::StripeObject
+      class StatusDetails < ::Stripe::StripeObject
+        class Active < ::Stripe::StripeObject
           def self.inner_class_types
             @inner_class_types = {}
           end
@@ -77,7 +77,7 @@ module Stripe
           end
         end
 
-        class Pending < Stripe::StripeObject
+        class Pending < ::Stripe::StripeObject
           # The list of missing fields that are required to perform calculations. It includes the entry `head_office` when the status is `pending`. It is recommended to set the optional values even if they aren't listed as required for calculating taxes. Calculations can fail if missing fields aren't explicitly provided on every call.
           attr_reader :missing_fields
 
@@ -106,7 +106,7 @@ module Stripe
       attr_reader :defaults
       # The place where your business is located.
       attr_reader :head_office
-      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+      # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
       attr_reader :livemode
       # String representing the object's type. Objects of the same type share the same value.
       attr_reader :object

data/lib/stripe/resources/tax/transaction.rb

@@ -5,15 +5,15 @@ module Stripe
   module Tax
     # A Tax Transaction records the tax collected from or refunded to your customer.
     #
-    # Related guide: [Calculate tax in your custom payment flow](https://stripe.com/docs/tax/custom#tax-transaction)
+    # Related guide: [Calculate tax in your custom payment flow](https://docs.stripe.com/tax/custom#tax-transaction)
     class Transaction < APIResource
       OBJECT_NAME = "tax.transaction"
       def self.object_name
         "tax.transaction"
       end
 
-      class CustomerDetails < Stripe::StripeObject
-        class Address < Stripe::StripeObject
+      class CustomerDetails < ::Stripe::StripeObject
+        class Address < ::Stripe::StripeObject
           # City, district, suburb, town, or village.
           attr_reader :city
           # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -36,8 +36,8 @@ module Stripe
           end
         end
 
-        class TaxId < Stripe::StripeObject
-          # The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, `aw_tin`, `az_tin`, `bd_bin`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, or `unknown`
+        class TaxId < ::Stripe::StripeObject
+          # The type of the tax ID, one of `ad_nrt`, `ar_cuit`, `eu_vat`, `bo_tin`, `br_cnpj`, `br_cpf`, `cn_tin`, `co_nit`, `cr_tin`, `do_rcn`, `ec_ruc`, `eu_oss_vat`, `hr_oib`, `pe_ruc`, `ro_tin`, `rs_pib`, `sv_nit`, `uy_ruc`, `ve_rif`, `vn_tin`, `gb_vat`, `nz_gst`, `au_abn`, `au_arn`, `in_gst`, `no_vat`, `no_voec`, `za_vat`, `ch_vat`, `mx_rfc`, `sg_uen`, `ru_inn`, `ru_kpp`, `ca_bn`, `hk_br`, `es_cif`, `pl_nip`, `tw_vat`, `th_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `li_uid`, `li_vat`, `lk_vat`, `my_itn`, `us_ein`, `kr_brn`, `ca_qst`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `my_sst`, `sg_gst`, `ae_trn`, `cl_tin`, `sa_vat`, `id_npwp`, `my_frp`, `il_vat`, `ge_vat`, `ua_vat`, `is_vat`, `bg_uic`, `hu_tin`, `si_tin`, `ke_pin`, `tr_tin`, `eg_tin`, `ph_tin`, `al_tin`, `bh_vat`, `kz_bin`, `ng_tin`, `om_vat`, `de_stn`, `ch_uid`, `tz_vat`, `uz_vat`, `uz_tin`, `md_vat`, `ma_vat`, `by_tin`, `ao_tin`, `bs_tin`, `bb_tin`, `cd_nif`, `mr_nif`, `me_pib`, `zw_tin`, `ba_tin`, `gn_nif`, `mk_vat`, `sr_fin`, `sn_ninea`, `am_tin`, `np_pan`, `tj_tin`, `ug_tin`, `zm_tin`, `kh_tin`, `aw_tin`, `az_tin`, `bd_bin`, `bj_ifu`, `et_tin`, `kg_tin`, `la_tin`, `cm_niu`, `cv_nif`, `bf_ifu`, or `unknown`
           attr_reader :type
           # The value of the tax ID.
           attr_reader :value
@@ -70,7 +70,7 @@ module Stripe
         end
       end
 
-      class Reversal < Stripe::StripeObject
+      class Reversal < ::Stripe::StripeObject
         # The `id` of the reversed `Transaction` object.
         attr_reader :original_transaction
 
@@ -83,8 +83,8 @@ module Stripe
         end
       end
 
-      class ShipFromDetails < Stripe::StripeObject
-        class Address < Stripe::StripeObject
+      class ShipFromDetails < ::Stripe::StripeObject
+        class Address < ::Stripe::StripeObject
           # City, district, suburb, town, or village.
           attr_reader :city
           # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
@@ -118,9 +118,9 @@ module Stripe
         end
       end
 
-      class ShippingCost < Stripe::StripeObject
-        class TaxBreakdown < Stripe::StripeObject
-          class Jurisdiction < Stripe::StripeObject
+      class ShippingCost < ::Stripe::StripeObject
+        class TaxBreakdown < ::Stripe::StripeObject
+          class Jurisdiction < ::Stripe::StripeObject
             # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
             attr_reader :country
             # A human-readable name for the jurisdiction imposing the tax.
@@ -139,7 +139,7 @@ module Stripe
             end
           end
 
-          class TaxRateDetails < Stripe::StripeObject
+          class TaxRateDetails < ::Stripe::StripeObject
             # A localized display name for tax type, intended to be human-readable. For example, "Local Sales and Use Tax", "Value-added tax (VAT)", or "Umsatzsteuer (USt.)".
             attr_reader :display_name
             # The tax rate percentage as a string. For example, 8.5% is represented as "8.5".
@@ -155,7 +155,7 @@ module Stripe
               @field_remappings = {}
             end
           end
-          # The amount of tax, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+          # The amount of tax, in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units).
           attr_reader :amount
           # Attribute for field jurisdiction
           attr_reader :jurisdiction
@@ -165,7 +165,7 @@ module Stripe
           attr_reader :tax_rate_details
           # The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
           attr_reader :taxability_reason
-          # The amount on which tax is calculated, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+          # The amount on which tax is calculated, in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units).
           attr_reader :taxable_amount
 
           def self.inner_class_types
@@ -176,17 +176,17 @@ module Stripe
             @field_remappings = {}
           end
         end
-        # The shipping amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
+        # The shipping amount in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
         attr_reader :amount
-        # The amount of tax calculated for shipping, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+        # The amount of tax calculated for shipping, in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units).
         attr_reader :amount_tax
-        # The ID of an existing [ShippingRate](https://stripe.com/docs/api/shipping_rates/object).
+        # The ID of an existing [ShippingRate](https://docs.stripe.com/api/shipping_rates/object).
         attr_reader :shipping_rate
         # Specifies whether the `amount` includes taxes. If `tax_behavior=inclusive`, then the amount includes taxes.
         attr_reader :tax_behavior
         # Detailed account of taxes relevant to shipping cost. (It is not populated for the transaction resource object and will be removed in the next API version.)
         attr_reader :tax_breakdown
-        # The [tax code](https://stripe.com/docs/tax/tax-categories) ID used for shipping.
+        # The [tax code](https://docs.stripe.com/tax/tax-categories) ID used for shipping.
         attr_reader :tax_code
 
         def self.inner_class_types
@@ -201,7 +201,7 @@ module Stripe
       attr_reader :created
       # Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
       attr_reader :currency
-      # The ID of an existing [Customer](https://stripe.com/docs/api/customers/object) used for the resource.
+      # The ID of an existing [Customer](https://docs.stripe.com/api/customers/object) used for the resource.
       attr_reader :customer
       # Attribute for field customer_details
       attr_reader :customer_details
@@ -209,9 +209,9 @@ module Stripe
       attr_reader :id
       # The tax collected or refunded, by line item.
       attr_reader :line_items
-      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+      # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
       attr_reader :livemode
-      # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+      # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
       attr_reader :metadata
       # String representing the object's type. Objects of the same type share the same value.
       attr_reader :object

data/lib/stripe/resources/tax/transaction_line_item.rb

@@ -9,7 +9,7 @@ module Stripe
         "tax.transaction_line_item"
       end
 
-      class Reversal < Stripe::StripeObject
+      class Reversal < ::Stripe::StripeObject
         # The `id` of the line item to reverse in the original transaction.
         attr_reader :original_line_item
 
@@ -21,19 +21,19 @@ module Stripe
           @field_remappings = {}
         end
       end
-      # The line item amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
+      # The line item amount in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units). If `tax_behavior=inclusive`, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.
       attr_reader :amount
-      # The amount of tax calculated for this line item, in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal).
+      # The amount of tax calculated for this line item, in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units).
       attr_reader :amount_tax
       # Unique identifier for the object.
       attr_reader :id
-      # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+      # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
       attr_reader :livemode
-      # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+      # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
       attr_reader :metadata
       # String representing the object's type. Objects of the same type share the same value.
       attr_reader :object
-      # The ID of an existing [Product](https://stripe.com/docs/api/products/object).
+      # The ID of an existing [Product](https://docs.stripe.com/api/products/object).
       attr_reader :product
       # The number of units of the item being purchased. For reversals, this is the quantity reversed.
       attr_reader :quantity
@@ -43,7 +43,7 @@ module Stripe
       attr_reader :reversal
       # Specifies whether the `amount` includes taxes. If `tax_behavior=inclusive`, then the amount includes taxes.
       attr_reader :tax_behavior
-      # The [tax code](https://stripe.com/docs/tax/tax-categories) ID used for this resource.
+      # The [tax code](https://docs.stripe.com/tax/tax-categories) ID used for this resource.
       attr_reader :tax_code
       # If `reversal`, this line item reverses an earlier transaction.
       attr_reader :type

data/lib/stripe/resources/tax_id.rb

@@ -2,10 +2,10 @@
 # frozen_string_literal: true
 
 module Stripe
-  # You can add one or multiple tax IDs to a [customer](https://stripe.com/docs/api/customers) or account.
+  # You can add one or multiple tax IDs to a [customer](https://docs.stripe.com/api/customers) or account.
   # Customer and account tax IDs get displayed on related invoices and credit notes.
   #
-  # Related guides: [Customer tax identification numbers](https://stripe.com/docs/billing/taxes/tax-ids), [Account tax IDs](https://stripe.com/docs/invoicing/connect#account-tax-ids)
+  # Related guides: [Customer tax identification numbers](https://docs.stripe.com/billing/taxes/tax-ids), [Account tax IDs](https://docs.stripe.com/invoicing/connect#account-tax-ids)
   class TaxId < APIResource
     extend Stripe::APIOperations::Create
     include Stripe::APIOperations::Delete
@@ -16,13 +16,15 @@ module Stripe
       "tax_id"
     end
 
-    class Owner < Stripe::StripeObject
+    class Owner < ::Stripe::StripeObject
       # The account being referenced when `type` is `account`.
       attr_reader :account
       # The Connect Application being referenced when `type` is `application`.
       attr_reader :application
       # The customer being referenced when `type` is `customer`.
       attr_reader :customer
+      # The Account representing the customer being referenced when `type` is `customer`.
+      attr_reader :customer_account
       # Type of owner referenced.
       attr_reader :type
 
@@ -35,7 +37,7 @@ module Stripe
       end
     end
 
-    class Verification < Stripe::StripeObject
+    class Verification < ::Stripe::StripeObject
       # Verification status, one of `pending`, `verified`, `unverified`, or `unavailable`.
       attr_reader :status
       # Verified address.
@@ -57,15 +59,17 @@ module Stripe
     attr_reader :created
     # ID of the customer.
     attr_reader :customer
+    # ID of the Account representing the customer.
+    attr_reader :customer_account
     # Unique identifier for the object.
     attr_reader :id
-    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
     attr_reader :livemode
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object
     # The account or customer the tax ID belongs to.
     attr_reader :owner
-    # Type of the tax ID, one of `ad_nrt`, `ae_trn`, `al_tin`, `am_tin`, `ao_tin`, `ar_cuit`, `au_abn`, `au_arn`, `aw_tin`, `az_tin`, `ba_tin`, `bb_tin`, `bd_bin`, `bf_ifu`, `bg_uic`, `bh_vat`, `bj_ifu`, `bo_tin`, `br_cnpj`, `br_cpf`, `bs_tin`, `by_tin`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `cd_nif`, `ch_uid`, `ch_vat`, `cl_tin`, `cm_niu`, `cn_tin`, `co_nit`, `cr_tin`, `cv_nif`, `de_stn`, `do_rcn`, `ec_ruc`, `eg_tin`, `es_cif`, `et_tin`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `gn_nif`, `hk_br`, `hr_oib`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `ke_pin`, `kg_tin`, `kh_tin`, `kr_brn`, `kz_bin`, `la_tin`, `li_uid`, `li_vat`, `ma_vat`, `md_vat`, `me_pib`, `mk_vat`, `mr_nif`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `ng_tin`, `no_vat`, `no_voec`, `np_pan`, `nz_gst`, `om_vat`, `pe_ruc`, `ph_tin`, `ro_tin`, `rs_pib`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `sn_ninea`, `sr_fin`, `sv_nit`, `th_vat`, `tj_tin`, `tr_tin`, `tw_vat`, `tz_vat`, `ua_vat`, `ug_tin`, `us_ein`, `uy_ruc`, `uz_tin`, `uz_vat`, `ve_rif`, `vn_tin`, `za_vat`, `zm_tin`, or `zw_tin`. Note that some legacy tax IDs have type `unknown`
+    # Type of the tax ID, one of `ad_nrt`, `ae_trn`, `al_tin`, `am_tin`, `ao_tin`, `ar_cuit`, `au_abn`, `au_arn`, `aw_tin`, `az_tin`, `ba_tin`, `bb_tin`, `bd_bin`, `bf_ifu`, `bg_uic`, `bh_vat`, `bj_ifu`, `bo_tin`, `br_cnpj`, `br_cpf`, `bs_tin`, `by_tin`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `cd_nif`, `ch_uid`, `ch_vat`, `cl_tin`, `cm_niu`, `cn_tin`, `co_nit`, `cr_tin`, `cv_nif`, `de_stn`, `do_rcn`, `ec_ruc`, `eg_tin`, `es_cif`, `et_tin`, `eu_oss_vat`, `eu_vat`, `gb_vat`, `ge_vat`, `gn_nif`, `hk_br`, `hr_oib`, `hu_tin`, `id_npwp`, `il_vat`, `in_gst`, `is_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `ke_pin`, `kg_tin`, `kh_tin`, `kr_brn`, `kz_bin`, `la_tin`, `li_uid`, `li_vat`, `lk_vat`, `ma_vat`, `md_vat`, `me_pib`, `mk_vat`, `mr_nif`, `mx_rfc`, `my_frp`, `my_itn`, `my_sst`, `ng_tin`, `no_vat`, `no_voec`, `np_pan`, `nz_gst`, `om_vat`, `pe_ruc`, `ph_tin`, `pl_nip`, `ro_tin`, `rs_pib`, `ru_inn`, `ru_kpp`, `sa_vat`, `sg_gst`, `sg_uen`, `si_tin`, `sn_ninea`, `sr_fin`, `sv_nit`, `th_vat`, `tj_tin`, `tr_tin`, `tw_vat`, `tz_vat`, `ua_vat`, `ug_tin`, `us_ein`, `uy_ruc`, `uz_tin`, `uz_vat`, `ve_rif`, `vn_tin`, `za_vat`, `zm_tin`, or `zw_tin`. Note that some legacy tax IDs have type `unknown`
     attr_reader :type
     # Value of the tax ID.
     attr_reader :value

data/lib/stripe/resources/tax_rate.rb

@@ -15,7 +15,7 @@ module Stripe
       "tax_rate"
     end
 
-    class FlatAmount < Stripe::StripeObject
+    class FlatAmount < ::Stripe::StripeObject
       # Amount of the tax when the `rate_type` is `flat_amount`. This positive integer represents how much to charge in the smallest currency unit (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99).
       attr_reader :amount
       # Three-letter ISO currency code, in lowercase.
@@ -53,9 +53,9 @@ module Stripe
     attr_reader :jurisdiction
     # The level of the jurisdiction that imposes this tax rate. Will be `null` for manually defined tax rates.
     attr_reader :jurisdiction_level
-    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    # If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
     attr_reader :livemode
-    # Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+    # Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
     attr_reader :metadata
     # String representing the object's type. Objects of the same type share the same value.
     attr_reader :object