dodopayments 1.18.0 → 1.18.1

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 (109) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +18 -0
  3. data/README.md +1 -1
  4. data/lib/dodopayments/file_part.rb +55 -0
  5. data/lib/dodopayments/internal/transport/base_client.rb +3 -3
  6. data/lib/dodopayments/internal/transport/pooled_net_requester.rb +1 -1
  7. data/lib/dodopayments/internal/type/converter.rb +1 -1
  8. data/lib/dodopayments/internal/type/{io_like.rb → file_input.rb} +8 -4
  9. data/lib/dodopayments/internal/util.rb +69 -61
  10. data/lib/dodopayments/models/billing_address.rb +9 -5
  11. data/lib/dodopayments/models/create_new_customer.rb +8 -1
  12. data/lib/dodopayments/models/customer_limited_details.rb +5 -3
  13. data/lib/dodopayments/models/customer_list_params.rb +4 -2
  14. data/lib/dodopayments/models/customers/customer_portal_create_params.rb +2 -1
  15. data/lib/dodopayments/models/discount.rb +23 -10
  16. data/lib/dodopayments/models/discount_create_params.rb +15 -5
  17. data/lib/dodopayments/models/discount_list_params.rb +4 -2
  18. data/lib/dodopayments/models/discount_update_params.rb +13 -3
  19. data/lib/dodopayments/models/dispute.rb +17 -6
  20. data/lib/dodopayments/models/dispute_list_params.rb +14 -7
  21. data/lib/dodopayments/models/license_key.rb +26 -11
  22. data/lib/dodopayments/models/license_key_instance_list_params.rb +6 -3
  23. data/lib/dodopayments/models/license_key_list_params.rb +10 -5
  24. data/lib/dodopayments/models/license_key_update_params.rb +9 -3
  25. data/lib/dodopayments/models/one_time_product_cart_item.rb +7 -1
  26. data/lib/dodopayments/models/payment.rb +41 -16
  27. data/lib/dodopayments/models/payment_create_params.rb +22 -7
  28. data/lib/dodopayments/models/payment_create_response.rb +16 -6
  29. data/lib/dodopayments/models/payment_list_params.rb +14 -7
  30. data/lib/dodopayments/models/payout_list_params.rb +4 -2
  31. data/lib/dodopayments/models/payout_list_response.rb +27 -13
  32. data/lib/dodopayments/models/price.rb +38 -13
  33. data/lib/dodopayments/models/product.rb +31 -13
  34. data/lib/dodopayments/models/product_create_params.rb +20 -7
  35. data/lib/dodopayments/models/product_list_params.rb +11 -4
  36. data/lib/dodopayments/models/product_list_response.rb +27 -11
  37. data/lib/dodopayments/models/product_update_params.rb +22 -8
  38. data/lib/dodopayments/models/refund.rb +13 -6
  39. data/lib/dodopayments/models/refund_create_params.rb +4 -2
  40. data/lib/dodopayments/models/refund_list_params.rb +12 -6
  41. data/lib/dodopayments/models/subscription.rb +37 -13
  42. data/lib/dodopayments/models/subscription_change_plan_params.rb +5 -2
  43. data/lib/dodopayments/models/subscription_charge_params.rb +6 -1
  44. data/lib/dodopayments/models/subscription_create_params.rb +34 -11
  45. data/lib/dodopayments/models/subscription_create_response.rb +15 -5
  46. data/lib/dodopayments/models/subscription_list_params.rb +12 -6
  47. data/lib/dodopayments/models/webhook_event_list_params.rb +16 -6
  48. data/lib/dodopayments/resources/customers/customer_portal.rb +4 -2
  49. data/lib/dodopayments/resources/customers.rb +10 -4
  50. data/lib/dodopayments/resources/discounts.rb +38 -13
  51. data/lib/dodopayments/resources/disputes.rb +16 -8
  52. data/lib/dodopayments/resources/license_key_instances.rb +11 -5
  53. data/lib/dodopayments/resources/license_keys.rb +23 -10
  54. data/lib/dodopayments/resources/payments.rb +38 -15
  55. data/lib/dodopayments/resources/payouts.rb +4 -2
  56. data/lib/dodopayments/resources/products/images.rb +3 -1
  57. data/lib/dodopayments/resources/products.rb +56 -20
  58. data/lib/dodopayments/resources/refunds.rb +18 -9
  59. data/lib/dodopayments/resources/subscriptions.rb +62 -22
  60. data/lib/dodopayments/resources/webhook_events.rb +16 -6
  61. data/lib/dodopayments/version.rb +1 -1
  62. data/lib/dodopayments.rb +2 -1
  63. data/rbi/lib/dodopayments/file_part.rbi +34 -0
  64. data/rbi/lib/dodopayments/internal/transport/base_client.rbi +17 -3
  65. data/rbi/lib/dodopayments/internal/type/{io_like.rbi → file_input.rbi} +6 -2
  66. data/rbi/lib/dodopayments/internal/util.rbi +24 -19
  67. data/rbi/lib/dodopayments/models/billing_address.rbi +12 -2
  68. data/rbi/lib/dodopayments/models/create_new_customer.rbi +9 -2
  69. data/rbi/lib/dodopayments/models/customer_limited_details.rbi +8 -2
  70. data/rbi/lib/dodopayments/models/customer_list_params.rbi +7 -2
  71. data/rbi/lib/dodopayments/models/customers/customer_portal_create_params.rbi +5 -2
  72. data/rbi/lib/dodopayments/models/discount.rbi +14 -0
  73. data/rbi/lib/dodopayments/models/discount_create_params.rbi +15 -0
  74. data/rbi/lib/dodopayments/models/discount_list_params.rbi +7 -2
  75. data/rbi/lib/dodopayments/models/discount_update_params.rbi +10 -0
  76. data/rbi/lib/dodopayments/models/dispute.rbi +8 -3
  77. data/rbi/lib/dodopayments/models/dispute_list_params.rbi +7 -0
  78. data/rbi/lib/dodopayments/models/license_key.rbi +12 -0
  79. data/rbi/lib/dodopayments/models/license_key_instance_list_params.rbi +9 -2
  80. data/rbi/lib/dodopayments/models/license_key_list_params.rbi +6 -3
  81. data/rbi/lib/dodopayments/models/license_key_update_params.rbi +12 -2
  82. data/rbi/lib/dodopayments/models/one_time_product_cart_item.rbi +8 -2
  83. data/rbi/lib/dodopayments/models/payment.rbi +19 -0
  84. data/rbi/lib/dodopayments/models/payment_create_params.rbi +14 -0
  85. data/rbi/lib/dodopayments/models/payment_create_response.rbi +7 -0
  86. data/rbi/lib/dodopayments/models/payment_list_params.rbi +7 -0
  87. data/rbi/lib/dodopayments/models/payout_list_params.rbi +7 -2
  88. data/rbi/lib/dodopayments/models/payout_list_response.rbi +13 -0
  89. data/rbi/lib/dodopayments/models/price.rbi +25 -0
  90. data/rbi/lib/dodopayments/models/product.rbi +14 -0
  91. data/rbi/lib/dodopayments/models/product_create_params.rbi +8 -0
  92. data/rbi/lib/dodopayments/models/product_list_params.rbi +15 -2
  93. data/rbi/lib/dodopayments/models/product_list_response.rbi +21 -0
  94. data/rbi/lib/dodopayments/models/product_update_params.rbi +18 -0
  95. data/rbi/lib/dodopayments/models/refund.rbi +7 -3
  96. data/rbi/lib/dodopayments/models/refund_create_params.rbi +7 -2
  97. data/rbi/lib/dodopayments/models/refund_list_params.rbi +6 -0
  98. data/rbi/lib/dodopayments/models/subscription.rbi +15 -0
  99. data/rbi/lib/dodopayments/models/subscription_change_plan_params.rbi +8 -2
  100. data/rbi/lib/dodopayments/models/subscription_charge_params.rbi +6 -2
  101. data/rbi/lib/dodopayments/models/subscription_create_params.rbi +25 -2
  102. data/rbi/lib/dodopayments/models/subscription_create_response.rbi +7 -0
  103. data/rbi/lib/dodopayments/models/subscription_list_params.rbi +6 -0
  104. data/rbi/lib/dodopayments/models/webhook_event_list_params.rbi +6 -0
  105. data/sig/dodopayments/file_part.rbs +21 -0
  106. data/sig/dodopayments/internal/transport/base_client.rbs +9 -3
  107. data/sig/dodopayments/internal/type/{io_like.rbs → file_input.rbs} +1 -1
  108. data/sig/dodopayments/internal/util.rbs +14 -12
  109. metadata +8 -5
@@ -77,18 +77,33 @@ module Dodopayments
77
77
  optional :subscription_id, String, nil?: true
78
78
 
79
79
  # @!method initialize(id:, business_id:, created_at:, customer_id:, instances_count:, key:, payment_id:, product_id:, status:, activations_limit: nil, expires_at: nil, subscription_id: nil)
80
- # @param id [String]
81
- # @param business_id [String]
82
- # @param created_at [Time]
83
- # @param customer_id [String]
84
- # @param instances_count [Integer]
85
- # @param key [String]
86
- # @param payment_id [String]
87
- # @param product_id [String]
80
+ # Some parameter documentations has been truncated, see
81
+ # {Dodopayments::Models::LicenseKey} for more details.
82
+ #
83
+ # @param id [String] The unique identifier of the license key.
84
+ #
85
+ # @param business_id [String] The unique identifier of the business associated with the license key.
86
+ #
87
+ # @param created_at [Time] The timestamp indicating when the license key was created, in UTC.
88
+ #
89
+ # @param customer_id [String] The unique identifier of the customer associated with the license key.
90
+ #
91
+ # @param instances_count [Integer] The current number of instances activated for this license key.
92
+ #
93
+ # @param key [String] The license key string.
94
+ #
95
+ # @param payment_id [String] The unique identifier of the payment associated with the license key.
96
+ #
97
+ # @param product_id [String] The unique identifier of the product associated with the license key.
98
+ #
88
99
  # @param status [Symbol, Dodopayments::Models::LicenseKeyStatus]
89
- # @param activations_limit [Integer, nil]
90
- # @param expires_at [Time, nil]
91
- # @param subscription_id [String, nil]
100
+ #
101
+ # @param activations_limit [Integer, nil] The maximum number of activations allowed for this license key.
102
+ #
103
+ # @param expires_at [Time, nil] The timestamp indicating when the license key expires, in UTC.
104
+ #
105
+ # @param subscription_id [String, nil] The unique identifier of the subscription associated with the license key, if an
106
+ # ...
92
107
  end
93
108
  end
94
109
  end
@@ -26,9 +26,12 @@ module Dodopayments
26
26
  optional :page_size, Integer, nil?: true
27
27
 
28
28
  # @!method initialize(license_key_id: nil, page_number: nil, page_size: nil, request_options: {})
29
- # @param license_key_id [String, nil]
30
- # @param page_number [Integer, nil]
31
- # @param page_size [Integer, nil]
29
+ # @param license_key_id [String, nil] Filter by license key ID
30
+ #
31
+ # @param page_number [Integer, nil] Page number default is 0
32
+ #
33
+ # @param page_size [Integer, nil] Page size default is 10 max is 100
34
+ #
32
35
  # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
33
36
  end
34
37
  end
@@ -38,11 +38,16 @@ module Dodopayments
38
38
  optional :status, enum: -> { Dodopayments::Models::LicenseKeyStatus }, nil?: true
39
39
 
40
40
  # @!method initialize(customer_id: nil, page_number: nil, page_size: nil, product_id: nil, status: nil, request_options: {})
41
- # @param customer_id [String, nil]
42
- # @param page_number [Integer, nil]
43
- # @param page_size [Integer, nil]
44
- # @param product_id [String, nil]
45
- # @param status [Symbol, Dodopayments::Models::LicenseKeyStatus, nil]
41
+ # @param customer_id [String, nil] Filter by customer ID
42
+ #
43
+ # @param page_number [Integer, nil] Page number default is 0
44
+ #
45
+ # @param page_size [Integer, nil] Page size default is 10 max is 100
46
+ #
47
+ # @param product_id [String, nil] Filter by product ID
48
+ #
49
+ # @param status [Symbol, Dodopayments::Models::LicenseKeyStatus, nil] Filter by license key status
50
+ #
46
51
  # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
47
52
  end
48
53
  end
@@ -29,9 +29,15 @@ module Dodopayments
29
29
  optional :expires_at, Time, nil?: true
30
30
 
31
31
  # @!method initialize(activations_limit: nil, disabled: nil, expires_at: nil, request_options: {})
32
- # @param activations_limit [Integer, nil]
33
- # @param disabled [Boolean, nil]
34
- # @param expires_at [Time, nil]
32
+ # Some parameter documentations has been truncated, see
33
+ # {Dodopayments::Models::LicenseKeyUpdateParams} for more details.
34
+ #
35
+ # @param activations_limit [Integer, nil] The updated activation limit for the license key. ...
36
+ #
37
+ # @param disabled [Boolean, nil] Indicates whether the license key should be disabled. ...
38
+ #
39
+ # @param expires_at [Time, nil] The updated expiration timestamp for the license key in UTC. ...
40
+ #
35
41
  # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
36
42
  end
37
43
  end
@@ -22,9 +22,15 @@ module Dodopayments
22
22
  optional :amount, Integer, nil?: true
23
23
 
24
24
  # @!method initialize(product_id:, quantity:, amount: nil)
25
+ # Some parameter documentations has been truncated, see
26
+ # {Dodopayments::Models::OneTimeProductCartItem} for more details.
27
+ #
25
28
  # @param product_id [String]
29
+ #
26
30
  # @param quantity [Integer]
27
- # @param amount [Integer, nil]
31
+ #
32
+ # @param amount [Integer, nil] Amount the customer pays if pay_what_you_want is enabled. If disabled then amoun
33
+ # ...
28
34
  end
29
35
  end
30
36
  end
@@ -131,27 +131,52 @@ module Dodopayments
131
131
  optional :updated_at, Time, nil?: true
132
132
 
133
133
  # @!method initialize(business_id:, created_at:, currency:, customer:, disputes:, metadata:, payment_id:, refunds:, settlement_amount:, settlement_currency:, total_amount:, discount_id: nil, error_message: nil, payment_link: nil, payment_method: nil, payment_method_type: nil, product_cart: nil, status: nil, subscription_id: nil, tax: nil, updated_at: nil)
134
- # @param business_id [String]
135
- # @param created_at [Time]
134
+ # Some parameter documentations has been truncated, see
135
+ # {Dodopayments::Models::Payment} for more details.
136
+ #
137
+ # @param business_id [String] Identifier of the business associated with the payment
138
+ #
139
+ # @param created_at [Time] Timestamp when the payment was created
140
+ #
136
141
  # @param currency [Symbol, Dodopayments::Models::Payment::Currency]
142
+ #
137
143
  # @param customer [Dodopayments::Models::CustomerLimitedDetails]
138
- # @param disputes [Array<Dodopayments::Models::Dispute>]
144
+ #
145
+ # @param disputes [Array<Dodopayments::Models::Dispute>] List of disputes associated with this payment
146
+ #
139
147
  # @param metadata [Hash{Symbol=>String}]
140
- # @param payment_id [String]
141
- # @param refunds [Array<Dodopayments::Models::Refund>]
142
- # @param settlement_amount [Integer]
148
+ #
149
+ # @param payment_id [String] Unique identifier for the payment
150
+ #
151
+ # @param refunds [Array<Dodopayments::Models::Refund>] List of refunds issued for this payment
152
+ #
153
+ # @param settlement_amount [Integer] The amount that will be credited to your Dodo balance after currency conversion
154
+ # ...
155
+ #
143
156
  # @param settlement_currency [Symbol, Dodopayments::Models::Payment::SettlementCurrency]
144
- # @param total_amount [Integer]
145
- # @param discount_id [String, nil]
146
- # @param error_message [String, nil]
147
- # @param payment_link [String, nil]
148
- # @param payment_method [String, nil]
149
- # @param payment_method_type [String, nil]
150
- # @param product_cart [Array<Dodopayments::Models::Payment::ProductCart>, nil]
157
+ #
158
+ # @param total_amount [Integer] Total amount charged to the customer including tax, in smallest currency unit (e
159
+ # ...
160
+ #
161
+ # @param discount_id [String, nil] The discount id if discount is applied
162
+ #
163
+ # @param error_message [String, nil] An error message if the payment failed
164
+ #
165
+ # @param payment_link [String, nil] Checkout URL
166
+ #
167
+ # @param payment_method [String, nil] Payment method used by customer (e.g. "card", "bank_transfer")
168
+ #
169
+ # @param payment_method_type [String, nil] Specific type of payment method (e.g. "visa", "mastercard")
170
+ #
171
+ # @param product_cart [Array<Dodopayments::Models::Payment::ProductCart>, nil] List of products purchased in a one-time payment
172
+ #
151
173
  # @param status [Symbol, Dodopayments::Models::IntentStatus, nil]
152
- # @param subscription_id [String, nil]
153
- # @param tax [Integer, nil]
154
- # @param updated_at [Time, nil]
174
+ #
175
+ # @param subscription_id [String, nil] Identifier of the subscription if payment is part of a subscription
176
+ #
177
+ # @param tax [Integer, nil] Amount of tax collected in smallest currency unit (e.g. cents)
178
+ #
179
+ # @param updated_at [Time, nil] Timestamp when the payment was last updated
155
180
 
156
181
  # @see Dodopayments::Models::Payment#currency
157
182
  module Currency
@@ -82,17 +82,32 @@ module Dodopayments
82
82
  optional :tax_id, String, nil?: true
83
83
 
84
84
  # @!method initialize(billing:, customer:, product_cart:, allowed_payment_method_types: nil, billing_currency: nil, discount_code: nil, metadata: nil, payment_link: nil, return_url: nil, show_saved_payment_methods: nil, tax_id: nil, request_options: {})
85
+ # Some parameter documentations has been truncated, see
86
+ # {Dodopayments::Models::PaymentCreateParams} for more details.
87
+ #
85
88
  # @param billing [Dodopayments::Models::BillingAddress]
89
+ #
86
90
  # @param customer [Dodopayments::Models::AttachExistingCustomer, Dodopayments::Models::CreateNewCustomer]
87
- # @param product_cart [Array<Dodopayments::Models::OneTimeProductCartItem>]
88
- # @param allowed_payment_method_types [Array<Symbol, Dodopayments::Models::PaymentCreateParams::AllowedPaymentMethodType>, nil]
91
+ #
92
+ # @param product_cart [Array<Dodopayments::Models::OneTimeProductCartItem>] List of products in the cart. Must contain at least 1 and at most 100 items.
93
+ #
94
+ # @param allowed_payment_method_types [Array<Symbol, Dodopayments::Models::PaymentCreateParams::AllowedPaymentMethodType>, nil] List of payment methods allowed during checkout. ...
95
+ #
89
96
  # @param billing_currency [Symbol, Dodopayments::Models::PaymentCreateParams::BillingCurrency, nil]
90
- # @param discount_code [String, nil]
97
+ #
98
+ # @param discount_code [String, nil] Discount Code to apply to the transaction
99
+ #
91
100
  # @param metadata [Hash{Symbol=>String}]
92
- # @param payment_link [Boolean, nil]
93
- # @param return_url [String, nil]
94
- # @param show_saved_payment_methods [Boolean]
95
- # @param tax_id [String, nil]
101
+ #
102
+ # @param payment_link [Boolean, nil] Whether to generate a payment link. Defaults to false if not specified.
103
+ #
104
+ # @param return_url [String, nil] Optional URL to redirect the customer after payment. ...
105
+ #
106
+ # @param show_saved_payment_methods [Boolean] Display saved payment methods of a returning customer ...
107
+ #
108
+ # @param tax_id [String, nil] Tax ID in case the payment is B2B. If tax id validation fails the payment creati
109
+ # ...
110
+ #
96
111
  # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
97
112
 
98
113
  module AllowedPaymentMethodType
@@ -54,14 +54,24 @@ module Dodopayments
54
54
  nil?: true
55
55
 
56
56
  # @!method initialize(client_secret:, customer:, metadata:, payment_id:, total_amount:, discount_id: nil, payment_link: nil, product_cart: nil)
57
- # @param client_secret [String]
57
+ # Some parameter documentations has been truncated, see
58
+ # {Dodopayments::Models::PaymentCreateResponse} for more details.
59
+ #
60
+ # @param client_secret [String] Client secret used to load Dodo checkout SDK ...
61
+ #
58
62
  # @param customer [Dodopayments::Models::CustomerLimitedDetails]
63
+ #
59
64
  # @param metadata [Hash{Symbol=>String}]
60
- # @param payment_id [String]
61
- # @param total_amount [Integer]
62
- # @param discount_id [String, nil]
63
- # @param payment_link [String, nil]
64
- # @param product_cart [Array<Dodopayments::Models::OneTimeProductCartItem>, nil]
65
+ #
66
+ # @param payment_id [String] Unique identifier for the payment
67
+ #
68
+ # @param total_amount [Integer] Total amount of the payment in smallest currency unit (e.g. cents)
69
+ #
70
+ # @param discount_id [String, nil] The discount id if discount is applied
71
+ #
72
+ # @param payment_link [String, nil] Optional URL to a hosted payment page
73
+ #
74
+ # @param product_cart [Array<Dodopayments::Models::OneTimeProductCartItem>, nil] Optional list of products included in the payment
65
75
  end
66
76
  end
67
77
  end
@@ -50,13 +50,20 @@ module Dodopayments
50
50
  optional :subscription_id, String, nil?: true
51
51
 
52
52
  # @!method initialize(created_at_gte: nil, created_at_lte: nil, customer_id: nil, page_number: nil, page_size: nil, status: nil, subscription_id: nil, request_options: {})
53
- # @param created_at_gte [Time, nil]
54
- # @param created_at_lte [Time, nil]
55
- # @param customer_id [String, nil]
56
- # @param page_number [Integer, nil]
57
- # @param page_size [Integer, nil]
58
- # @param status [Symbol, Dodopayments::Models::IntentStatus, nil]
59
- # @param subscription_id [String, nil]
53
+ # @param created_at_gte [Time, nil] Get events after this created time
54
+ #
55
+ # @param created_at_lte [Time, nil] Get events created before this time
56
+ #
57
+ # @param customer_id [String, nil] Filter by customer id
58
+ #
59
+ # @param page_number [Integer, nil] Page number default is 0
60
+ #
61
+ # @param page_size [Integer, nil] Page size default is 10 max is 100
62
+ #
63
+ # @param status [Symbol, Dodopayments::Models::IntentStatus, nil] Filter by status
64
+ #
65
+ # @param subscription_id [String, nil] Filter by subscription id
66
+ #
60
67
  # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
61
68
  end
62
69
  end
@@ -20,8 +20,10 @@ module Dodopayments
20
20
  optional :page_size, Integer, nil?: true
21
21
 
22
22
  # @!method initialize(page_number: nil, page_size: nil, request_options: {})
23
- # @param page_number [Integer, nil]
24
- # @param page_size [Integer, nil]
23
+ # @param page_number [Integer, nil] Page number default is 0
24
+ #
25
+ # @param page_size [Integer, nil] Page size default is 10 max is 100
26
+ #
25
27
  # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
26
28
  end
27
29
  end
@@ -93,21 +93,35 @@ module Dodopayments
93
93
  optional :remarks, String, nil?: true
94
94
 
95
95
  # @!method initialize(amount:, business_id:, chargebacks:, created_at:, currency:, fee:, payment_method:, payout_id:, refunds:, status:, tax:, updated_at:, name: nil, payout_document_url: nil, remarks: nil)
96
- # @param amount [Integer]
97
- # @param business_id [String]
98
- # @param chargebacks [Integer]
99
- # @param created_at [Time]
96
+ # @param amount [Integer] The total amount of the payout.
97
+ #
98
+ # @param business_id [String] The unique identifier of the business associated with the payout.
99
+ #
100
+ # @param chargebacks [Integer] The total value of chargebacks associated with the payout.
101
+ #
102
+ # @param created_at [Time] The timestamp when the payout was created, in UTC.
103
+ #
100
104
  # @param currency [Symbol, Dodopayments::Models::PayoutListResponse::Currency]
101
- # @param fee [Integer]
102
- # @param payment_method [String]
103
- # @param payout_id [String]
104
- # @param refunds [Integer]
105
+ #
106
+ # @param fee [Integer] The fee charged for processing the payout.
107
+ #
108
+ # @param payment_method [String] The payment method used for the payout (e.g., bank transfer, card, etc.).
109
+ #
110
+ # @param payout_id [String] The unique identifier of the payout.
111
+ #
112
+ # @param refunds [Integer] The total value of refunds associated with the payout.
113
+ #
105
114
  # @param status [Symbol, Dodopayments::Models::PayoutListResponse::Status]
106
- # @param tax [Integer]
107
- # @param updated_at [Time]
108
- # @param name [String, nil]
109
- # @param payout_document_url [String, nil]
110
- # @param remarks [String, nil]
115
+ #
116
+ # @param tax [Integer] The tax applied to the payout.
117
+ #
118
+ # @param updated_at [Time] The timestamp when the payout was last updated, in UTC.
119
+ #
120
+ # @param name [String, nil] The name of the payout recipient or purpose.
121
+ #
122
+ # @param payout_document_url [String, nil] The URL of the document associated with the payout.
123
+ #
124
+ # @param remarks [String, nil] Any additional remarks or notes associated with the payout.
111
125
 
112
126
  # @see Dodopayments::Models::PayoutListResponse#currency
113
127
  module Currency
@@ -67,13 +67,24 @@ module Dodopayments
67
67
  optional :tax_inclusive, Dodopayments::Internal::Type::Boolean, nil?: true
68
68
 
69
69
  # @!method initialize(currency:, discount:, price:, purchasing_power_parity:, pay_what_you_want: nil, suggested_price: nil, tax_inclusive: nil, type: :one_time_price)
70
+ # Some parameter documentations has been truncated, see
71
+ # {Dodopayments::Models::Price::OneTimePrice} for more details.
72
+ #
70
73
  # @param currency [Symbol, Dodopayments::Models::Price::OneTimePrice::Currency]
71
- # @param discount [Float]
72
- # @param price [Integer]
73
- # @param purchasing_power_parity [Boolean]
74
- # @param pay_what_you_want [Boolean]
75
- # @param suggested_price [Integer, nil]
76
- # @param tax_inclusive [Boolean, nil]
74
+ #
75
+ # @param discount [Float] Discount applied to the price, represented as a percentage (0 to 100).
76
+ #
77
+ # @param price [Integer] The payment amount, in the smallest denomination of the currency (e.g., cents fo
78
+ # ...
79
+ #
80
+ # @param purchasing_power_parity [Boolean] Indicates if purchasing power parity adjustments are applied to the price. ...
81
+ #
82
+ # @param pay_what_you_want [Boolean] Indicates whether the customer can pay any amount they choose. ...
83
+ #
84
+ # @param suggested_price [Integer, nil] A suggested price for the user to pay. This value is only considered if ...
85
+ #
86
+ # @param tax_inclusive [Boolean, nil] Indicates if the price is tax inclusive.
87
+ #
77
88
  # @param type [Symbol, :one_time_price]
78
89
 
79
90
  # @see Dodopayments::Models::Price::OneTimePrice#currency
@@ -299,16 +310,30 @@ module Dodopayments
299
310
  optional :trial_period_days, Integer
300
311
 
301
312
  # @!method initialize(currency:, discount:, payment_frequency_count:, payment_frequency_interval:, price:, purchasing_power_parity:, subscription_period_count:, subscription_period_interval:, tax_inclusive: nil, trial_period_days: nil, type: :recurring_price)
313
+ # Some parameter documentations has been truncated, see
314
+ # {Dodopayments::Models::Price::RecurringPrice} for more details.
315
+ #
302
316
  # @param currency [Symbol, Dodopayments::Models::Price::RecurringPrice::Currency]
303
- # @param discount [Float]
304
- # @param payment_frequency_count [Integer]
317
+ #
318
+ # @param discount [Float] Discount applied to the price, represented as a percentage (0 to 100).
319
+ #
320
+ # @param payment_frequency_count [Integer] Number of units for the payment frequency. ...
321
+ #
305
322
  # @param payment_frequency_interval [Symbol, Dodopayments::Models::TimeInterval]
306
- # @param price [Integer]
307
- # @param purchasing_power_parity [Boolean]
308
- # @param subscription_period_count [Integer]
323
+ #
324
+ # @param price [Integer] The payment amount. Represented in the lowest denomination of the currency (e.g.
325
+ # ...
326
+ #
327
+ # @param purchasing_power_parity [Boolean] Indicates if purchasing power parity adjustments are applied to the price. ...
328
+ #
329
+ # @param subscription_period_count [Integer] Number of units for the subscription period. ...
330
+ #
309
331
  # @param subscription_period_interval [Symbol, Dodopayments::Models::TimeInterval]
310
- # @param tax_inclusive [Boolean, nil]
311
- # @param trial_period_days [Integer]
332
+ #
333
+ # @param tax_inclusive [Boolean, nil] Indicates if the price is tax inclusive
334
+ #
335
+ # @param trial_period_days [Integer] Number of days for the trial period. A value of `0` indicates no trial period.
336
+ #
312
337
  # @param type [Symbol, :recurring_price]
313
338
 
314
339
  # @see Dodopayments::Models::Price::RecurringPrice#currency
@@ -94,21 +94,39 @@ module Dodopayments
94
94
  optional :name, String, nil?: true
95
95
 
96
96
  # @!method initialize(business_id:, created_at:, is_recurring:, license_key_enabled:, price:, product_id:, tax_category:, updated_at:, addons: nil, description: nil, image: nil, license_key_activation_message: nil, license_key_activations_limit: nil, license_key_duration: nil, name: nil)
97
- # @param business_id [String]
98
- # @param created_at [Time]
99
- # @param is_recurring [Boolean]
100
- # @param license_key_enabled [Boolean]
97
+ # Some parameter documentations has been truncated, see
98
+ # {Dodopayments::Models::Product} for more details.
99
+ #
100
+ # @param business_id [String] Unique identifier for the business to which the product belongs.
101
+ #
102
+ # @param created_at [Time] Timestamp when the product was created.
103
+ #
104
+ # @param is_recurring [Boolean] Indicates if the product is recurring (e.g., subscriptions).
105
+ #
106
+ # @param license_key_enabled [Boolean] Indicates whether the product requires a license key.
107
+ #
101
108
  # @param price [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice]
102
- # @param product_id [String]
103
- # @param tax_category [Symbol, Dodopayments::Models::Product::TaxCategory]
104
- # @param updated_at [Time]
105
- # @param addons [Array<String>, nil]
106
- # @param description [String, nil]
107
- # @param image [String, nil]
108
- # @param license_key_activation_message [String, nil]
109
- # @param license_key_activations_limit [Integer, nil]
109
+ #
110
+ # @param product_id [String] Unique identifier for the product.
111
+ #
112
+ # @param tax_category [Symbol, Dodopayments::Models::Product::TaxCategory] Represents the different categories of taxation applicable to various products a
113
+ # ...
114
+ #
115
+ # @param updated_at [Time] Timestamp when the product was last updated.
116
+ #
117
+ # @param addons [Array<String>, nil] Available Addons for subscription products
118
+ #
119
+ # @param description [String, nil] Description of the product, optional.
120
+ #
121
+ # @param image [String, nil] URL of the product image, optional.
122
+ #
123
+ # @param license_key_activation_message [String, nil] Message sent upon license key activation, if applicable.
124
+ #
125
+ # @param license_key_activations_limit [Integer, nil] Limit on the number of activations for the license key, if enabled.
126
+ #
110
127
  # @param license_key_duration [Dodopayments::Models::LicenseKeyDuration, nil]
111
- # @param name [String, nil]
128
+ #
129
+ # @param name [String, nil] Name of the product, optional.
112
130
 
113
131
  # Represents the different categories of taxation applicable to various products
114
132
  # and services.
@@ -61,15 +61,28 @@ module Dodopayments
61
61
  optional :name, String, nil?: true
62
62
 
63
63
  # @!method initialize(price:, tax_category:, addons: nil, description: nil, license_key_activation_message: nil, license_key_activations_limit: nil, license_key_duration: nil, license_key_enabled: nil, name: nil, request_options: {})
64
+ # Some parameter documentations has been truncated, see
65
+ # {Dodopayments::Models::ProductCreateParams} for more details.
66
+ #
64
67
  # @param price [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice]
65
- # @param tax_category [Symbol, Dodopayments::Models::ProductCreateParams::TaxCategory]
66
- # @param addons [Array<String>, nil]
67
- # @param description [String, nil]
68
- # @param license_key_activation_message [String, nil]
69
- # @param license_key_activations_limit [Integer, nil]
68
+ #
69
+ # @param tax_category [Symbol, Dodopayments::Models::ProductCreateParams::TaxCategory] Represents the different categories of taxation applicable to various products a
70
+ # ...
71
+ #
72
+ # @param addons [Array<String>, nil] Addons available for subscription product
73
+ #
74
+ # @param description [String, nil] Optional description of the product
75
+ #
76
+ # @param license_key_activation_message [String, nil] Optional message displayed during license key activation
77
+ #
78
+ # @param license_key_activations_limit [Integer, nil] The number of times the license key can be activated. ...
79
+ #
70
80
  # @param license_key_duration [Dodopayments::Models::LicenseKeyDuration, nil]
71
- # @param license_key_enabled [Boolean, nil]
72
- # @param name [String, nil]
81
+ #
82
+ # @param license_key_enabled [Boolean, nil] When true, generates and sends a license key to your customer. ...
83
+ #
84
+ # @param name [String, nil] Optional name of the product
85
+ #
73
86
  # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
74
87
 
75
88
  # Represents the different categories of taxation applicable to various products
@@ -36,10 +36,17 @@ module Dodopayments
36
36
  optional :recurring, Dodopayments::Internal::Type::Boolean, nil?: true
37
37
 
38
38
  # @!method initialize(archived: nil, page_number: nil, page_size: nil, recurring: nil, request_options: {})
39
- # @param archived [Boolean]
40
- # @param page_number [Integer, nil]
41
- # @param page_size [Integer, nil]
42
- # @param recurring [Boolean, nil]
39
+ # Some parameter documentations has been truncated, see
40
+ # {Dodopayments::Models::ProductListParams} for more details.
41
+ #
42
+ # @param archived [Boolean] List archived products
43
+ #
44
+ # @param page_number [Integer, nil] Page number default is 0
45
+ #
46
+ # @param page_size [Integer, nil] Page size default is 10 max is 100
47
+ #
48
+ # @param recurring [Boolean, nil] Filter products by pricing type: ...
49
+ #
43
50
  # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
44
51
  end
45
52
  end
@@ -91,19 +91,35 @@ module Dodopayments
91
91
  optional :tax_inclusive, Dodopayments::Internal::Type::Boolean, nil?: true
92
92
 
93
93
  # @!method initialize(business_id:, created_at:, is_recurring:, product_id:, tax_category:, updated_at:, currency: nil, description: nil, image: nil, name: nil, price: nil, price_detail: nil, tax_inclusive: nil)
94
- # @param business_id [String]
95
- # @param created_at [Time]
96
- # @param is_recurring [Boolean]
97
- # @param product_id [String]
98
- # @param tax_category [Symbol, Dodopayments::Models::ProductListResponse::TaxCategory]
99
- # @param updated_at [Time]
94
+ # Some parameter documentations has been truncated, see
95
+ # {Dodopayments::Models::ProductListResponse} for more details.
96
+ #
97
+ # @param business_id [String] Unique identifier for the business to which the product belongs.
98
+ #
99
+ # @param created_at [Time] Timestamp when the product was created.
100
+ #
101
+ # @param is_recurring [Boolean] Indicates if the product is recurring (e.g., subscriptions).
102
+ #
103
+ # @param product_id [String] Unique identifier for the product.
104
+ #
105
+ # @param tax_category [Symbol, Dodopayments::Models::ProductListResponse::TaxCategory] Represents the different categories of taxation applicable to various products a
106
+ # ...
107
+ #
108
+ # @param updated_at [Time] Timestamp when the product was last updated.
109
+ #
100
110
  # @param currency [Symbol, Dodopayments::Models::ProductListResponse::Currency, nil]
101
- # @param description [String, nil]
102
- # @param image [String, nil]
103
- # @param name [String, nil]
104
- # @param price [Integer, nil]
111
+ #
112
+ # @param description [String, nil] Description of the product, optional.
113
+ #
114
+ # @param image [String, nil] URL of the product image, optional.
115
+ #
116
+ # @param name [String, nil] Name of the product, optional.
117
+ #
118
+ # @param price [Integer, nil] Price of the product, optional. ...
119
+ #
105
120
  # @param price_detail [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, nil]
106
- # @param tax_inclusive [Boolean, nil]
121
+ #
122
+ # @param tax_inclusive [Boolean, nil] Indicates if the price is tax inclusive
107
123
 
108
124
  # Represents the different categories of taxation applicable to various products
109
125
  # and services.
@@ -76,16 +76,30 @@ module Dodopayments
76
76
  optional :tax_category, enum: -> { Dodopayments::Models::ProductUpdateParams::TaxCategory }, nil?: true
77
77
 
78
78
  # @!method initialize(addons: nil, description: nil, image_id: nil, license_key_activation_message: nil, license_key_activations_limit: nil, license_key_duration: nil, license_key_enabled: nil, name: nil, price: nil, tax_category: nil, request_options: {})
79
- # @param addons [Array<String>, nil]
80
- # @param description [String, nil]
81
- # @param image_id [String, nil]
82
- # @param license_key_activation_message [String, nil]
83
- # @param license_key_activations_limit [Integer, nil]
79
+ # Some parameter documentations has been truncated, see
80
+ # {Dodopayments::Models::ProductUpdateParams} for more details.
81
+ #
82
+ # @param addons [Array<String>, nil] Available Addons for subscription products
83
+ #
84
+ # @param description [String, nil] Description of the product, optional and must be at most 1000 characters.
85
+ #
86
+ # @param image_id [String, nil] Product image id after its uploaded to S3
87
+ #
88
+ # @param license_key_activation_message [String, nil] Message sent to the customer upon license key activation. ...
89
+ #
90
+ # @param license_key_activations_limit [Integer, nil] Limit for the number of activations for the license key. ...
91
+ #
84
92
  # @param license_key_duration [Dodopayments::Models::LicenseKeyDuration, nil]
85
- # @param license_key_enabled [Boolean, nil]
86
- # @param name [String, nil]
93
+ #
94
+ # @param license_key_enabled [Boolean, nil] Whether the product requires a license key. ...
95
+ #
96
+ # @param name [String, nil] Name of the product, optional and must be at most 100 characters.
97
+ #
87
98
  # @param price [Dodopayments::Models::Price::OneTimePrice, Dodopayments::Models::Price::RecurringPrice, nil]
88
- # @param tax_category [Symbol, Dodopayments::Models::ProductUpdateParams::TaxCategory, nil]
99
+ #
100
+ # @param tax_category [Symbol, Dodopayments::Models::ProductUpdateParams::TaxCategory, nil] Represents the different categories of taxation applicable to various products a
101
+ # ...
102
+ #
89
103
  # @param request_options [Dodopayments::RequestOptions, Hash{Symbol=>Object}]
90
104
 
91
105
  # Represents the different categories of taxation applicable to various products