stripe 13.2.0 → 13.3.0.pre.beta.2

data/lib/stripe/resources/payout.rb

@@ -20,6 +20,62 @@ module Stripe
       "payout"
     end
 
+    class TraceId < Stripe::StripeObject
+      attr_reader :status, :value
+    end
+    # The amount (in cents (or local equivalent)) that transfers to your bank account or debit card.
+    attr_reader :amount
+    # The application fee (if any) for the payout. [See the Connect documentation](https://stripe.com/docs/connect/instant-payouts#monetization-and-fees) for details.
+    attr_reader :application_fee
+    # The amount of the application fee (if any) requested for the payout. [See the Connect documentation](https://stripe.com/docs/connect/instant-payouts#monetization-and-fees) for details.
+    attr_reader :application_fee_amount
+    # Date that you can expect the payout to arrive in the bank. This factors in delays to account for weekends or bank holidays.
+    attr_reader :arrival_date
+    # Returns `true` if the payout is created by an [automated payout schedule](https://stripe.com/docs/payouts#payout-schedule) and `false` if it's [requested manually](https://stripe.com/docs/payouts#manual-payouts).
+    attr_reader :automatic
+    # ID of the balance transaction that describes the impact of this payout on your account balance.
+    attr_reader :balance_transaction
+    # Time at which the object was created. Measured in seconds since the Unix epoch.
+    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
+    # An arbitrary string attached to the object. Often useful for displaying to users.
+    attr_reader :description
+    # ID of the bank account or card the payout is sent to.
+    attr_reader :destination
+    # If the payout fails or cancels, this is the ID of the balance transaction that reverses the initial balance transaction and returns the funds from the failed payout back in your balance.
+    attr_reader :failure_balance_transaction
+    # Error code that provides a reason for a payout failure, if available. View our [list of failure codes](https://stripe.com/docs/api#payout_failures).
+    attr_reader :failure_code
+    # Message that provides the reason for a payout failure, if available.
+    attr_reader :failure_message
+    # 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.
+    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.
+    attr_reader :metadata
+    # The method used to send this payout, which can be `standard` or `instant`. `instant` is supported for payouts to debit cards and bank accounts in certain countries. Learn more about [bank support for Instant Payouts](https://stripe.com/docs/payouts/instant-payouts-banks).
+    attr_reader :method
+    # String representing the object's type. Objects of the same type share the same value.
+    attr_reader :object
+    # If the payout reverses another, this is the ID of the original payout.
+    attr_reader :original_payout
+    # If `completed`, you can use the [Balance Transactions API](https://stripe.com/docs/api/balance_transactions/list#balance_transaction_list-payout) to list all balance transactions that are paid out in this payout.
+    attr_reader :reconciliation_status
+    # If the payout reverses, this is the ID of the payout that reverses this payout.
+    attr_reader :reversed_by
+    # The source balance this payout came from, which can be one of the following: `card`, `fpx`, or `bank_account`.
+    attr_reader :source_type
+    # Extra information about a payout that displays on the user's bank statement.
+    attr_reader :statement_descriptor
+    # Current status of the payout: `paid`, `pending`, `in_transit`, `canceled` or `failed`. A payout is `pending` until it's submitted to the bank, when it becomes `in_transit`. The status changes to `paid` if the transaction succeeds, or to `failed` or `canceled` (within 5 business days). Some payouts that fail might initially show as `paid`, then change to `failed`.
+    attr_reader :status
+    # A value that generates from the beneficiary's bank that allows users to track payouts with their bank. Banks might call this a "reference number" or something similar.
+    attr_reader :trace_id
+    # Can be `bank_account` or `card`.
+    attr_reader :type
+
     # You can cancel a previously created payout if its status is pending. Stripe refunds the funds to your available balance. You can't cancel automatic Stripe payouts.
     def cancel(params = {}, opts = {})
       request_stripe_object(

data/lib/stripe/resources/person.rb

@@ -15,6 +15,134 @@ module Stripe
       "person"
     end
 
+    class AdditionalTosAcceptances < Stripe::StripeObject
+      class Account < Stripe::StripeObject
+        attr_reader :date, :ip, :user_agent
+      end
+      attr_reader :account
+    end
+
+    class Address < Stripe::StripeObject
+      attr_reader :city, :country, :line1, :line2, :postal_code, :state
+    end
+
+    class AddressKana < Stripe::StripeObject
+      attr_reader :city, :country, :line1, :line2, :postal_code, :state, :town
+    end
+
+    class AddressKanji < Stripe::StripeObject
+      attr_reader :city, :country, :line1, :line2, :postal_code, :state, :town
+    end
+
+    class Dob < Stripe::StripeObject
+      attr_reader :day, :month, :year
+    end
+
+    class FutureRequirements < Stripe::StripeObject
+      class Alternative < Stripe::StripeObject
+        attr_reader :alternative_fields_due, :original_fields_due
+      end
+
+      class Error < Stripe::StripeObject
+        attr_reader :code, :reason, :requirement
+      end
+      attr_reader :alternatives, :currently_due, :errors, :eventually_due, :past_due, :pending_verification
+    end
+
+    class RegisteredAddress < Stripe::StripeObject
+      attr_reader :city, :country, :line1, :line2, :postal_code, :state
+    end
+
+    class Relationship < Stripe::StripeObject
+      attr_reader :authorizer, :director, :executive, :legal_guardian, :owner, :percent_ownership, :representative, :title
+    end
+
+    class Requirements < Stripe::StripeObject
+      class Alternative < Stripe::StripeObject
+        attr_reader :alternative_fields_due, :original_fields_due
+      end
+
+      class Error < Stripe::StripeObject
+        attr_reader :code, :reason, :requirement
+      end
+      attr_reader :alternatives, :currently_due, :errors, :eventually_due, :past_due, :pending_verification
+    end
+
+    class Verification < Stripe::StripeObject
+      class AdditionalDocument < Stripe::StripeObject
+        attr_reader :back, :details, :details_code, :front
+      end
+
+      class Document < Stripe::StripeObject
+        attr_reader :back, :details, :details_code, :front
+      end
+      attr_reader :additional_document, :details, :details_code, :document, :status
+    end
+    # The account the person is associated with.
+    attr_reader :account
+    # Attribute for field additional_tos_acceptances
+    attr_reader :additional_tos_acceptances
+    # Attribute for field address
+    attr_reader :address
+    # The Kana variation of the person's address (Japan only).
+    attr_reader :address_kana
+    # The Kanji variation of the person's address (Japan only).
+    attr_reader :address_kanji
+    # Time at which the object was created. Measured in seconds since the Unix epoch.
+    attr_reader :created
+    # Attribute for field dob
+    attr_reader :dob
+    # The person's email address.
+    attr_reader :email
+    # The person's first name.
+    attr_reader :first_name
+    # The Kana variation of the person's first name (Japan only).
+    attr_reader :first_name_kana
+    # The Kanji variation of the person's first name (Japan only).
+    attr_reader :first_name_kanji
+    # A list of alternate names or aliases that the person is known by.
+    attr_reader :full_name_aliases
+    # Information about the [upcoming new requirements for this person](https://stripe.com/docs/connect/custom-accounts/future-requirements), including what information needs to be collected, and by when.
+    attr_reader :future_requirements
+    # The person's gender.
+    attr_reader :gender
+    # Unique identifier for the object.
+    attr_reader :id
+    # Whether the person's `id_number` was provided. True if either the full ID number was provided or if only the required part of the ID number was provided (ex. last four of an individual's SSN for the US indicated by `ssn_last_4_provided`).
+    attr_reader :id_number_provided
+    # Whether the person's `id_number_secondary` was provided.
+    attr_reader :id_number_secondary_provided
+    # The person's last name.
+    attr_reader :last_name
+    # The Kana variation of the person's last name (Japan only).
+    attr_reader :last_name_kana
+    # The Kanji variation of the person's last name (Japan only).
+    attr_reader :last_name_kanji
+    # The person's maiden name.
+    attr_reader :maiden_name
+    # 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.
+    attr_reader :metadata
+    # The country where the person is a national.
+    attr_reader :nationality
+    # String representing the object's type. Objects of the same type share the same value.
+    attr_reader :object
+    # The person's phone number.
+    attr_reader :phone
+    # Indicates if the person or any of their representatives, family members, or other closely related persons, declares that they hold or have held an important public job or function, in any jurisdiction.
+    attr_reader :political_exposure
+    # Attribute for field registered_address
+    attr_reader :registered_address
+    # Attribute for field relationship
+    attr_reader :relationship
+    # Information about the requirements for this person, including what information needs to be collected, and by when.
+    attr_reader :requirements
+    # Whether the last four digits of the person's Social Security number have been provided (U.S. only).
+    attr_reader :ssn_last_4_provided
+    # Attribute for field verification
+    attr_reader :verification
+    # Always true for a deleted object
+    attr_reader :deleted
+
     def resource_url
       if !respond_to?(:account) || account.nil?
         raise NotImplementedError,

data/lib/stripe/resources/plan.rb

@@ -21,6 +21,58 @@ module Stripe
       "plan"
     end
 
+    class Tier < Stripe::StripeObject
+      attr_reader :flat_amount, :flat_amount_decimal, :unit_amount, :unit_amount_decimal, :up_to
+    end
+
+    class TransformUsage < Stripe::StripeObject
+      attr_reader :divide_by, :round
+    end
+    # Whether the plan can be used for new purchases.
+    attr_reader :active
+    # Specifies a usage aggregation strategy for plans of `usage_type=metered`. Allowed values are `sum` for summing up all usage during a period, `last_during_period` for using the last usage record reported within a period, `last_ever` for using the last usage record ever (across period bounds) or `max` which uses the usage record with the maximum reported usage during a period. Defaults to `sum`.
+    attr_reader :aggregate_usage
+    # The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if `billing_scheme=per_unit`.
+    attr_reader :amount
+    # The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if `billing_scheme=per_unit`.
+    attr_reader :amount_decimal
+    # Describes how to compute the price per period. Either `per_unit` or `tiered`. `per_unit` indicates that the fixed amount (specified in `amount`) will be charged per unit in `quantity` (for plans with `usage_type=licensed`), or per unit of total usage (for plans with `usage_type=metered`). `tiered` indicates that the unit pricing will be computed using a tiering strategy as defined using the `tiers` and `tiers_mode` attributes.
+    attr_reader :billing_scheme
+    # Time at which the object was created. Measured in seconds since the Unix epoch.
+    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
+    # Unique identifier for the object.
+    attr_reader :id
+    # The frequency at which a subscription is billed. One of `day`, `week`, `month` or `year`.
+    attr_reader :interval
+    # The number of intervals (specified in the `interval` attribute) between subscription billings. For example, `interval=month` and `interval_count=3` bills every 3 months.
+    attr_reader :interval_count
+    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    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.
+    attr_reader :metadata
+    # The meter tracking the usage of a metered price
+    attr_reader :meter
+    # A brief description of the plan, hidden from customers.
+    attr_reader :nickname
+    # String representing the object's type. Objects of the same type share the same value.
+    attr_reader :object
+    # The product whose pricing this plan determines.
+    attr_reader :product
+    # Each element represents a pricing tier. This parameter requires `billing_scheme` to be set to `tiered`. See also the documentation for `billing_scheme`.
+    attr_reader :tiers
+    # Defines if the tiering price should be `graduated` or `volume` based. In `volume`-based tiering, the maximum quantity within a period determines the per unit price. In `graduated` tiering, pricing can change as the quantity grows.
+    attr_reader :tiers_mode
+    # Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with `tiers`.
+    attr_reader :transform_usage
+    # Default number of trial days when subscribing a customer to this plan using [`trial_from_plan=true`](https://stripe.com/docs/api#create_subscription-trial_from_plan).
+    attr_reader :trial_period_days
+    # Configures how the quantity per period should be determined. Can be either `metered` or `licensed`. `licensed` automatically bills the `quantity` set when adding it to a subscription. `metered` aggregates the total usage based on usage records. Defaults to `licensed`.
+    attr_reader :usage_type
+    # Always true for a deleted object
+    attr_reader :deleted
+
     # You can now model subscriptions more flexibly using the [Prices API](https://stripe.com/docs/api#prices). It replaces the Plans API and is backwards compatible to simplify your migration.
     def self.create(params = {}, opts = {})
       request_stripe_object(method: :post, path: "/v1/plans", params: params, opts: opts)

data/lib/stripe/resources/price.rb

@@ -19,6 +19,83 @@ module Stripe
       "price"
     end
 
+    class CurrencyOptions < Stripe::StripeObject
+      class CustomUnitAmount < Stripe::StripeObject
+        attr_reader :maximum, :minimum, :preset
+      end
+
+      class Tier < Stripe::StripeObject
+        attr_reader :flat_amount, :flat_amount_decimal, :unit_amount, :unit_amount_decimal, :up_to
+      end
+      attr_reader :custom_unit_amount, :tax_behavior, :tiers, :unit_amount, :unit_amount_decimal
+    end
+
+    class CustomUnitAmount < Stripe::StripeObject
+      attr_reader :maximum, :minimum, :preset
+    end
+
+    class MigrateTo < Stripe::StripeObject
+      attr_reader :behavior, :effective_after, :price
+    end
+
+    class Recurring < Stripe::StripeObject
+      attr_reader :aggregate_usage, :interval, :interval_count, :meter, :trial_period_days, :usage_type
+    end
+
+    class Tier < Stripe::StripeObject
+      attr_reader :flat_amount, :flat_amount_decimal, :unit_amount, :unit_amount_decimal, :up_to
+    end
+
+    class TransformQuantity < Stripe::StripeObject
+      attr_reader :divide_by, :round
+    end
+    # Whether the price can be used for new purchases.
+    attr_reader :active
+    # Describes how to compute the price per period. Either `per_unit` or `tiered`. `per_unit` indicates that the fixed amount (specified in `unit_amount` or `unit_amount_decimal`) will be charged per unit in `quantity` (for prices with `usage_type=licensed`), or per unit of total usage (for prices with `usage_type=metered`). `tiered` indicates that the unit pricing will be computed using a tiering strategy as defined using the `tiers` and `tiers_mode` attributes.
+    attr_reader :billing_scheme
+    # Time at which the object was created. Measured in seconds since the Unix epoch.
+    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
+    # Prices defined in each available currency option. Each key must be a three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html) and a [supported currency](https://stripe.com/docs/currencies).
+    attr_reader :currency_options
+    # When set, provides configuration for the amount to be adjusted by the customer during Checkout Sessions and Payment Links.
+    attr_reader :custom_unit_amount
+    # 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.
+    attr_reader :livemode
+    # A lookup key used to retrieve prices dynamically from a static string. This may be up to 200 characters.
+    attr_reader :lookup_key
+    # 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.
+    attr_reader :metadata
+    # Subscriptions using this price will be migrated to use the new referenced price.
+    attr_reader :migrate_to
+    # A brief description of the price, hidden from customers.
+    attr_reader :nickname
+    # String representing the object's type. Objects of the same type share the same value.
+    attr_reader :object
+    # The ID of the product this price is associated with.
+    attr_reader :product
+    # The recurring components of a price such as `interval` and `usage_type`.
+    attr_reader :recurring
+    # Only required if a [default tax behavior](https://stripe.com/docs/tax/products-prices-tax-categories-tax-behavior#setting-a-default-tax-behavior-(recommended)) was not provided in the Stripe Tax settings. Specifies whether the price is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`. Once specified as either `inclusive` or `exclusive`, it cannot be changed.
+    attr_reader :tax_behavior
+    # Each element represents a pricing tier. This parameter requires `billing_scheme` to be set to `tiered`. See also the documentation for `billing_scheme`.
+    attr_reader :tiers
+    # Defines if the tiering price should be `graduated` or `volume` based. In `volume`-based tiering, the maximum quantity within a period determines the per unit price. In `graduated` tiering, pricing can change as the quantity grows.
+    attr_reader :tiers_mode
+    # Apply a transformation to the reported usage or set quantity before computing the amount billed. Cannot be combined with `tiers`.
+    attr_reader :transform_quantity
+    # One of `one_time` or `recurring` depending on whether the price is for a one-time purchase or a recurring (subscription) purchase.
+    attr_reader :type
+    # The unit amount in cents (or local equivalent) to be charged, represented as a whole integer if possible. Only set if `billing_scheme=per_unit`.
+    attr_reader :unit_amount
+    # The unit amount in cents (or local equivalent) to be charged, represented as a decimal string with at most 12 decimal places. Only set if `billing_scheme=per_unit`.
+    attr_reader :unit_amount_decimal
+    # Always true for a deleted object
+    attr_reader :deleted
+
     # Creates a new price for an existing product. The price can be recurring or one-time.
     def self.create(params = {}, opts = {})
       request_stripe_object(method: :post, path: "/v1/prices", params: params, opts: opts)

data/lib/stripe/resources/product.rb

@@ -25,6 +25,66 @@ module Stripe
 
     nested_resource_class_methods :feature, operations: %i[create retrieve delete list]
 
+    class MarketingFeature < Stripe::StripeObject
+      attr_reader :name
+    end
+
+    class PackageDimensions < Stripe::StripeObject
+      attr_reader :height, :length, :weight, :width
+    end
+
+    class Provisioning < Stripe::StripeObject
+      class GiftCard < Stripe::StripeObject
+        class FixedAmount < Stripe::StripeObject
+          attr_reader :amount, :currency
+        end
+        attr_reader :fixed_amount, :type
+      end
+      attr_reader :gift_card, :type
+    end
+    # Whether the product is currently available for purchase.
+    attr_reader :active
+    # Time at which the object was created. Measured in seconds since the Unix epoch.
+    attr_reader :created
+    # The ID of the [Price](https://stripe.com/docs/api/prices) object that is the default price for this product.
+    attr_reader :default_price
+    # The product's description, meant to be displayable to the customer. Use this field to optionally store a long form explanation of the product being sold for your own rendering purposes.
+    attr_reader :description
+    # Unique identifier for the object.
+    attr_reader :id
+    # A list of up to 8 URLs of images for this product, meant to be displayable to the customer.
+    attr_reader :images
+    # Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+    attr_reader :livemode
+    # A list of up to 15 marketing features for this product. These are displayed in [pricing tables](https://stripe.com/docs/payments/checkout/pricing-table).
+    attr_reader :marketing_features
+    # 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.
+    attr_reader :metadata
+    # The product's name, meant to be displayable to the customer.
+    attr_reader :name
+    # String representing the object's type. Objects of the same type share the same value.
+    attr_reader :object
+    # The dimensions of this product for shipping purposes.
+    attr_reader :package_dimensions
+    # Provisioning configuration for this product.
+    attr_reader :provisioning
+    # Whether this product is shipped (i.e., physical goods).
+    attr_reader :shippable
+    # Extra information about a product which will appear on your customer's credit card statement. In the case that multiple products are billed at once, the first statement descriptor will be used. Only used for subscription payments.
+    attr_reader :statement_descriptor
+    # A [tax code](https://stripe.com/docs/tax/tax-categories) ID.
+    attr_reader :tax_code
+    # The type of the product. The product is either of type `good`, which is eligible for use with Orders and SKUs, or `service`, which is eligible for use with Subscriptions and Plans.
+    attr_reader :type
+    # A label that represents units of this product. When set, this will be included in customers' receipts, invoices, Checkout, and the customer portal.
+    attr_reader :unit_label
+    # Time at which the object was last updated. Measured in seconds since the Unix epoch.
+    attr_reader :updated
+    # A URL of a publicly-accessible webpage for this product.
+    attr_reader :url
+    # Always true for a deleted object
+    attr_reader :deleted
+
     # Creates a new product object.
     def self.create(params = {}, opts = {})
       request_stripe_object(method: :post, path: "/v1/products", params: params, opts: opts)

data/lib/stripe/resources/product_feature.rb

@@ -9,5 +9,17 @@ module Stripe
     def self.object_name
       "product_feature"
     end
+
+    # A feature represents a monetizable ability or functionality in your system.
+    # Features can be assigned to products, and when those products are purchased, Stripe will create an entitlement to the feature for the purchasing customer.
+    attr_reader :entitlement_feature
+    # 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.
+    attr_reader :livemode
+    # String representing the object's type. Objects of the same type share the same value.
+    attr_reader :object
+    # Always true for a deleted object
+    attr_reader :deleted
   end
 end

data/lib/stripe/resources/promotion_code.rb

@@ -14,6 +14,41 @@ module Stripe
       "promotion_code"
     end
 
+    class Restrictions < Stripe::StripeObject
+      class CurrencyOptions < Stripe::StripeObject
+        attr_reader :minimum_amount
+      end
+      attr_reader :currency_options, :first_time_transaction, :minimum_amount, :minimum_amount_currency
+    end
+    # Whether the promotion code is currently active. A promotion code is only active if the coupon is also valid.
+    attr_reader :active
+    # The customer-facing code. Regardless of case, this code must be unique across all active promotion codes for each customer. Valid characters are lower case letters (a-z), upper case letters (A-Z), and digits (0-9).
+    attr_reader :code
+    # A coupon contains information about a percent-off or amount-off discount you
+    # might want to apply to a customer. Coupons may be applied to [subscriptions](https://stripe.com/docs/api#subscriptions), [invoices](https://stripe.com/docs/api#invoices),
+    # [checkout sessions](https://stripe.com/docs/api/checkout/sessions), [quotes](https://stripe.com/docs/api#quotes), and more. Coupons do not work with conventional one-off [charges](https://stripe.com/docs/api#create_charge) or [payment intents](https://stripe.com/docs/api/payment_intents).
+    attr_reader :coupon
+    # Time at which the object was created. Measured in seconds since the Unix epoch.
+    attr_reader :created
+    # The customer that this promotion code can be used by.
+    attr_reader :customer
+    # Date at which the promotion code can no longer be redeemed.
+    attr_reader :expires_at
+    # 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.
+    attr_reader :livemode
+    # Maximum number of times this promotion code can be redeemed.
+    attr_reader :max_redemptions
+    # 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.
+    attr_reader :metadata
+    # String representing the object's type. Objects of the same type share the same value.
+    attr_reader :object
+    # Attribute for field restrictions
+    attr_reader :restrictions
+    # Number of times this promotion code has been used.
+    attr_reader :times_redeemed
+
     # A promotion code points to a coupon. You can optionally restrict the code to a specific customer, redemption limit, and expiration date.
     def self.create(params = {}, opts = {})
       request_stripe_object(method: :post, path: "/v1/promotion_codes", params: params, opts: opts)