stripe 19.2.0 → 19.3.0.pre.beta.1

data/lib/stripe/resources/issuing/fraud_liability_debit.rb

@@ -0,0 +1,51 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Issuing
+    # A fraud liability debit occurs when Stripe debits a platform's account for fraud losses on Issuing transactions.
+    class FraudLiabilityDebit < APIResource
+      extend Stripe::APIOperations::List
+
+      OBJECT_NAME = "issuing.fraud_liability_debit"
+      def self.object_name
+        "issuing.fraud_liability_debit"
+      end
+
+      # Debited amount. This is equal to the disputed amount and is given in the card’s currency and in the smallest currency unit.
+      attr_reader :amount
+      # ID of the [balance transaction](https://docs.stripe.com/api/balance_transactions) associated with this debit.
+      attr_reader :balance_transaction
+      # Time at which the object was created. Measured in seconds since the Unix epoch.
+      attr_reader :created
+      # The currency of the debit. 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 the linked dispute.
+      attr_reader :dispute
+      # Unique identifier for the object.
+      attr_reader :id
+      # 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
+
+      # Returns a list of Issuing FraudLiabilityDebit objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.
+      def self.list(params = {}, opts = {})
+        request_stripe_object(
+          method: :get,
+          path: "/v1/issuing/fraud_liability_debits",
+          params: params,
+          opts: opts
+        )
+      end
+
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+  end
+end

data/lib/stripe/resources/issuing/settlement.rb

@@ -0,0 +1,61 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  module Issuing
+    # When a non-stripe BIN is used, any use of an [issued card](https://docs.stripe.com/issuing) must be settled directly with the card network. The net amount owed is represented by an Issuing `Settlement` object.
+    class Settlement < APIResource
+      OBJECT_NAME = "issuing.settlement"
+      def self.object_name
+        "issuing.settlement"
+      end
+
+      # The Bank Identification Number reflecting this settlement record.
+      attr_reader :bin
+      # The date that the transactions are cleared and posted to user's accounts.
+      attr_reader :clearing_date
+      # 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 total interchange received as reimbursement for the transactions.
+      attr_reader :interchange_fees_amount
+      # 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://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
+      # The total net amount required to settle with the network.
+      attr_reader :net_total_amount
+      # The card network for this settlement report. One of ["visa", "maestro", "mastercard"]
+      attr_reader :network
+      # The total amount of fees owed to the network.
+      attr_reader :network_fees_amount
+      # The Settlement Identification Number assigned by the network.
+      attr_reader :network_settlement_identifier
+      # String representing the object's type. Objects of the same type share the same value.
+      attr_reader :object
+      # The total amount of any additional fees assessed by the card network.
+      attr_reader :other_fees_amount
+      # The total number of additional fees assessed by the card network.
+      attr_reader :other_fees_count
+      # One of `international` or `uk_national_net`.
+      attr_reader :settlement_service
+      # The current processing status of this settlement.
+      attr_reader :status
+      # The total transaction amount reflected in this settlement.
+      attr_reader :transaction_amount
+      # The total number of transactions reflected in this settlement.
+      attr_reader :transaction_count
+
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+  end
+end

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

@@ -440,6 +440,8 @@ module Stripe
       attr_reader :object
       # Additional purchase information that is optionally provided by the merchant.
       attr_reader :purchase_details
+      # The ID of the [settlement](https://docs.stripe.com/api/issuing/settlements) to which this transaction belongs.
+      attr_reader :settlement
       # [Token](https://docs.stripe.com/api/issuing/tokens/object) object used for this transaction. If a network token was not used for this transaction, this field will be null.
       attr_reader :token
       # [Treasury](https://docs.stripe.com/api/treasury) details related to this transaction if it was created on a [FinancialAccount](/docs/api/treasury/financial_accounts

data/lib/stripe/resources/line_item.rb

@@ -44,6 +44,38 @@ module Stripe
       end
     end
 
+    class Display < ::Stripe::StripeObject
+      # Attribute for field description
+      attr_reader :description
+      # Attribute for field images
+      attr_reader :images
+      # Attribute for field name
+      attr_reader :name
+
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+
+    class TaxCalculationReference < ::Stripe::StripeObject
+      # The calculation identifier for tax calculation response.
+      attr_reader :calculation_id
+      # The calculation identifier for tax calculation response line item.
+      attr_reader :calculation_item_id
+
+      def self.inner_class_types
+        @inner_class_types = {}
+      end
+
+      def self.field_remappings
+        @field_remappings = {}
+      end
+    end
+
     class Tax < ::Stripe::StripeObject
       # Amount of tax applied for this rate.
       attr_reader :amount
@@ -80,6 +112,8 @@ module Stripe
     attr_reader :description
     # The discounts applied to the line item.
     attr_reader :discounts
+    # Attribute for field display
+    attr_reader :display
     # Unique identifier for the object.
     attr_reader :id
     # 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.
@@ -88,8 +122,14 @@ module Stripe
     attr_reader :object
     # The price used to generate the line item.
     attr_reader :price
+    # The ID of the product for this line item.
+    #
+    # This will always be the same as `price.product`.
+    attr_reader :product
     # The quantity of products being purchased.
     attr_reader :quantity
+    # The tax calculation identifiers of the line item.
+    attr_reader :tax_calculation_reference
     # The taxes applied to the line item.
     attr_reader :taxes
 
@@ -97,6 +137,8 @@ module Stripe
       @inner_class_types = {
         adjustable_quantity: AdjustableQuantity,
         discounts: Discount,
+        display: Display,
+        tax_calculation_reference: TaxCalculationReference,
         taxes: Tax,
       }
     end

data/lib/stripe/resources/mandate.rb

@@ -4,6 +4,8 @@
 module Stripe
   # A Mandate is a record of the permission that your customer gives you to debit their payment method.
   class Mandate < APIResource
+    extend Stripe::APIOperations::List
+
     OBJECT_NAME = "mandate"
     def self.object_name
       "mandate"
@@ -216,8 +218,13 @@ module Stripe
       class Paypal < ::Stripe::StripeObject
         # The PayPal Billing Agreement ID (BAID). This is an ID generated by PayPal which represents the mandate between the merchant and the customer.
         attr_reader :billing_agreement_id
+        # Uniquely identifies this particular PayPal account. You can use this attribute to check whether two PayPal accounts are the same.
+        attr_reader :fingerprint
         # PayPal account PayerID. This identifier uniquely identifies the PayPal customer.
         attr_reader :payer_id
+        # Owner's verified email. Values are verified or provided by PayPal directly
+        # (if supported) at the time of authorization or settlement. They cannot be set or mutated.
+        attr_reader :verified_email
 
         def self.inner_class_types
           @inner_class_types = {}
@@ -452,6 +459,11 @@ module Stripe
     # The type of the mandate.
     attr_reader :type
 
+    # Retrieves a list of Mandates for a given PaymentMethod.
+    def self.list(params = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/mandates", params: params, opts: opts)
+    end
+
     def self.inner_class_types
       @inner_class_types = {
         customer_acceptance: CustomerAcceptance,

data/lib/stripe/resources/margin.rb

@@ -0,0 +1,64 @@
+# File generated from our OpenAPI spec
+# frozen_string_literal: true
+
+module Stripe
+  # A (partner) margin represents a specific discount distributed in partner reseller programs to business partners who
+  # resell products and services and earn a discount (margin) for doing so.
+  class Margin < APIResource
+    extend Stripe::APIOperations::Create
+    extend Stripe::APIOperations::List
+    include Stripe::APIOperations::Save
+
+    OBJECT_NAME = "margin"
+    def self.object_name
+      "margin"
+    end
+
+    # Whether the margin can be applied to invoices, invoice items, or invoice line items. Defaults to `true`.
+    attr_reader :active
+    # Time at which the object was created. Measured in seconds since the Unix epoch.
+    attr_reader :created
+    # Unique identifier for the object.
+    attr_reader :id
+    # 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://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
+    # Name of the margin that's displayed on, for example, invoices.
+    attr_reader :name
+    # String representing the object's type. Objects of the same type share the same value.
+    attr_reader :object
+    # Percent that will be taken off the subtotal before tax (after all other discounts and promotions) of any invoice to which the margin is applied.
+    attr_reader :percent_off
+    # Time at which the object was last updated. Measured in seconds since the Unix epoch.
+    attr_reader :updated
+
+    # Create a margin object to be used with invoices, invoice items, and invoice line items for a customer to represent a partner discount. A margin has a percent_off which is the percent that will be taken off the subtotal after all items and other discounts and promotions) of any invoices for a customer. Calculation of prorations do not include any partner margins applied on the original invoice item.
+    def self.create(params = {}, opts = {})
+      request_stripe_object(method: :post, path: "/v1/billing/margins", params: params, opts: opts)
+    end
+
+    # Retrieve a list of your margins.
+    def self.list(params = {}, opts = {})
+      request_stripe_object(method: :get, path: "/v1/billing/margins", params: params, opts: opts)
+    end
+
+    # Update the specified margin object. Certain fields of the margin object are not editable.
+    def self.update(margin, params = {}, opts = {})
+      request_stripe_object(
+        method: :post,
+        path: format("/v1/billing/margins/%<margin>s", { margin: CGI.escape(margin) }),
+        params: params,
+        opts: opts
+      )
+    end
+
+    def self.inner_class_types
+      @inner_class_types = {}
+    end
+
+    def self.field_remappings
+      @field_remappings = {}
+    end
+  end
+end