stripe 12.5.0 → 15.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (688) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +197 -9
  3. data/Gemfile +4 -0
  4. data/Makefile +2 -0
  5. data/OPENAPI_VERSION +1 -1
  6. data/README.md +48 -13
  7. data/Rakefile +0 -5
  8. data/VERSION +1 -1
  9. data/examples/README.md +16 -0
  10. data/examples/example_template.rb +36 -0
  11. data/examples/meter_event_stream.rb +57 -0
  12. data/examples/thinevent_webhook_handler.rb +39 -0
  13. data/justfile +43 -0
  14. data/lib/stripe/api_operations/nested_resource.rb +1 -21
  15. data/lib/stripe/api_operations/request.rb +20 -69
  16. data/lib/stripe/api_operations/save.rb +5 -3
  17. data/lib/stripe/api_operations/singleton_save.rb +6 -2
  18. data/lib/stripe/api_requestor.rb +1136 -0
  19. data/lib/stripe/api_resource.rb +38 -17
  20. data/lib/stripe/api_version.rb +1 -1
  21. data/lib/stripe/connection_manager.rb +1 -1
  22. data/lib/stripe/errors.rb +8 -9
  23. data/lib/stripe/event_types.rb +14 -0
  24. data/lib/stripe/events/v1_billing_meter_error_report_triggered_event.rb +23 -0
  25. data/lib/stripe/events/v1_billing_meter_no_meter_found_event.rb +13 -0
  26. data/lib/stripe/list_object.rb +2 -3
  27. data/lib/stripe/oauth.rb +8 -15
  28. data/lib/stripe/object_types.rb +26 -3
  29. data/lib/stripe/request_options.rb +129 -0
  30. data/lib/stripe/request_params.rb +24 -0
  31. data/lib/stripe/resources/account.rb +4642 -8
  32. data/lib/stripe/resources/account_link.rb +54 -0
  33. data/lib/stripe/resources/account_session.rb +739 -0
  34. data/lib/stripe/resources/apple_pay_domain.rb +58 -9
  35. data/lib/stripe/resources/application.rb +20 -0
  36. data/lib/stripe/resources/application_fee.rb +89 -2
  37. data/lib/stripe/resources/application_fee_refund.rb +17 -0
  38. data/lib/stripe/resources/apps/secret.rb +143 -2
  39. data/lib/stripe/resources/balance.rb +122 -0
  40. data/lib/stripe/resources/balance_transaction.rb +105 -2
  41. data/lib/stripe/resources/bank_account.rb +85 -3
  42. data/lib/stripe/resources/billing/alert.rb +137 -2
  43. data/lib/stripe/resources/billing/alert_triggered.rb +26 -0
  44. data/lib/stripe/resources/billing/credit_balance_summary.rb +54 -0
  45. data/lib/stripe/resources/billing/credit_balance_transaction.rb +133 -0
  46. data/lib/stripe/resources/billing/credit_grant.rb +307 -0
  47. data/lib/stripe/resources/billing/meter.rb +180 -9
  48. data/lib/stripe/resources/billing/meter_event.rb +37 -3
  49. data/lib/stripe/resources/billing/meter_event_adjustment.rb +44 -1
  50. data/lib/stripe/resources/billing/meter_event_summary.rb +17 -0
  51. data/lib/stripe/resources/billing_portal/configuration.rb +557 -4
  52. data/lib/stripe/resources/billing_portal/session.rb +271 -0
  53. data/lib/stripe/resources/capability.rb +84 -0
  54. data/lib/stripe/resources/card.rb +78 -1
  55. data/lib/stripe/resources/cash_balance.rb +17 -0
  56. data/lib/stripe/resources/charge.rb +1616 -4
  57. data/lib/stripe/resources/checkout/session.rb +3534 -10
  58. data/lib/stripe/resources/climate/order.rb +171 -4
  59. data/lib/stripe/resources/climate/product.rb +49 -2
  60. data/lib/stripe/resources/climate/supplier.rb +47 -2
  61. data/lib/stripe/resources/confirmation_token.rb +1448 -0
  62. data/lib/stripe/resources/connect_collection_transfer.rb +24 -0
  63. data/lib/stripe/resources/country_spec.rb +56 -2
  64. data/lib/stripe/resources/coupon.rb +195 -6
  65. data/lib/stripe/resources/credit_note.rb +641 -2
  66. data/lib/stripe/resources/credit_note_line_item.rb +67 -0
  67. data/lib/stripe/resources/customer.rb +832 -9
  68. data/lib/stripe/resources/customer_balance_transaction.rb +29 -0
  69. data/lib/stripe/resources/customer_cash_balance_transaction.rb +109 -0
  70. data/lib/stripe/resources/customer_session.rb +163 -0
  71. data/lib/stripe/resources/discount.rb +29 -0
  72. data/lib/stripe/resources/dispute.rb +614 -4
  73. data/lib/stripe/resources/entitlements/active_entitlement.rb +39 -2
  74. data/lib/stripe/resources/entitlements/active_entitlement_summary.rb +23 -0
  75. data/lib/stripe/resources/entitlements/feature.rb +83 -2
  76. data/lib/stripe/resources/ephemeral_key.rb +23 -2
  77. data/lib/stripe/resources/event.rb +92 -2
  78. data/lib/stripe/resources/exchange_rate.rb +26 -2
  79. data/lib/stripe/resources/file.rb +123 -15
  80. data/lib/stripe/resources/file_link.rb +107 -4
  81. data/lib/stripe/resources/financial_connections/account.rb +239 -2
  82. data/lib/stripe/resources/financial_connections/account_owner.rb +17 -0
  83. data/lib/stripe/resources/financial_connections/account_ownership.rb +9 -0
  84. data/lib/stripe/resources/financial_connections/session.rb +95 -0
  85. data/lib/stripe/resources/financial_connections/transaction.rb +94 -2
  86. data/lib/stripe/resources/forwarding/request.rb +158 -2
  87. data/lib/stripe/resources/funding_instructions.rb +308 -0
  88. data/lib/stripe/resources/identity/verification_report.rb +259 -2
  89. data/lib/stripe/resources/identity/verification_session.rb +356 -4
  90. data/lib/stripe/resources/invoice.rb +3210 -27
  91. data/lib/stripe/resources/invoice_item.rb +406 -6
  92. data/lib/stripe/resources/invoice_line_item.rb +356 -3
  93. data/lib/stripe/resources/invoice_payment.rb +105 -0
  94. data/lib/stripe/resources/invoice_rendering_template.rb +120 -0
  95. data/lib/stripe/resources/issuing/authorization.rb +1132 -6
  96. data/lib/stripe/resources/issuing/card.rb +682 -5
  97. data/lib/stripe/resources/issuing/cardholder.rb +653 -5
  98. data/lib/stripe/resources/issuing/dispute.rb +785 -4
  99. data/lib/stripe/resources/issuing/personalization_design.rb +280 -4
  100. data/lib/stripe/resources/issuing/physical_bundle.rb +56 -2
  101. data/lib/stripe/resources/issuing/token.rb +170 -4
  102. data/lib/stripe/resources/issuing/transaction.rb +916 -4
  103. data/lib/stripe/resources/line_item.rb +47 -0
  104. data/lib/stripe/resources/login_link.rb +7 -0
  105. data/lib/stripe/resources/mandate.rb +142 -0
  106. data/lib/stripe/resources/payment_intent.rb +8660 -4
  107. data/lib/stripe/resources/payment_link.rb +1636 -4
  108. data/lib/stripe/resources/payment_method.rb +1546 -4
  109. data/lib/stripe/resources/payment_method_configuration.rb +2780 -4
  110. data/lib/stripe/resources/payment_method_domain.rb +154 -10
  111. data/lib/stripe/resources/payout.rb +213 -4
  112. data/lib/stripe/resources/person.rb +264 -1
  113. data/lib/stripe/resources/plan.rb +308 -6
  114. data/lib/stripe/resources/price.rb +609 -5
  115. data/lib/stripe/resources/product.rb +474 -2
  116. data/lib/stripe/resources/product_feature.rb +12 -0
  117. data/lib/stripe/resources/promotion_code.rb +216 -4
  118. data/lib/stripe/resources/quote.rb +927 -10
  119. data/lib/stripe/resources/radar/early_fraud_warning.rb +70 -2
  120. data/lib/stripe/resources/radar/value_list.rb +122 -6
  121. data/lib/stripe/resources/radar/value_list_item.rb +90 -4
  122. data/lib/stripe/resources/refund.rb +396 -4
  123. data/lib/stripe/resources/reporting/report_run.rb +143 -2
  124. data/lib/stripe/resources/reporting/report_type.rb +29 -2
  125. data/lib/stripe/resources/reserve_transaction.rb +22 -0
  126. data/lib/stripe/resources/reversal.rb +21 -0
  127. data/lib/stripe/resources/review.rb +101 -2
  128. data/lib/stripe/resources/setup_attempt.rb +370 -2
  129. data/lib/stripe/resources/setup_intent.rb +3477 -4
  130. data/lib/stripe/resources/shipping_rate.rb +254 -4
  131. data/lib/stripe/resources/sigma/scheduled_query_run.rb +47 -2
  132. data/lib/stripe/resources/source.rb +1203 -4
  133. data/lib/stripe/resources/source_mandate_notification.rb +66 -0
  134. data/lib/stripe/resources/source_transaction.rb +85 -0
  135. data/lib/stripe/resources/subscription.rb +1697 -11
  136. data/lib/stripe/resources/subscription_item.rb +319 -11
  137. data/lib/stripe/resources/subscription_schedule.rb +1285 -4
  138. data/lib/stripe/resources/tax/calculation.rb +378 -0
  139. data/lib/stripe/resources/tax/calculation_line_item.rb +56 -0
  140. data/lib/stripe/resources/tax/registration.rb +2375 -2
  141. data/lib/stripe/resources/tax/settings.rb +117 -0
  142. data/lib/stripe/resources/tax/transaction.rb +258 -0
  143. data/lib/stripe/resources/tax/transaction_line_item.rb +31 -0
  144. data/lib/stripe/resources/tax_code.rb +28 -2
  145. data/lib/stripe/resources/tax_deducted_at_source.rb +22 -0
  146. data/lib/stripe/resources/tax_id.rb +114 -2
  147. data/lib/stripe/resources/tax_rate.rb +197 -6
  148. data/lib/stripe/resources/terminal/configuration.rb +1266 -6
  149. data/lib/stripe/resources/terminal/connection_token.rb +18 -0
  150. data/lib/stripe/resources/terminal/location.rb +172 -6
  151. data/lib/stripe/resources/terminal/reader.rb +433 -6
  152. data/lib/stripe/resources/test_helpers/test_clock.rb +81 -4
  153. data/lib/stripe/resources/token.rb +1160 -1
  154. data/lib/stripe/resources/topup.rb +169 -4
  155. data/lib/stripe/resources/transfer.rb +148 -4
  156. data/lib/stripe/resources/treasury/credit_reversal.rb +85 -2
  157. data/lib/stripe/resources/treasury/debit_reversal.rb +96 -2
  158. data/lib/stripe/resources/treasury/financial_account.rb +749 -5
  159. data/lib/stripe/resources/treasury/financial_account_features.rb +189 -0
  160. data/lib/stripe/resources/treasury/inbound_transfer.rb +231 -3
  161. data/lib/stripe/resources/treasury/outbound_payment.rb +491 -3
  162. data/lib/stripe/resources/treasury/outbound_transfer.rb +346 -3
  163. data/lib/stripe/resources/treasury/received_credit.rb +239 -2
  164. data/lib/stripe/resources/treasury/received_debit.rb +198 -2
  165. data/lib/stripe/resources/treasury/transaction.rb +169 -2
  166. data/lib/stripe/resources/treasury/transaction_entry.rb +150 -2
  167. data/lib/stripe/resources/v2/amount.rb +9 -0
  168. data/lib/stripe/resources/v2/billing/meter_event.rb +34 -0
  169. data/lib/stripe/resources/v2/billing/meter_event_adjustment.rb +36 -0
  170. data/lib/stripe/resources/v2/billing/meter_event_session.rb +29 -0
  171. data/lib/stripe/resources/v2/event.rb +41 -0
  172. data/lib/stripe/resources/v2/event_destination.rb +73 -0
  173. data/lib/stripe/resources/webhook_endpoint.rb +119 -11
  174. data/lib/stripe/resources.rb +19 -2
  175. data/lib/stripe/search_result_object.rb +1 -1
  176. data/lib/stripe/services/account_capability_service.rb +71 -0
  177. data/lib/stripe/services/account_external_account_service.rb +318 -0
  178. data/lib/stripe/services/account_link_service.rb +63 -0
  179. data/lib/stripe/services/account_login_link_service.rb +28 -0
  180. data/lib/stripe/services/account_person_service.rb +936 -0
  181. data/lib/stripe/services/account_service.rb +4100 -0
  182. data/lib/stripe/services/account_session_service.rb +501 -0
  183. data/lib/stripe/services/apple_pay_domain_service.rb +101 -0
  184. data/lib/stripe/services/application_fee_refund_service.rb +114 -0
  185. data/lib/stripe/services/application_fee_service.rb +92 -0
  186. data/lib/stripe/services/apps/secret_service.rb +168 -0
  187. data/lib/stripe/services/apps_service.rb +13 -0
  188. data/lib/stripe/services/balance_service.rb +21 -0
  189. data/lib/stripe/services/balance_transaction_service.rb +101 -0
  190. data/lib/stripe/services/billing/alert_service.rb +187 -0
  191. data/lib/stripe/services/billing/credit_balance_summary_service.rb +67 -0
  192. data/lib/stripe/services/billing/credit_balance_transaction_service.rb +70 -0
  193. data/lib/stripe/services/billing/credit_grant_service.rb +240 -0
  194. data/lib/stripe/services/billing/meter_event_adjustment_service.rb +45 -0
  195. data/lib/stripe/services/billing/meter_event_service.rb +40 -0
  196. data/lib/stripe/services/billing/meter_event_summary_service.rb +58 -0
  197. data/lib/stripe/services/billing/meter_service.rb +211 -0
  198. data/lib/stripe/services/billing_portal/configuration_service.rb +496 -0
  199. data/lib/stripe/services/billing_portal/session_service.rb +192 -0
  200. data/lib/stripe/services/billing_portal_service.rb +14 -0
  201. data/lib/stripe/services/billing_service.rb +20 -0
  202. data/lib/stripe/services/charge_service.rb +471 -0
  203. data/lib/stripe/services/checkout/session_line_item_service.rb +37 -0
  204. data/lib/stripe/services/checkout/session_service.rb +2466 -0
  205. data/lib/stripe/services/checkout_service.rb +13 -0
  206. data/lib/stripe/services/climate/order_service.rb +170 -0
  207. data/lib/stripe/services/climate/product_service.rb +57 -0
  208. data/lib/stripe/services/climate/supplier_service.rb +57 -0
  209. data/lib/stripe/services/climate_service.rb +15 -0
  210. data/lib/stripe/services/confirmation_token_service.rb +26 -0
  211. data/lib/stripe/services/country_spec_service.rb +55 -0
  212. data/lib/stripe/services/coupon_service.rb +203 -0
  213. data/lib/stripe/services/credit_note_line_item_service.rb +35 -0
  214. data/lib/stripe/services/credit_note_preview_lines_service.rb +169 -0
  215. data/lib/stripe/services/credit_note_service.rb +458 -0
  216. data/lib/stripe/services/customer_balance_transaction_service.rb +113 -0
  217. data/lib/stripe/services/customer_cash_balance_service.rb +57 -0
  218. data/lib/stripe/services/customer_cash_balance_transaction_service.rb +55 -0
  219. data/lib/stripe/services/customer_funding_instructions_service.rb +61 -0
  220. data/lib/stripe/services/customer_payment_method_service.rb +68 -0
  221. data/lib/stripe/services/customer_payment_source_service.rb +255 -0
  222. data/lib/stripe/services/customer_service.rb +666 -0
  223. data/lib/stripe/services/customer_session_service.rb +113 -0
  224. data/lib/stripe/services/customer_tax_id_service.rb +95 -0
  225. data/lib/stripe/services/dispute_service.rb +422 -0
  226. data/lib/stripe/services/entitlements/active_entitlement_service.rb +66 -0
  227. data/lib/stripe/services/entitlements/feature_service.rb +128 -0
  228. data/lib/stripe/services/entitlements_service.rb +14 -0
  229. data/lib/stripe/services/ephemeral_key_service.rb +64 -0
  230. data/lib/stripe/services/event_service.rb +87 -0
  231. data/lib/stripe/services/exchange_rate_service.rb +55 -0
  232. data/lib/stripe/services/file_link_service.rb +132 -0
  233. data/lib/stripe/services/file_service.rb +124 -0
  234. data/lib/stripe/services/financial_connections/account_owner_service.rb +46 -0
  235. data/lib/stripe/services/financial_connections/account_service.rb +177 -0
  236. data/lib/stripe/services/financial_connections/session_service.rb +98 -0
  237. data/lib/stripe/services/financial_connections/transaction_service.rb +100 -0
  238. data/lib/stripe/services/financial_connections_service.rb +15 -0
  239. data/lib/stripe/services/forwarding/request_service.rb +147 -0
  240. data/lib/stripe/services/forwarding_service.rb +13 -0
  241. data/lib/stripe/services/identity/verification_report_service.rb +95 -0
  242. data/lib/stripe/services/identity/verification_session_service.rb +337 -0
  243. data/lib/stripe/services/identity_service.rb +14 -0
  244. data/lib/stripe/services/invoice_item_service.rb +395 -0
  245. data/lib/stripe/services/invoice_line_item_service.rb +252 -0
  246. data/lib/stripe/services/invoice_payment_service.rb +83 -0
  247. data/lib/stripe/services/invoice_rendering_template_service.rb +101 -0
  248. data/lib/stripe/services/invoice_service.rb +2831 -0
  249. data/lib/stripe/services/issuing/authorization_service.rb +169 -0
  250. data/lib/stripe/services/issuing/card_service.rb +507 -0
  251. data/lib/stripe/services/issuing/cardholder_service.rb +577 -0
  252. data/lib/stripe/services/issuing/dispute_service.rb +696 -0
  253. data/lib/stripe/services/issuing/personalization_design_service.rb +245 -0
  254. data/lib/stripe/services/issuing/physical_bundle_service.rb +70 -0
  255. data/lib/stripe/services/issuing/token_service.rb +114 -0
  256. data/lib/stripe/services/issuing/transaction_service.rb +118 -0
  257. data/lib/stripe/services/issuing_service.rb +20 -0
  258. data/lib/stripe/services/mandate_service.rb +26 -0
  259. data/lib/stripe/services/oauth_service.rb +63 -0
  260. data/lib/stripe/services/payment_intent_service.rb +7258 -0
  261. data/lib/stripe/services/payment_link_line_item_service.rb +35 -0
  262. data/lib/stripe/services/payment_link_service.rb +1333 -0
  263. data/lib/stripe/services/payment_method_configuration_service.rb +2054 -0
  264. data/lib/stripe/services/payment_method_domain_service.rb +142 -0
  265. data/lib/stripe/services/payment_method_service.rb +894 -0
  266. data/lib/stripe/services/payout_service.rb +225 -0
  267. data/lib/stripe/services/plan_service.rb +298 -0
  268. data/lib/stripe/services/price_service.rb +545 -0
  269. data/lib/stripe/services/product_feature_service.rb +92 -0
  270. data/lib/stripe/services/product_service.rb +495 -0
  271. data/lib/stripe/services/promotion_code_service.rb +228 -0
  272. data/lib/stripe/services/quote_computed_upfront_line_items_service.rb +35 -0
  273. data/lib/stripe/services/quote_line_item_service.rb +35 -0
  274. data/lib/stripe/services/quote_service.rb +703 -0
  275. data/lib/stripe/services/radar/early_fraud_warning_service.rb +93 -0
  276. data/lib/stripe/services/radar/value_list_item_service.rb +131 -0
  277. data/lib/stripe/services/radar/value_list_service.rb +166 -0
  278. data/lib/stripe/services/radar_service.rb +15 -0
  279. data/lib/stripe/services/refund_service.rb +200 -0
  280. data/lib/stripe/services/reporting/report_run_service.rb +147 -0
  281. data/lib/stripe/services/reporting/report_type_service.rb +48 -0
  282. data/lib/stripe/services/reporting_service.rb +14 -0
  283. data/lib/stripe/services/review_service.rb +89 -0
  284. data/lib/stripe/services/setup_attempt_service.rb +68 -0
  285. data/lib/stripe/services/setup_intent_service.rb +3268 -0
  286. data/lib/stripe/services/shipping_rate_service.rb +250 -0
  287. data/lib/stripe/services/sigma/scheduled_query_run_service.rb +57 -0
  288. data/lib/stripe/services/sigma_service.rb +13 -0
  289. data/lib/stripe/services/source_service.rb +665 -0
  290. data/lib/stripe/services/source_transaction_service.rb +35 -0
  291. data/lib/stripe/services/subscription_item_service.rb +346 -0
  292. data/lib/stripe/services/subscription_schedule_service.rb +1134 -0
  293. data/lib/stripe/services/subscription_service.rb +1539 -0
  294. data/lib/stripe/services/tax/calculation_line_item_service.rb +37 -0
  295. data/lib/stripe/services/tax/calculation_service.rb +242 -0
  296. data/lib/stripe/services/tax/registration_service.rb +1618 -0
  297. data/lib/stripe/services/tax/settings_service.rb +104 -0
  298. data/lib/stripe/services/tax/transaction_line_item_service.rb +37 -0
  299. data/lib/stripe/services/tax/transaction_service.rb +159 -0
  300. data/lib/stripe/services/tax_code_service.rb +49 -0
  301. data/lib/stripe/services/tax_id_service.rb +117 -0
  302. data/lib/stripe/services/tax_rate_service.rb +193 -0
  303. data/lib/stripe/services/tax_service.rb +16 -0
  304. data/lib/stripe/services/terminal/configuration_service.rb +1060 -0
  305. data/lib/stripe/services/terminal/connection_token_service.rb +31 -0
  306. data/lib/stripe/services/terminal/location_service.rb +208 -0
  307. data/lib/stripe/services/terminal/reader_service.rb +384 -0
  308. data/lib/stripe/services/terminal_service.rb +16 -0
  309. data/lib/stripe/services/test_helpers/confirmation_token_service.rb +661 -0
  310. data/lib/stripe/services/test_helpers/customer_service.rb +37 -0
  311. data/lib/stripe/services/test_helpers/issuing/authorization_service.rb +832 -0
  312. data/lib/stripe/services/test_helpers/issuing/card_service.rb +110 -0
  313. data/lib/stripe/services/test_helpers/issuing/personalization_design_service.rb +84 -0
  314. data/lib/stripe/services/test_helpers/issuing/transaction_service.rb +675 -0
  315. data/lib/stripe/services/test_helpers/issuing_service.rb +19 -0
  316. data/lib/stripe/services/test_helpers/refund_service.rb +28 -0
  317. data/lib/stripe/services/test_helpers/terminal/reader_service.rb +65 -0
  318. data/lib/stripe/services/test_helpers/terminal_service.rb +15 -0
  319. data/lib/stripe/services/test_helpers/test_clock_service.rb +120 -0
  320. data/lib/stripe/services/test_helpers/treasury/inbound_transfer_service.rb +81 -0
  321. data/lib/stripe/services/test_helpers/treasury/outbound_payment_service.rb +141 -0
  322. data/lib/stripe/services/test_helpers/treasury/outbound_transfer_service.rb +141 -0
  323. data/lib/stripe/services/test_helpers/treasury/received_credit_service.rb +81 -0
  324. data/lib/stripe/services/test_helpers/treasury/received_debit_service.rb +81 -0
  325. data/lib/stripe/services/test_helpers/treasury_service.rb +19 -0
  326. data/lib/stripe/services/test_helpers_service.rb +19 -0
  327. data/lib/stripe/services/token_service.rb +1163 -0
  328. data/lib/stripe/services/topup_service.rb +191 -0
  329. data/lib/stripe/services/transfer_reversal_service.rb +122 -0
  330. data/lib/stripe/services/transfer_service.rb +166 -0
  331. data/lib/stripe/services/treasury/credit_reversal_service.rb +100 -0
  332. data/lib/stripe/services/treasury/debit_reversal_service.rb +104 -0
  333. data/lib/stripe/services/treasury/financial_account_features_service.rb +196 -0
  334. data/lib/stripe/services/treasury/financial_account_service.rb +554 -0
  335. data/lib/stripe/services/treasury/inbound_transfer_service.rb +140 -0
  336. data/lib/stripe/services/treasury/outbound_payment_service.rb +310 -0
  337. data/lib/stripe/services/treasury/outbound_transfer_service.rb +176 -0
  338. data/lib/stripe/services/treasury/received_credit_service.rb +82 -0
  339. data/lib/stripe/services/treasury/received_debit_service.rb +70 -0
  340. data/lib/stripe/services/treasury/transaction_entry_service.rb +117 -0
  341. data/lib/stripe/services/treasury/transaction_service.rb +125 -0
  342. data/lib/stripe/services/treasury_service.rb +22 -0
  343. data/lib/stripe/services/v1_services.rb +90 -0
  344. data/lib/stripe/services/v2/billing/meter_event_adjustment_service.rb +44 -0
  345. data/lib/stripe/services/v2/billing/meter_event_service.rb +46 -0
  346. data/lib/stripe/services/v2/billing/meter_event_session_service.rb +24 -0
  347. data/lib/stripe/services/v2/billing/meter_event_stream_service.rb +56 -0
  348. data/lib/stripe/services/v2/billing_service.rb +18 -0
  349. data/lib/stripe/services/v2/core/event_destination_service.rb +241 -0
  350. data/lib/stripe/services/v2/core/event_service.rb +49 -0
  351. data/lib/stripe/services/v2/core_service.rb +16 -0
  352. data/lib/stripe/services/v2_services.rb +14 -0
  353. data/lib/stripe/services/webhook_endpoint_service.rb +157 -0
  354. data/lib/stripe/services.rb +180 -0
  355. data/lib/stripe/singleton_api_resource.rb +1 -18
  356. data/lib/stripe/stripe_client.rb +53 -1031
  357. data/lib/stripe/stripe_configuration.rb +52 -19
  358. data/lib/stripe/stripe_object.rb +54 -20
  359. data/lib/stripe/stripe_service.rb +32 -0
  360. data/lib/stripe/thin_event.rb +37 -0
  361. data/lib/stripe/util.rb +78 -37
  362. data/lib/stripe/v2_list_object.rb +84 -0
  363. data/lib/stripe/version.rb +1 -1
  364. data/lib/stripe/webhook.rb +1 -1
  365. data/lib/stripe.rb +38 -25
  366. data/rbi/stripe/resources/account.rbi +4840 -0
  367. data/rbi/stripe/resources/account_link.rbi +74 -0
  368. data/rbi/stripe/resources/account_session.rbi +894 -0
  369. data/rbi/stripe/resources/apple_pay_domain.rbi +90 -0
  370. data/rbi/stripe/resources/application.rbi +20 -0
  371. data/rbi/stripe/resources/application_fee.rbi +118 -0
  372. data/rbi/stripe/resources/application_fee_refund.rbi +37 -0
  373. data/rbi/stripe/resources/apps/secret.rbi +195 -0
  374. data/rbi/stripe/resources/balance.rbi +180 -0
  375. data/rbi/stripe/resources/balance_transaction.rbi +144 -0
  376. data/rbi/stripe/resources/bank_account.rbi +127 -0
  377. data/rbi/stripe/resources/billing/alert.rbi +201 -0
  378. data/rbi/stripe/resources/billing/alert_triggered.rbi +28 -0
  379. data/rbi/stripe/resources/billing/credit_balance_summary.rbi +63 -0
  380. data/rbi/stripe/resources/billing/credit_balance_transaction.rbi +147 -0
  381. data/rbi/stripe/resources/billing/credit_grant.rbi +291 -0
  382. data/rbi/stripe/resources/billing/meter.rbi +226 -0
  383. data/rbi/stripe/resources/billing/meter_event.rbi +64 -0
  384. data/rbi/stripe/resources/billing/meter_event_adjustment.rbi +64 -0
  385. data/rbi/stripe/resources/billing/meter_event_summary.rbi +35 -0
  386. data/rbi/stripe/resources/billing_portal/configuration.rbi +645 -0
  387. data/rbi/stripe/resources/billing_portal/session.rbi +345 -0
  388. data/rbi/stripe/resources/capability.rbi +125 -0
  389. data/rbi/stripe/resources/card.rbi +125 -0
  390. data/rbi/stripe/resources/cash_balance.rbi +32 -0
  391. data/rbi/stripe/resources/charge.rbi +2054 -0
  392. data/rbi/stripe/resources/checkout/session.rbi +3951 -0
  393. data/rbi/stripe/resources/climate/order.rbi +245 -0
  394. data/rbi/stripe/resources/climate/product.rbi +75 -0
  395. data/rbi/stripe/resources/climate/supplier.rbi +72 -0
  396. data/rbi/stripe/resources/confirmation_token.rbi +1793 -0
  397. data/rbi/stripe/resources/connect_collection_transfer.rbi +26 -0
  398. data/rbi/stripe/resources/country_spec.rbi +85 -0
  399. data/rbi/stripe/resources/coupon.rbi +252 -0
  400. data/rbi/stripe/resources/credit_note.rbi +747 -0
  401. data/rbi/stripe/resources/credit_note_line_item.rbi +101 -0
  402. data/rbi/stripe/resources/customer.rbi +1009 -0
  403. data/rbi/stripe/resources/customer_balance_transaction.rbi +56 -0
  404. data/rbi/stripe/resources/customer_cash_balance_transaction.rbi +151 -0
  405. data/rbi/stripe/resources/customer_session.rbi +200 -0
  406. data/rbi/stripe/resources/discount.rbi +53 -0
  407. data/rbi/stripe/resources/dispute.rbi +761 -0
  408. data/rbi/stripe/resources/entitlements/active_entitlement.rbi +58 -0
  409. data/rbi/stripe/resources/entitlements/active_entitlement_summary.rbi +23 -0
  410. data/rbi/stripe/resources/entitlements/feature.rbi +117 -0
  411. data/rbi/stripe/resources/ephemeral_key.rbi +44 -0
  412. data/rbi/stripe/resources/event.rbi +146 -0
  413. data/rbi/stripe/resources/exchange_rate.rbi +66 -0
  414. data/rbi/stripe/resources/file.rbi +143 -0
  415. data/rbi/stripe/resources/file_link.rbi +141 -0
  416. data/rbi/stripe/resources/financial_connections/account.rbi +339 -0
  417. data/rbi/stripe/resources/financial_connections/account_owner.rbi +35 -0
  418. data/rbi/stripe/resources/financial_connections/account_ownership.rbi +23 -0
  419. data/rbi/stripe/resources/financial_connections/session.rbi +123 -0
  420. data/rbi/stripe/resources/financial_connections/transaction.rbi +124 -0
  421. data/rbi/stripe/resources/forwarding/request.rbi +216 -0
  422. data/rbi/stripe/resources/funding_instructions.rbi +437 -0
  423. data/rbi/stripe/resources/identity/verification_report.rbi +351 -0
  424. data/rbi/stripe/resources/identity/verification_session.rbi +517 -0
  425. data/rbi/stripe/resources/invoice.rbi +3733 -0
  426. data/rbi/stripe/resources/invoice_item.rbi +475 -0
  427. data/rbi/stripe/resources/invoice_line_item.rbi +432 -0
  428. data/rbi/stripe/resources/invoice_payment.rbi +114 -0
  429. data/rbi/stripe/resources/invoice_rendering_template.rbi +104 -0
  430. data/rbi/stripe/resources/issuing/authorization.rbi +1283 -0
  431. data/rbi/stripe/resources/issuing/card.rbi +741 -0
  432. data/rbi/stripe/resources/issuing/cardholder.rbi +744 -0
  433. data/rbi/stripe/resources/issuing/dispute.rbi +913 -0
  434. data/rbi/stripe/resources/issuing/personalization_design.rbi +338 -0
  435. data/rbi/stripe/resources/issuing/physical_bundle.rbi +79 -0
  436. data/rbi/stripe/resources/issuing/token.rbi +226 -0
  437. data/rbi/stripe/resources/issuing/transaction.rbi +1061 -0
  438. data/rbi/stripe/resources/line_item.rbi +72 -0
  439. data/rbi/stripe/resources/login_link.rbi +18 -0
  440. data/rbi/stripe/resources/mandate.rbi +187 -0
  441. data/rbi/stripe/resources/payment_intent.rbi +9731 -0
  442. data/rbi/stripe/resources/payment_link.rbi +1801 -0
  443. data/rbi/stripe/resources/payment_method.rbi +1822 -0
  444. data/rbi/stripe/resources/payment_method_configuration.rbi +3154 -0
  445. data/rbi/stripe/resources/payment_method_domain.rbi +212 -0
  446. data/rbi/stripe/resources/payout.rbi +300 -0
  447. data/rbi/stripe/resources/person.rbi +371 -0
  448. data/rbi/stripe/resources/plan.rbi +373 -0
  449. data/rbi/stripe/resources/price.rbi +694 -0
  450. data/rbi/stripe/resources/product.rbi +557 -0
  451. data/rbi/stripe/resources/product_feature.rbi +26 -0
  452. data/rbi/stripe/resources/promotion_code.rbi +261 -0
  453. data/rbi/stripe/resources/quote.rbi +1123 -0
  454. data/rbi/stripe/resources/radar/early_fraud_warning.rbi +98 -0
  455. data/rbi/stripe/resources/radar/value_list.rbi +170 -0
  456. data/rbi/stripe/resources/radar/value_list_item.rbi +131 -0
  457. data/rbi/stripe/resources/refund.rbi +516 -0
  458. data/rbi/stripe/resources/reporting/report_run.rbi +191 -0
  459. data/rbi/stripe/resources/reporting/report_type.rbi +57 -0
  460. data/rbi/stripe/resources/reserve_transaction.rbi +23 -0
  461. data/rbi/stripe/resources/reversal.rbi +51 -0
  462. data/rbi/stripe/resources/review.rbi +154 -0
  463. data/rbi/stripe/resources/setup_attempt.rbi +477 -0
  464. data/rbi/stripe/resources/setup_intent.rbi +3860 -0
  465. data/rbi/stripe/resources/shipping_rate.rbi +305 -0
  466. data/rbi/stripe/resources/sigma/scheduled_query_run.rbi +75 -0
  467. data/rbi/stripe/resources/source.rbi +1496 -0
  468. data/rbi/stripe/resources/source_mandate_notification.rbi +77 -0
  469. data/rbi/stripe/resources/source_transaction.rbi +127 -0
  470. data/rbi/stripe/resources/subscription.rbi +1964 -0
  471. data/rbi/stripe/resources/subscription_item.rbi +370 -0
  472. data/rbi/stripe/resources/subscription_schedule.rbi +1495 -0
  473. data/rbi/stripe/resources/tax/calculation.rbi +474 -0
  474. data/rbi/stripe/resources/tax/calculation_line_item.rbi +88 -0
  475. data/rbi/stripe/resources/tax/registration.rbi +2485 -0
  476. data/rbi/stripe/resources/tax/settings.rbi +141 -0
  477. data/rbi/stripe/resources/tax/transaction.rbi +351 -0
  478. data/rbi/stripe/resources/tax/transaction_line_item.rbi +54 -0
  479. data/rbi/stripe/resources/tax_code.rbi +44 -0
  480. data/rbi/stripe/resources/tax_deducted_at_source.rbi +23 -0
  481. data/rbi/stripe/resources/tax_id.rbi +167 -0
  482. data/rbi/stripe/resources/tax_rate.rbi +239 -0
  483. data/rbi/stripe/resources/terminal/configuration.rbi +1388 -0
  484. data/rbi/stripe/resources/terminal/connection_token.rbi +37 -0
  485. data/rbi/stripe/resources/terminal/location.rbi +224 -0
  486. data/rbi/stripe/resources/terminal/reader.rbi +587 -0
  487. data/rbi/stripe/resources/test_helpers/test_clock.rbi +134 -0
  488. data/rbi/stripe/resources/token.rbi +1217 -0
  489. data/rbi/stripe/resources/topup.rbi +222 -0
  490. data/rbi/stripe/resources/transfer.rbi +199 -0
  491. data/rbi/stripe/resources/treasury/credit_reversal.rbi +119 -0
  492. data/rbi/stripe/resources/treasury/debit_reversal.rbi +131 -0
  493. data/rbi/stripe/resources/treasury/financial_account.rbi +865 -0
  494. data/rbi/stripe/resources/treasury/financial_account_features.rbi +260 -0
  495. data/rbi/stripe/resources/treasury/inbound_transfer.rbi +295 -0
  496. data/rbi/stripe/resources/treasury/outbound_payment.rbi +592 -0
  497. data/rbi/stripe/resources/treasury/outbound_transfer.rbi +431 -0
  498. data/rbi/stripe/resources/treasury/received_credit.rbi +302 -0
  499. data/rbi/stripe/resources/treasury/received_debit.rbi +256 -0
  500. data/rbi/stripe/resources/treasury/transaction.rbi +215 -0
  501. data/rbi/stripe/resources/treasury/transaction_entry.rbi +192 -0
  502. data/rbi/stripe/resources/v2/amount.rbi +14 -0
  503. data/rbi/stripe/resources/v2/billing/meter_event.rbi +37 -0
  504. data/rbi/stripe/resources/v2/billing/meter_event_adjustment.rbi +41 -0
  505. data/rbi/stripe/resources/v2/billing/meter_event_session.rbi +31 -0
  506. data/rbi/stripe/resources/v2/event.rbi +48 -0
  507. data/rbi/stripe/resources/v2/event_destination.rbi +91 -0
  508. data/rbi/stripe/resources/webhook_endpoint.rbi +170 -0
  509. data/rbi/stripe/services/account_capability_service.rbi +51 -0
  510. data/rbi/stripe/services/account_external_account_service.rbi +306 -0
  511. data/rbi/stripe/services/account_link_service.rbi +58 -0
  512. data/rbi/stripe/services/account_login_link_service.rbi +22 -0
  513. data/rbi/stripe/services/account_person_service.rbi +923 -0
  514. data/rbi/stripe/services/account_service.rbi +4143 -0
  515. data/rbi/stripe/services/account_session_service.rbi +572 -0
  516. data/rbi/stripe/services/apple_pay_domain_service.rbi +78 -0
  517. data/rbi/stripe/services/application_fee_refund_service.rbi +93 -0
  518. data/rbi/stripe/services/application_fee_service.rbi +78 -0
  519. data/rbi/stripe/services/apps/secret_service.rbi +151 -0
  520. data/rbi/stripe/services/apps_service.rbi +9 -0
  521. data/rbi/stripe/services/balance_service.rbi +21 -0
  522. data/rbi/stripe/services/balance_transaction_service.rbi +93 -0
  523. data/rbi/stripe/services/billing/alert_service.rbi +152 -0
  524. data/rbi/stripe/services/billing/credit_balance_summary_service.rbi +68 -0
  525. data/rbi/stripe/services/billing/credit_balance_transaction_service.rbi +59 -0
  526. data/rbi/stripe/services/billing/credit_grant_service.rbi +211 -0
  527. data/rbi/stripe/services/billing/meter_event_adjustment_service.rbi +42 -0
  528. data/rbi/stripe/services/billing/meter_event_service.rbi +42 -0
  529. data/rbi/stripe/services/billing/meter_event_summary_service.rbi +54 -0
  530. data/rbi/stripe/services/billing/meter_service.rbi +163 -0
  531. data/rbi/stripe/services/billing_portal/configuration_service.rbi +511 -0
  532. data/rbi/stripe/services/billing_portal/session_service.rbi +204 -0
  533. data/rbi/stripe/services/billing_portal_service.rbi +10 -0
  534. data/rbi/stripe/services/billing_service.rbi +15 -0
  535. data/rbi/stripe/services/charge_service.rbi +448 -0
  536. data/rbi/stripe/services/checkout/session_line_item_service.rbi +33 -0
  537. data/rbi/stripe/services/checkout/session_service.rbi +2585 -0
  538. data/rbi/stripe/services/checkout_service.rbi +9 -0
  539. data/rbi/stripe/services/climate/order_service.rbi +142 -0
  540. data/rbi/stripe/services/climate/product_service.rbi +46 -0
  541. data/rbi/stripe/services/climate/supplier_service.rbi +46 -0
  542. data/rbi/stripe/services/climate_service.rbi +11 -0
  543. data/rbi/stripe/services/confirmation_token_service.rbi +20 -0
  544. data/rbi/stripe/services/country_spec_service.rbi +44 -0
  545. data/rbi/stripe/services/coupon_service.rbi +196 -0
  546. data/rbi/stripe/services/credit_note_line_item_service.rbi +31 -0
  547. data/rbi/stripe/services/credit_note_preview_lines_service.rbi +167 -0
  548. data/rbi/stripe/services/credit_note_service.rbi +416 -0
  549. data/rbi/stripe/services/customer_balance_transaction_service.rbi +92 -0
  550. data/rbi/stripe/services/customer_cash_balance_service.rbi +45 -0
  551. data/rbi/stripe/services/customer_cash_balance_transaction_service.rbi +44 -0
  552. data/rbi/stripe/services/customer_funding_instructions_service.rbi +59 -0
  553. data/rbi/stripe/services/customer_payment_method_service.rbi +57 -0
  554. data/rbi/stripe/services/customer_payment_source_service.rbi +232 -0
  555. data/rbi/stripe/services/customer_service.rbi +651 -0
  556. data/rbi/stripe/services/customer_session_service.rbi +116 -0
  557. data/rbi/stripe/services/customer_tax_id_service.rbi +72 -0
  558. data/rbi/stripe/services/dispute_service.rbi +424 -0
  559. data/rbi/stripe/services/entitlements/active_entitlement_service.rbi +55 -0
  560. data/rbi/stripe/services/entitlements/feature_service.rbi +107 -0
  561. data/rbi/stripe/services/entitlements_service.rbi +10 -0
  562. data/rbi/stripe/services/ephemeral_key_service.rbi +53 -0
  563. data/rbi/stripe/services/event_service.rbi +83 -0
  564. data/rbi/stripe/services/exchange_rate_service.rbi +44 -0
  565. data/rbi/stripe/services/file_link_service.rbi +124 -0
  566. data/rbi/stripe/services/file_service.rbi +116 -0
  567. data/rbi/stripe/services/financial_connections/account_owner_service.rbi +42 -0
  568. data/rbi/stripe/services/financial_connections/account_service.rbi +133 -0
  569. data/rbi/stripe/services/financial_connections/session_service.rbi +88 -0
  570. data/rbi/stripe/services/financial_connections/transaction_service.rbi +92 -0
  571. data/rbi/stripe/services/financial_connections_service.rbi +11 -0
  572. data/rbi/stripe/services/forwarding/request_service.rbi +134 -0
  573. data/rbi/stripe/services/forwarding_service.rbi +9 -0
  574. data/rbi/stripe/services/identity/verification_report_service.rbi +87 -0
  575. data/rbi/stripe/services/identity/verification_session_service.rbi +323 -0
  576. data/rbi/stripe/services/identity_service.rbi +10 -0
  577. data/rbi/stripe/services/invoice_item_service.rbi +368 -0
  578. data/rbi/stripe/services/invoice_line_item_service.rbi +259 -0
  579. data/rbi/stripe/services/invoice_payment_service.rbi +71 -0
  580. data/rbi/stripe/services/invoice_rendering_template_service.rbi +82 -0
  581. data/rbi/stripe/services/invoice_service.rbi +2920 -0
  582. data/rbi/stripe/services/issuing/authorization_service.rbi +146 -0
  583. data/rbi/stripe/services/issuing/card_service.rbi +495 -0
  584. data/rbi/stripe/services/issuing/cardholder_service.rbi +587 -0
  585. data/rbi/stripe/services/issuing/dispute_service.rbi +707 -0
  586. data/rbi/stripe/services/issuing/personalization_design_service.rbi +243 -0
  587. data/rbi/stripe/services/issuing/physical_bundle_service.rbi +59 -0
  588. data/rbi/stripe/services/issuing/token_service.rbi +99 -0
  589. data/rbi/stripe/services/issuing/transaction_service.rbi +105 -0
  590. data/rbi/stripe/services/issuing_service.rbi +16 -0
  591. data/rbi/stripe/services/mandate_service.rbi +20 -0
  592. data/rbi/stripe/services/payment_intent_service.rbi +7759 -0
  593. data/rbi/stripe/services/payment_link_line_item_service.rbi +31 -0
  594. data/rbi/stripe/services/payment_link_service.rbi +1352 -0
  595. data/rbi/stripe/services/payment_method_configuration_service.rbi +2211 -0
  596. data/rbi/stripe/services/payment_method_domain_service.rbi +112 -0
  597. data/rbi/stripe/services/payment_method_service.rbi +840 -0
  598. data/rbi/stripe/services/payout_service.rbi +205 -0
  599. data/rbi/stripe/services/plan_service.rbi +284 -0
  600. data/rbi/stripe/services/price_service.rbi +546 -0
  601. data/rbi/stripe/services/product_feature_service.rbi +69 -0
  602. data/rbi/stripe/services/product_service.rbi +479 -0
  603. data/rbi/stripe/services/promotion_code_service.rbi +214 -0
  604. data/rbi/stripe/services/quote_computed_upfront_line_items_service.rbi +31 -0
  605. data/rbi/stripe/services/quote_line_item_service.rbi +31 -0
  606. data/rbi/stripe/services/quote_service.rbi +686 -0
  607. data/rbi/stripe/services/radar/early_fraud_warning_service.rbi +85 -0
  608. data/rbi/stripe/services/radar/value_list_item_service.rbi +111 -0
  609. data/rbi/stripe/services/radar/value_list_service.rbi +143 -0
  610. data/rbi/stripe/services/radar_service.rbi +11 -0
  611. data/rbi/stripe/services/refund_service.rbi +185 -0
  612. data/rbi/stripe/services/reporting/report_run_service.rbi +135 -0
  613. data/rbi/stripe/services/reporting/report_type_service.rbi +35 -0
  614. data/rbi/stripe/services/reporting_service.rbi +10 -0
  615. data/rbi/stripe/services/review_service.rbi +84 -0
  616. data/rbi/stripe/services/setup_attempt_service.rbi +65 -0
  617. data/rbi/stripe/services/setup_intent_service.rbi +3596 -0
  618. data/rbi/stripe/services/shipping_rate_service.rbi +241 -0
  619. data/rbi/stripe/services/sigma/scheduled_query_run_service.rbi +46 -0
  620. data/rbi/stripe/services/sigma_service.rbi +9 -0
  621. data/rbi/stripe/services/source_service.rbi +663 -0
  622. data/rbi/stripe/services/source_transaction_service.rbi +31 -0
  623. data/rbi/stripe/services/subscription_item_service.rbi +324 -0
  624. data/rbi/stripe/services/subscription_schedule_service.rbi +1192 -0
  625. data/rbi/stripe/services/subscription_service.rbi +1596 -0
  626. data/rbi/stripe/services/tax/calculation_line_item_service.rbi +33 -0
  627. data/rbi/stripe/services/tax/calculation_service.rbi +230 -0
  628. data/rbi/stripe/services/tax/registration_service.rbi +1689 -0
  629. data/rbi/stripe/services/tax/settings_service.rbi +93 -0
  630. data/rbi/stripe/services/tax/transaction_line_item_service.rbi +33 -0
  631. data/rbi/stripe/services/tax/transaction_service.rbi +146 -0
  632. data/rbi/stripe/services/tax_code_service.rbi +44 -0
  633. data/rbi/stripe/services/tax_id_service.rbi +112 -0
  634. data/rbi/stripe/services/tax_rate_service.rbi +185 -0
  635. data/rbi/stripe/services/tax_service.rbi +12 -0
  636. data/rbi/stripe/services/terminal/configuration_service.rbi +1120 -0
  637. data/rbi/stripe/services/terminal/connection_token_service.rbi +25 -0
  638. data/rbi/stripe/services/terminal/location_service.rbi +184 -0
  639. data/rbi/stripe/services/terminal/reader_service.rbi +344 -0
  640. data/rbi/stripe/services/terminal_service.rbi +12 -0
  641. data/rbi/stripe/services/test_helpers/confirmation_token_service.rbi +746 -0
  642. data/rbi/stripe/services/test_helpers/customer_service.rbi +33 -0
  643. data/rbi/stripe/services/test_helpers/issuing/authorization_service.rbi +848 -0
  644. data/rbi/stripe/services/test_helpers/issuing/card_service.rbi +76 -0
  645. data/rbi/stripe/services/test_helpers/issuing/personalization_design_service.rbi +69 -0
  646. data/rbi/stripe/services/test_helpers/issuing/transaction_service.rbi +711 -0
  647. data/rbi/stripe/services/test_helpers/issuing_service.rbi +14 -0
  648. data/rbi/stripe/services/test_helpers/refund_service.rbi +22 -0
  649. data/rbi/stripe/services/test_helpers/terminal/reader_service.rbi +62 -0
  650. data/rbi/stripe/services/test_helpers/terminal_service.rbi +11 -0
  651. data/rbi/stripe/services/test_helpers/test_clock_service.rbi +92 -0
  652. data/rbi/stripe/services/test_helpers/treasury/inbound_transfer_service.rbi +64 -0
  653. data/rbi/stripe/services/test_helpers/treasury/outbound_payment_service.rbi +125 -0
  654. data/rbi/stripe/services/test_helpers/treasury/outbound_transfer_service.rbi +125 -0
  655. data/rbi/stripe/services/test_helpers/treasury/received_credit_service.rbi +87 -0
  656. data/rbi/stripe/services/test_helpers/treasury/received_debit_service.rbi +87 -0
  657. data/rbi/stripe/services/test_helpers/treasury_service.rbi +15 -0
  658. data/rbi/stripe/services/test_helpers_service.rbi +15 -0
  659. data/rbi/stripe/services/token_service.rbi +1189 -0
  660. data/rbi/stripe/services/topup_service.rbi +176 -0
  661. data/rbi/stripe/services/transfer_reversal_service.rbi +101 -0
  662. data/rbi/stripe/services/transfer_service.rbi +152 -0
  663. data/rbi/stripe/services/treasury/credit_reversal_service.rbi +84 -0
  664. data/rbi/stripe/services/treasury/debit_reversal_service.rbi +88 -0
  665. data/rbi/stripe/services/treasury/financial_account_features_service.rbi +198 -0
  666. data/rbi/stripe/services/treasury/financial_account_service.rbi +562 -0
  667. data/rbi/stripe/services/treasury/inbound_transfer_service.rbi +117 -0
  668. data/rbi/stripe/services/treasury/outbound_payment_service.rbi +304 -0
  669. data/rbi/stripe/services/treasury/outbound_transfer_service.rbi +157 -0
  670. data/rbi/stripe/services/treasury/received_credit_service.rbi +72 -0
  671. data/rbi/stripe/services/treasury/received_debit_service.rbi +59 -0
  672. data/rbi/stripe/services/treasury/transaction_entry_service.rbi +111 -0
  673. data/rbi/stripe/services/treasury/transaction_service.rbi +122 -0
  674. data/rbi/stripe/services/treasury_service.rbi +18 -0
  675. data/rbi/stripe/services/v1_services.rbi +77 -0
  676. data/rbi/stripe/services/v2/billing/meter_event_adjustment_service.rbi +39 -0
  677. data/rbi/stripe/services/v2/billing/meter_event_service.rbi +42 -0
  678. data/rbi/stripe/services/v2/billing/meter_event_session_service.rbi +20 -0
  679. data/rbi/stripe/services/v2/billing/meter_event_stream_service.rbi +55 -0
  680. data/rbi/stripe/services/v2/billing_service.rbi +14 -0
  681. data/rbi/stripe/services/v2/core/event_destination_service.rbi +200 -0
  682. data/rbi/stripe/services/v2/core/event_service.rbi +38 -0
  683. data/rbi/stripe/services/v2/core_service.rbi +12 -0
  684. data/rbi/stripe/services/v2_services.rbi +10 -0
  685. data/rbi/stripe/services/webhook_endpoint_service.rbi +131 -0
  686. metadata +533 -4
  687. data/lib/stripe/resources/usage_record.rb +0 -17
  688. data/lib/stripe/resources/usage_record_summary.rb +0 -11
@@ -0,0 +1,2466 @@
1
+ # File generated from our OpenAPI spec
2
+ # frozen_string_literal: true
3
+
4
+ module Stripe
5
+ module Checkout
6
+ class SessionService < StripeService
7
+ attr_reader :line_items
8
+
9
+ def initialize(requestor)
10
+ super(requestor)
11
+ @line_items = Stripe::Checkout::SessionLineItemService.new(@requestor)
12
+ end
13
+
14
+ class ListParams < Stripe::RequestParams
15
+ class Created < Stripe::RequestParams
16
+ # Minimum value to filter by (exclusive)
17
+ attr_accessor :gt
18
+ # Minimum value to filter by (inclusive)
19
+ attr_accessor :gte
20
+ # Maximum value to filter by (exclusive)
21
+ attr_accessor :lt
22
+ # Maximum value to filter by (inclusive)
23
+ attr_accessor :lte
24
+
25
+ def initialize(gt: nil, gte: nil, lt: nil, lte: nil)
26
+ @gt = gt
27
+ @gte = gte
28
+ @lt = lt
29
+ @lte = lte
30
+ end
31
+ end
32
+
33
+ class CustomerDetails < Stripe::RequestParams
34
+ # Customer's email address.
35
+ attr_accessor :email
36
+
37
+ def initialize(email: nil)
38
+ @email = email
39
+ end
40
+ end
41
+ # Only return Checkout Sessions that were created during the given date interval.
42
+ attr_accessor :created
43
+ # Only return the Checkout Sessions for the Customer specified.
44
+ attr_accessor :customer
45
+ # Only return the Checkout Sessions for the Customer details specified.
46
+ attr_accessor :customer_details
47
+ # A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
48
+ attr_accessor :ending_before
49
+ # Specifies which fields in the response should be expanded.
50
+ attr_accessor :expand
51
+ # A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
52
+ attr_accessor :limit
53
+ # Only return the Checkout Session for the PaymentIntent specified.
54
+ attr_accessor :payment_intent
55
+ # Only return the Checkout Sessions for the Payment Link specified.
56
+ attr_accessor :payment_link
57
+ # A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.
58
+ attr_accessor :starting_after
59
+ # Only return the Checkout Sessions matching the given status.
60
+ attr_accessor :status
61
+ # Only return the Checkout Session for the subscription specified.
62
+ attr_accessor :subscription
63
+
64
+ def initialize(
65
+ created: nil,
66
+ customer: nil,
67
+ customer_details: nil,
68
+ ending_before: nil,
69
+ expand: nil,
70
+ limit: nil,
71
+ payment_intent: nil,
72
+ payment_link: nil,
73
+ starting_after: nil,
74
+ status: nil,
75
+ subscription: nil
76
+ )
77
+ @created = created
78
+ @customer = customer
79
+ @customer_details = customer_details
80
+ @ending_before = ending_before
81
+ @expand = expand
82
+ @limit = limit
83
+ @payment_intent = payment_intent
84
+ @payment_link = payment_link
85
+ @starting_after = starting_after
86
+ @status = status
87
+ @subscription = subscription
88
+ end
89
+ end
90
+
91
+ class CreateParams < Stripe::RequestParams
92
+ class AdaptivePricing < Stripe::RequestParams
93
+ # Set to `true` to enable [Adaptive Pricing](https://docs.stripe.com/payments/checkout/adaptive-pricing). Defaults to your [dashboard setting](https://dashboard.stripe.com/settings/adaptive-pricing).
94
+ attr_accessor :enabled
95
+
96
+ def initialize(enabled: nil)
97
+ @enabled = enabled
98
+ end
99
+ end
100
+
101
+ class AfterExpiration < Stripe::RequestParams
102
+ class Recovery < Stripe::RequestParams
103
+ # Enables user redeemable promotion codes on the recovered Checkout Sessions. Defaults to `false`
104
+ attr_accessor :allow_promotion_codes
105
+ # If `true`, a recovery URL will be generated to recover this Checkout Session if it
106
+ # expires before a successful transaction is completed. It will be attached to the
107
+ # Checkout Session object upon expiration.
108
+ attr_accessor :enabled
109
+
110
+ def initialize(allow_promotion_codes: nil, enabled: nil)
111
+ @allow_promotion_codes = allow_promotion_codes
112
+ @enabled = enabled
113
+ end
114
+ end
115
+ # Configure a Checkout Session that can be used to recover an expired session.
116
+ attr_accessor :recovery
117
+
118
+ def initialize(recovery: nil)
119
+ @recovery = recovery
120
+ end
121
+ end
122
+
123
+ class AutomaticTax < Stripe::RequestParams
124
+ class Liability < Stripe::RequestParams
125
+ # The connected account being referenced when `type` is `account`.
126
+ attr_accessor :account
127
+ # Type of the account referenced in the request.
128
+ attr_accessor :type
129
+
130
+ def initialize(account: nil, type: nil)
131
+ @account = account
132
+ @type = type
133
+ end
134
+ end
135
+ # Set to `true` to [calculate tax automatically](https://docs.stripe.com/tax) using the customer's location.
136
+ #
137
+ # Enabling this parameter causes Checkout to collect any billing address information necessary for tax calculation.
138
+ attr_accessor :enabled
139
+ # The account that's liable for tax. If set, the business address and tax registrations required to perform the tax calculation are loaded from this account. The tax transaction is returned in the report of the connected account.
140
+ attr_accessor :liability
141
+
142
+ def initialize(enabled: nil, liability: nil)
143
+ @enabled = enabled
144
+ @liability = liability
145
+ end
146
+ end
147
+
148
+ class ConsentCollection < Stripe::RequestParams
149
+ class PaymentMethodReuseAgreement < Stripe::RequestParams
150
+ # Determines the position and visibility of the payment method reuse agreement in the UI. When set to `auto`, Stripe's
151
+ # defaults will be used. When set to `hidden`, the payment method reuse agreement text will always be hidden in the UI.
152
+ attr_accessor :position
153
+
154
+ def initialize(position: nil)
155
+ @position = position
156
+ end
157
+ end
158
+ # Determines the display of payment method reuse agreement text in the UI. If set to `hidden`, it will hide legal text related to the reuse of a payment method.
159
+ attr_accessor :payment_method_reuse_agreement
160
+ # If set to `auto`, enables the collection of customer consent for promotional communications. The Checkout
161
+ # Session will determine whether to display an option to opt into promotional communication
162
+ # from the merchant depending on the customer's locale. Only available to US merchants.
163
+ attr_accessor :promotions
164
+ # If set to `required`, it requires customers to check a terms of service checkbox before being able to pay.
165
+ # There must be a valid terms of service URL set in your [Dashboard settings](https://dashboard.stripe.com/settings/public).
166
+ attr_accessor :terms_of_service
167
+
168
+ def initialize(
169
+ payment_method_reuse_agreement: nil,
170
+ promotions: nil,
171
+ terms_of_service: nil
172
+ )
173
+ @payment_method_reuse_agreement = payment_method_reuse_agreement
174
+ @promotions = promotions
175
+ @terms_of_service = terms_of_service
176
+ end
177
+ end
178
+
179
+ class CustomField < Stripe::RequestParams
180
+ class Dropdown < Stripe::RequestParams
181
+ class Option < Stripe::RequestParams
182
+ # The label for the option, displayed to the customer. Up to 100 characters.
183
+ attr_accessor :label
184
+ # The value for this option, not displayed to the customer, used by your integration to reconcile the option selected by the customer. Must be unique to this option, alphanumeric, and up to 100 characters.
185
+ attr_accessor :value
186
+
187
+ def initialize(label: nil, value: nil)
188
+ @label = label
189
+ @value = value
190
+ end
191
+ end
192
+ # The value that will pre-fill the field on the payment page.Must match a `value` in the `options` array.
193
+ attr_accessor :default_value
194
+ # The options available for the customer to select. Up to 200 options allowed.
195
+ attr_accessor :options
196
+
197
+ def initialize(default_value: nil, options: nil)
198
+ @default_value = default_value
199
+ @options = options
200
+ end
201
+ end
202
+
203
+ class Label < Stripe::RequestParams
204
+ # Custom text for the label, displayed to the customer. Up to 50 characters.
205
+ attr_accessor :custom
206
+ # The type of the label.
207
+ attr_accessor :type
208
+
209
+ def initialize(custom: nil, type: nil)
210
+ @custom = custom
211
+ @type = type
212
+ end
213
+ end
214
+
215
+ class Numeric < Stripe::RequestParams
216
+ # The value that will pre-fill the field on the payment page.
217
+ attr_accessor :default_value
218
+ # The maximum character length constraint for the customer's input.
219
+ attr_accessor :maximum_length
220
+ # The minimum character length requirement for the customer's input.
221
+ attr_accessor :minimum_length
222
+
223
+ def initialize(default_value: nil, maximum_length: nil, minimum_length: nil)
224
+ @default_value = default_value
225
+ @maximum_length = maximum_length
226
+ @minimum_length = minimum_length
227
+ end
228
+ end
229
+
230
+ class Text < Stripe::RequestParams
231
+ # The value that will pre-fill the field on the payment page.
232
+ attr_accessor :default_value
233
+ # The maximum character length constraint for the customer's input.
234
+ attr_accessor :maximum_length
235
+ # The minimum character length requirement for the customer's input.
236
+ attr_accessor :minimum_length
237
+
238
+ def initialize(default_value: nil, maximum_length: nil, minimum_length: nil)
239
+ @default_value = default_value
240
+ @maximum_length = maximum_length
241
+ @minimum_length = minimum_length
242
+ end
243
+ end
244
+ # Configuration for `type=dropdown` fields.
245
+ attr_accessor :dropdown
246
+ # String of your choice that your integration can use to reconcile this field. Must be unique to this field, alphanumeric, and up to 200 characters.
247
+ attr_accessor :key
248
+ # The label for the field, displayed to the customer.
249
+ attr_accessor :label
250
+ # Configuration for `type=numeric` fields.
251
+ attr_accessor :numeric
252
+ # Whether the customer is required to complete the field before completing the Checkout Session. Defaults to `false`.
253
+ attr_accessor :optional
254
+ # Configuration for `type=text` fields.
255
+ attr_accessor :text
256
+ # The type of the field.
257
+ attr_accessor :type
258
+
259
+ def initialize(
260
+ dropdown: nil,
261
+ key: nil,
262
+ label: nil,
263
+ numeric: nil,
264
+ optional: nil,
265
+ text: nil,
266
+ type: nil
267
+ )
268
+ @dropdown = dropdown
269
+ @key = key
270
+ @label = label
271
+ @numeric = numeric
272
+ @optional = optional
273
+ @text = text
274
+ @type = type
275
+ end
276
+ end
277
+
278
+ class CustomText < Stripe::RequestParams
279
+ class AfterSubmit < Stripe::RequestParams
280
+ # Text may be up to 1200 characters in length.
281
+ attr_accessor :message
282
+
283
+ def initialize(message: nil)
284
+ @message = message
285
+ end
286
+ end
287
+
288
+ class ShippingAddress < Stripe::RequestParams
289
+ # Text may be up to 1200 characters in length.
290
+ attr_accessor :message
291
+
292
+ def initialize(message: nil)
293
+ @message = message
294
+ end
295
+ end
296
+
297
+ class Submit < Stripe::RequestParams
298
+ # Text may be up to 1200 characters in length.
299
+ attr_accessor :message
300
+
301
+ def initialize(message: nil)
302
+ @message = message
303
+ end
304
+ end
305
+
306
+ class TermsOfServiceAcceptance < Stripe::RequestParams
307
+ # Text may be up to 1200 characters in length.
308
+ attr_accessor :message
309
+
310
+ def initialize(message: nil)
311
+ @message = message
312
+ end
313
+ end
314
+ # Custom text that should be displayed after the payment confirmation button.
315
+ attr_accessor :after_submit
316
+ # Custom text that should be displayed alongside shipping address collection.
317
+ attr_accessor :shipping_address
318
+ # Custom text that should be displayed alongside the payment confirmation button.
319
+ attr_accessor :submit
320
+ # Custom text that should be displayed in place of the default terms of service agreement text.
321
+ attr_accessor :terms_of_service_acceptance
322
+
323
+ def initialize(
324
+ after_submit: nil,
325
+ shipping_address: nil,
326
+ submit: nil,
327
+ terms_of_service_acceptance: nil
328
+ )
329
+ @after_submit = after_submit
330
+ @shipping_address = shipping_address
331
+ @submit = submit
332
+ @terms_of_service_acceptance = terms_of_service_acceptance
333
+ end
334
+ end
335
+
336
+ class CustomerUpdate < Stripe::RequestParams
337
+ # Describes whether Checkout saves the billing address onto `customer.address`.
338
+ # To always collect a full billing address, use `billing_address_collection`. Defaults to `never`.
339
+ attr_accessor :address
340
+ # Describes whether Checkout saves the name onto `customer.name`. Defaults to `never`.
341
+ attr_accessor :name
342
+ # Describes whether Checkout saves shipping information onto `customer.shipping`.
343
+ # To collect shipping information, use `shipping_address_collection`. Defaults to `never`.
344
+ attr_accessor :shipping
345
+
346
+ def initialize(address: nil, name: nil, shipping: nil)
347
+ @address = address
348
+ @name = name
349
+ @shipping = shipping
350
+ end
351
+ end
352
+
353
+ class Discount < Stripe::RequestParams
354
+ # The ID of the coupon to apply to this Session.
355
+ attr_accessor :coupon
356
+ # The ID of a promotion code to apply to this Session.
357
+ attr_accessor :promotion_code
358
+
359
+ def initialize(coupon: nil, promotion_code: nil)
360
+ @coupon = coupon
361
+ @promotion_code = promotion_code
362
+ end
363
+ end
364
+
365
+ class InvoiceCreation < Stripe::RequestParams
366
+ class InvoiceData < Stripe::RequestParams
367
+ class CustomField < Stripe::RequestParams
368
+ # The name of the custom field. This may be up to 40 characters.
369
+ attr_accessor :name
370
+ # The value of the custom field. This may be up to 140 characters.
371
+ attr_accessor :value
372
+
373
+ def initialize(name: nil, value: nil)
374
+ @name = name
375
+ @value = value
376
+ end
377
+ end
378
+
379
+ class Issuer < Stripe::RequestParams
380
+ # The connected account being referenced when `type` is `account`.
381
+ attr_accessor :account
382
+ # Type of the account referenced in the request.
383
+ attr_accessor :type
384
+
385
+ def initialize(account: nil, type: nil)
386
+ @account = account
387
+ @type = type
388
+ end
389
+ end
390
+
391
+ class RenderingOptions < Stripe::RequestParams
392
+ # How line-item prices and amounts will be displayed with respect to tax on invoice PDFs. One of `exclude_tax` or `include_inclusive_tax`. `include_inclusive_tax` will include inclusive tax (and exclude exclusive tax) in invoice PDF amounts. `exclude_tax` will exclude all tax (inclusive and exclusive alike) from invoice PDF amounts.
393
+ attr_accessor :amount_tax_display
394
+
395
+ def initialize(amount_tax_display: nil)
396
+ @amount_tax_display = amount_tax_display
397
+ end
398
+ end
399
+ # The account tax IDs associated with the invoice.
400
+ attr_accessor :account_tax_ids
401
+ # Default custom fields to be displayed on invoices for this customer.
402
+ attr_accessor :custom_fields
403
+ # An arbitrary string attached to the object. Often useful for displaying to users.
404
+ attr_accessor :description
405
+ # Default footer to be displayed on invoices for this customer.
406
+ attr_accessor :footer
407
+ # The connected account that issues the invoice. The invoice is presented with the branding and support information of the specified account.
408
+ attr_accessor :issuer
409
+ # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
410
+ attr_accessor :metadata
411
+ # Default options for invoice PDF rendering for this customer.
412
+ attr_accessor :rendering_options
413
+
414
+ def initialize(
415
+ account_tax_ids: nil,
416
+ custom_fields: nil,
417
+ description: nil,
418
+ footer: nil,
419
+ issuer: nil,
420
+ metadata: nil,
421
+ rendering_options: nil
422
+ )
423
+ @account_tax_ids = account_tax_ids
424
+ @custom_fields = custom_fields
425
+ @description = description
426
+ @footer = footer
427
+ @issuer = issuer
428
+ @metadata = metadata
429
+ @rendering_options = rendering_options
430
+ end
431
+ end
432
+ # Set to `true` to enable invoice creation.
433
+ attr_accessor :enabled
434
+ # Parameters passed when creating invoices for payment-mode Checkout Sessions.
435
+ attr_accessor :invoice_data
436
+
437
+ def initialize(enabled: nil, invoice_data: nil)
438
+ @enabled = enabled
439
+ @invoice_data = invoice_data
440
+ end
441
+ end
442
+
443
+ class LineItem < Stripe::RequestParams
444
+ class AdjustableQuantity < Stripe::RequestParams
445
+ # Set to true if the quantity can be adjusted to any non-negative integer.
446
+ attr_accessor :enabled
447
+ # The maximum quantity the customer can purchase for the Checkout Session. By default this value is 99. You can specify a value up to 999999.
448
+ attr_accessor :maximum
449
+ # The minimum quantity the customer must purchase for the Checkout Session. By default this value is 0.
450
+ attr_accessor :minimum
451
+
452
+ def initialize(enabled: nil, maximum: nil, minimum: nil)
453
+ @enabled = enabled
454
+ @maximum = maximum
455
+ @minimum = minimum
456
+ end
457
+ end
458
+
459
+ class PriceData < Stripe::RequestParams
460
+ class ProductData < Stripe::RequestParams
461
+ # 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.
462
+ attr_accessor :description
463
+ # A list of up to 8 URLs of images for this product, meant to be displayable to the customer.
464
+ attr_accessor :images
465
+ # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
466
+ attr_accessor :metadata
467
+ # The product's name, meant to be displayable to the customer.
468
+ attr_accessor :name
469
+ # A [tax code](https://stripe.com/docs/tax/tax-categories) ID.
470
+ attr_accessor :tax_code
471
+
472
+ def initialize(description: nil, images: nil, metadata: nil, name: nil, tax_code: nil)
473
+ @description = description
474
+ @images = images
475
+ @metadata = metadata
476
+ @name = name
477
+ @tax_code = tax_code
478
+ end
479
+ end
480
+
481
+ class Recurring < Stripe::RequestParams
482
+ # Specifies billing frequency. Either `day`, `week`, `month` or `year`.
483
+ attr_accessor :interval
484
+ # The number of intervals between subscription billings. For example, `interval=month` and `interval_count=3` bills every 3 months. Maximum of three years interval allowed (3 years, 36 months, or 156 weeks).
485
+ attr_accessor :interval_count
486
+
487
+ def initialize(interval: nil, interval_count: nil)
488
+ @interval = interval
489
+ @interval_count = interval_count
490
+ end
491
+ end
492
+ # 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).
493
+ attr_accessor :currency
494
+ # The ID of the [Product](https://docs.stripe.com/api/products) that this [Price](https://docs.stripe.com/api/prices) will belong to. One of `product` or `product_data` is required.
495
+ attr_accessor :product
496
+ # Data used to generate a new [Product](https://docs.stripe.com/api/products) object inline. One of `product` or `product_data` is required.
497
+ attr_accessor :product_data
498
+ # The recurring components of a price such as `interval` and `interval_count`.
499
+ attr_accessor :recurring
500
+ # 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.
501
+ attr_accessor :tax_behavior
502
+ # A non-negative integer in cents (or local equivalent) representing how much to charge. One of `unit_amount` or `unit_amount_decimal` is required.
503
+ attr_accessor :unit_amount
504
+ # Same as `unit_amount`, but accepts a decimal value in cents (or local equivalent) with at most 12 decimal places. Only one of `unit_amount` and `unit_amount_decimal` can be set.
505
+ attr_accessor :unit_amount_decimal
506
+
507
+ def initialize(
508
+ currency: nil,
509
+ product: nil,
510
+ product_data: nil,
511
+ recurring: nil,
512
+ tax_behavior: nil,
513
+ unit_amount: nil,
514
+ unit_amount_decimal: nil
515
+ )
516
+ @currency = currency
517
+ @product = product
518
+ @product_data = product_data
519
+ @recurring = recurring
520
+ @tax_behavior = tax_behavior
521
+ @unit_amount = unit_amount
522
+ @unit_amount_decimal = unit_amount_decimal
523
+ end
524
+ end
525
+ # When set, provides configuration for this item’s quantity to be adjusted by the customer during Checkout.
526
+ attr_accessor :adjustable_quantity
527
+ # The [tax rates](https://stripe.com/docs/api/tax_rates) that will be applied to this line item depending on the customer's billing/shipping address. We currently support the following countries: US, GB, AU, and all countries in the EU.
528
+ attr_accessor :dynamic_tax_rates
529
+ # The ID of the [Price](https://stripe.com/docs/api/prices) or [Plan](https://stripe.com/docs/api/plans) object. One of `price` or `price_data` is required.
530
+ attr_accessor :price
531
+ # Data used to generate a new [Price](https://stripe.com/docs/api/prices) object inline. One of `price` or `price_data` is required.
532
+ attr_accessor :price_data
533
+ # The quantity of the line item being purchased. Quantity should not be defined when `recurring.usage_type=metered`.
534
+ attr_accessor :quantity
535
+ # The [tax rates](https://stripe.com/docs/api/tax_rates) which apply to this line item.
536
+ attr_accessor :tax_rates
537
+
538
+ def initialize(
539
+ adjustable_quantity: nil,
540
+ dynamic_tax_rates: nil,
541
+ price: nil,
542
+ price_data: nil,
543
+ quantity: nil,
544
+ tax_rates: nil
545
+ )
546
+ @adjustable_quantity = adjustable_quantity
547
+ @dynamic_tax_rates = dynamic_tax_rates
548
+ @price = price
549
+ @price_data = price_data
550
+ @quantity = quantity
551
+ @tax_rates = tax_rates
552
+ end
553
+ end
554
+
555
+ class OptionalItem < Stripe::RequestParams
556
+ class AdjustableQuantity < Stripe::RequestParams
557
+ # Set to true if the quantity can be adjusted to any non-negative integer.
558
+ attr_accessor :enabled
559
+ # The maximum quantity of this item the customer can purchase. By default this value is 99. You can specify a value up to 999999.
560
+ attr_accessor :maximum
561
+ # The minimum quantity of this item the customer must purchase, if they choose to purchase it. Because this item is optional, the customer will always be able to remove it from their order, even if the `minimum` configured here is greater than 0. By default this value is 0.
562
+ attr_accessor :minimum
563
+
564
+ def initialize(enabled: nil, maximum: nil, minimum: nil)
565
+ @enabled = enabled
566
+ @maximum = maximum
567
+ @minimum = minimum
568
+ end
569
+ end
570
+ # When set, provides configuration for the customer to adjust the quantity of the line item created when a customer chooses to add this optional item to their order.
571
+ attr_accessor :adjustable_quantity
572
+ # The ID of the [Price](https://stripe.com/docs/api/prices) or [Plan](https://stripe.com/docs/api/plans) object.
573
+ attr_accessor :price
574
+ # The initial quantity of the line item created when a customer chooses to add this optional item to their order.
575
+ attr_accessor :quantity
576
+
577
+ def initialize(adjustable_quantity: nil, price: nil, quantity: nil)
578
+ @adjustable_quantity = adjustable_quantity
579
+ @price = price
580
+ @quantity = quantity
581
+ end
582
+ end
583
+
584
+ class PaymentIntentData < Stripe::RequestParams
585
+ class Shipping < Stripe::RequestParams
586
+ class Address < Stripe::RequestParams
587
+ # City, district, suburb, town, or village.
588
+ attr_accessor :city
589
+ # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
590
+ attr_accessor :country
591
+ # Address line 1 (e.g., street, PO Box, or company name).
592
+ attr_accessor :line1
593
+ # Address line 2 (e.g., apartment, suite, unit, or building).
594
+ attr_accessor :line2
595
+ # ZIP or postal code.
596
+ attr_accessor :postal_code
597
+ # State, county, province, or region.
598
+ attr_accessor :state
599
+
600
+ def initialize(
601
+ city: nil,
602
+ country: nil,
603
+ line1: nil,
604
+ line2: nil,
605
+ postal_code: nil,
606
+ state: nil
607
+ )
608
+ @city = city
609
+ @country = country
610
+ @line1 = line1
611
+ @line2 = line2
612
+ @postal_code = postal_code
613
+ @state = state
614
+ end
615
+ end
616
+ # Shipping address.
617
+ attr_accessor :address
618
+ # The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
619
+ attr_accessor :carrier
620
+ # Recipient name.
621
+ attr_accessor :name
622
+ # Recipient phone (including extension).
623
+ attr_accessor :phone
624
+ # The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
625
+ attr_accessor :tracking_number
626
+
627
+ def initialize(address: nil, carrier: nil, name: nil, phone: nil, tracking_number: nil)
628
+ @address = address
629
+ @carrier = carrier
630
+ @name = name
631
+ @phone = phone
632
+ @tracking_number = tracking_number
633
+ end
634
+ end
635
+
636
+ class TransferData < Stripe::RequestParams
637
+ # The amount that will be transferred automatically when a charge succeeds.
638
+ attr_accessor :amount
639
+ # If specified, successful charges will be attributed to the destination
640
+ # account for tax reporting, and the funds from charges will be transferred
641
+ # to the destination account. The ID of the resulting transfer will be
642
+ # returned on the successful charge's `transfer` field.
643
+ attr_accessor :destination
644
+
645
+ def initialize(amount: nil, destination: nil)
646
+ @amount = amount
647
+ @destination = destination
648
+ end
649
+ end
650
+ # The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total amount captured. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts).
651
+ attr_accessor :application_fee_amount
652
+ # Controls when the funds will be captured from the customer's account.
653
+ attr_accessor :capture_method
654
+ # An arbitrary string attached to the object. Often useful for displaying to users.
655
+ attr_accessor :description
656
+ # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
657
+ attr_accessor :metadata
658
+ # The Stripe account ID for which these funds are intended. For details,
659
+ # see the PaymentIntents [use case for connected
660
+ # accounts](/docs/payments/connected-accounts).
661
+ attr_accessor :on_behalf_of
662
+ # Email address that the receipt for the resulting payment will be sent to. If `receipt_email` is specified for a payment in live mode, a receipt will be sent regardless of your [email settings](https://dashboard.stripe.com/account/emails).
663
+ attr_accessor :receipt_email
664
+ # Indicates that you intend to [make future payments](https://stripe.com/docs/payments/payment-intents#future-usage) with the payment
665
+ # method collected by this Checkout Session.
666
+ #
667
+ # When setting this to `on_session`, Checkout will show a notice to the
668
+ # customer that their payment details will be saved.
669
+ #
670
+ # When setting this to `off_session`, Checkout will show a notice to the
671
+ # customer that their payment details will be saved and used for future
672
+ # payments.
673
+ #
674
+ # If a Customer has been provided or Checkout creates a new Customer,
675
+ # Checkout will attach the payment method to the Customer.
676
+ #
677
+ # If Checkout does not create a Customer, the payment method is not attached
678
+ # to a Customer. To reuse the payment method, you can retrieve it from the
679
+ # Checkout Session's PaymentIntent.
680
+ #
681
+ # When processing card payments, Checkout also uses `setup_future_usage`
682
+ # to dynamically optimize your payment flow and comply with regional
683
+ # legislation and network rules, such as SCA.
684
+ attr_accessor :setup_future_usage
685
+ # Shipping information for this payment.
686
+ attr_accessor :shipping
687
+ # Text that appears on the customer's statement as the statement descriptor for a non-card charge. This value overrides the account's default statement descriptor. For information about requirements, including the 22-character limit, see [the Statement Descriptor docs](https://docs.stripe.com/get-started/account/statement-descriptors).
688
+ #
689
+ # Setting this value for a card charge returns an error. For card charges, set the [statement_descriptor_suffix](https://docs.stripe.com/get-started/account/statement-descriptors#dynamic) instead.
690
+ attr_accessor :statement_descriptor
691
+ # Provides information about a card charge. Concatenated to the account's [statement descriptor prefix](https://docs.stripe.com/get-started/account/statement-descriptors#static) to form the complete statement descriptor that appears on the customer's statement.
692
+ attr_accessor :statement_descriptor_suffix
693
+ # The parameters used to automatically create a Transfer when the payment succeeds.
694
+ # For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts).
695
+ attr_accessor :transfer_data
696
+ # A string that identifies the resulting payment as part of a group. See the PaymentIntents [use case for connected accounts](https://stripe.com/docs/connect/separate-charges-and-transfers) for details.
697
+ attr_accessor :transfer_group
698
+
699
+ def initialize(
700
+ application_fee_amount: nil,
701
+ capture_method: nil,
702
+ description: nil,
703
+ metadata: nil,
704
+ on_behalf_of: nil,
705
+ receipt_email: nil,
706
+ setup_future_usage: nil,
707
+ shipping: nil,
708
+ statement_descriptor: nil,
709
+ statement_descriptor_suffix: nil,
710
+ transfer_data: nil,
711
+ transfer_group: nil
712
+ )
713
+ @application_fee_amount = application_fee_amount
714
+ @capture_method = capture_method
715
+ @description = description
716
+ @metadata = metadata
717
+ @on_behalf_of = on_behalf_of
718
+ @receipt_email = receipt_email
719
+ @setup_future_usage = setup_future_usage
720
+ @shipping = shipping
721
+ @statement_descriptor = statement_descriptor
722
+ @statement_descriptor_suffix = statement_descriptor_suffix
723
+ @transfer_data = transfer_data
724
+ @transfer_group = transfer_group
725
+ end
726
+ end
727
+
728
+ class PaymentMethodData < Stripe::RequestParams
729
+ # Allow redisplay will be set on the payment method on confirmation and indicates whether this payment method can be shown again to the customer in a checkout flow. Only set this field if you wish to override the allow_redisplay value determined by Checkout.
730
+ attr_accessor :allow_redisplay
731
+
732
+ def initialize(allow_redisplay: nil)
733
+ @allow_redisplay = allow_redisplay
734
+ end
735
+ end
736
+
737
+ class PaymentMethodOptions < Stripe::RequestParams
738
+ class AcssDebit < Stripe::RequestParams
739
+ class MandateOptions < Stripe::RequestParams
740
+ # A URL for custom mandate text to render during confirmation step.
741
+ # The URL will be rendered with additional GET parameters `payment_intent` and `payment_intent_client_secret` when confirming a Payment Intent,
742
+ # or `setup_intent` and `setup_intent_client_secret` when confirming a Setup Intent.
743
+ attr_accessor :custom_mandate_url
744
+ # List of Stripe products where this mandate can be selected automatically. Only usable in `setup` mode.
745
+ attr_accessor :default_for
746
+ # Description of the mandate interval. Only required if 'payment_schedule' parameter is 'interval' or 'combined'.
747
+ attr_accessor :interval_description
748
+ # Payment schedule for the mandate.
749
+ attr_accessor :payment_schedule
750
+ # Transaction type of the mandate.
751
+ attr_accessor :transaction_type
752
+
753
+ def initialize(
754
+ custom_mandate_url: nil,
755
+ default_for: nil,
756
+ interval_description: nil,
757
+ payment_schedule: nil,
758
+ transaction_type: nil
759
+ )
760
+ @custom_mandate_url = custom_mandate_url
761
+ @default_for = default_for
762
+ @interval_description = interval_description
763
+ @payment_schedule = payment_schedule
764
+ @transaction_type = transaction_type
765
+ end
766
+ end
767
+ # 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). This is only accepted for Checkout Sessions in `setup` mode.
768
+ attr_accessor :currency
769
+ # Additional fields for Mandate creation
770
+ attr_accessor :mandate_options
771
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
772
+ #
773
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
774
+ #
775
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
776
+ #
777
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
778
+ attr_accessor :setup_future_usage
779
+ # Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
780
+ attr_accessor :target_date
781
+ # Verification method for the intent
782
+ attr_accessor :verification_method
783
+
784
+ def initialize(
785
+ currency: nil,
786
+ mandate_options: nil,
787
+ setup_future_usage: nil,
788
+ target_date: nil,
789
+ verification_method: nil
790
+ )
791
+ @currency = currency
792
+ @mandate_options = mandate_options
793
+ @setup_future_usage = setup_future_usage
794
+ @target_date = target_date
795
+ @verification_method = verification_method
796
+ end
797
+ end
798
+
799
+ class Affirm < Stripe::RequestParams
800
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
801
+ #
802
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
803
+ #
804
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
805
+ #
806
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
807
+ attr_accessor :setup_future_usage
808
+
809
+ def initialize(setup_future_usage: nil)
810
+ @setup_future_usage = setup_future_usage
811
+ end
812
+ end
813
+
814
+ class AfterpayClearpay < Stripe::RequestParams
815
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
816
+ #
817
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
818
+ #
819
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
820
+ #
821
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
822
+ attr_accessor :setup_future_usage
823
+
824
+ def initialize(setup_future_usage: nil)
825
+ @setup_future_usage = setup_future_usage
826
+ end
827
+ end
828
+
829
+ class Alipay < Stripe::RequestParams
830
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
831
+ #
832
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
833
+ #
834
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
835
+ #
836
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
837
+ attr_accessor :setup_future_usage
838
+
839
+ def initialize(setup_future_usage: nil)
840
+ @setup_future_usage = setup_future_usage
841
+ end
842
+ end
843
+
844
+ class AmazonPay < Stripe::RequestParams
845
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
846
+ #
847
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
848
+ #
849
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
850
+ #
851
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
852
+ attr_accessor :setup_future_usage
853
+
854
+ def initialize(setup_future_usage: nil)
855
+ @setup_future_usage = setup_future_usage
856
+ end
857
+ end
858
+
859
+ class AuBecsDebit < Stripe::RequestParams
860
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
861
+ #
862
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
863
+ #
864
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
865
+ #
866
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
867
+ attr_accessor :setup_future_usage
868
+ # Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
869
+ attr_accessor :target_date
870
+
871
+ def initialize(setup_future_usage: nil, target_date: nil)
872
+ @setup_future_usage = setup_future_usage
873
+ @target_date = target_date
874
+ end
875
+ end
876
+
877
+ class BacsDebit < Stripe::RequestParams
878
+ class MandateOptions < Stripe::RequestParams
879
+ # Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'DDIC' or 'STRIPE'.
880
+ attr_accessor :reference_prefix
881
+
882
+ def initialize(reference_prefix: nil)
883
+ @reference_prefix = reference_prefix
884
+ end
885
+ end
886
+ # Additional fields for Mandate creation
887
+ attr_accessor :mandate_options
888
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
889
+ #
890
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
891
+ #
892
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
893
+ #
894
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
895
+ attr_accessor :setup_future_usage
896
+ # Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
897
+ attr_accessor :target_date
898
+
899
+ def initialize(mandate_options: nil, setup_future_usage: nil, target_date: nil)
900
+ @mandate_options = mandate_options
901
+ @setup_future_usage = setup_future_usage
902
+ @target_date = target_date
903
+ end
904
+ end
905
+
906
+ class Bancontact < Stripe::RequestParams
907
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
908
+ #
909
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
910
+ #
911
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
912
+ #
913
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
914
+ attr_accessor :setup_future_usage
915
+
916
+ def initialize(setup_future_usage: nil)
917
+ @setup_future_usage = setup_future_usage
918
+ end
919
+ end
920
+
921
+ class Boleto < Stripe::RequestParams
922
+ # The number of calendar days before a Boleto voucher expires. For example, if you create a Boleto voucher on Monday and you set expires_after_days to 2, the Boleto invoice will expire on Wednesday at 23:59 America/Sao_Paulo time.
923
+ attr_accessor :expires_after_days
924
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
925
+ #
926
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
927
+ #
928
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
929
+ #
930
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
931
+ attr_accessor :setup_future_usage
932
+
933
+ def initialize(expires_after_days: nil, setup_future_usage: nil)
934
+ @expires_after_days = expires_after_days
935
+ @setup_future_usage = setup_future_usage
936
+ end
937
+ end
938
+
939
+ class Card < Stripe::RequestParams
940
+ class Installments < Stripe::RequestParams
941
+ # Setting to true enables installments for this Checkout Session.
942
+ # Setting to false will prevent any installment plan from applying to a payment.
943
+ attr_accessor :enabled
944
+
945
+ def initialize(enabled: nil)
946
+ @enabled = enabled
947
+ end
948
+ end
949
+
950
+ class Restrictions < Stripe::RequestParams
951
+ # Specify the card brands to block in the Checkout Session. If a customer enters or selects a card belonging to a blocked brand, they can't complete the Session.
952
+ attr_accessor :brands_blocked
953
+
954
+ def initialize(brands_blocked: nil)
955
+ @brands_blocked = brands_blocked
956
+ end
957
+ end
958
+ # Installment options for card payments
959
+ attr_accessor :installments
960
+ # Request ability to [capture beyond the standard authorization validity window](/payments/extended-authorization) for this CheckoutSession.
961
+ attr_accessor :request_extended_authorization
962
+ # Request ability to [increment the authorization](/payments/incremental-authorization) for this CheckoutSession.
963
+ attr_accessor :request_incremental_authorization
964
+ # Request ability to make [multiple captures](/payments/multicapture) for this CheckoutSession.
965
+ attr_accessor :request_multicapture
966
+ # Request ability to [overcapture](/payments/overcapture) for this CheckoutSession.
967
+ attr_accessor :request_overcapture
968
+ # We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and [other requirements](https://stripe.com/docs/strong-customer-authentication). However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to `automatic`. Read our guide on [manually requesting 3D Secure](https://stripe.com/docs/payments/3d-secure/authentication-flow#manual-three-ds) for more information on how this configuration interacts with Radar and our SCA Engine.
969
+ attr_accessor :request_three_d_secure
970
+ # Restrictions to apply to the card payment method. For example, you can block specific card brands.
971
+ attr_accessor :restrictions
972
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
973
+ #
974
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
975
+ #
976
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
977
+ #
978
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
979
+ attr_accessor :setup_future_usage
980
+ # Provides information about a card payment that customers see on their statements. Concatenated with the Kana prefix (shortened Kana descriptor) or Kana statement descriptor that’s set on the account to form the complete statement descriptor. Maximum 22 characters. On card statements, the *concatenation* of both prefix and suffix (including separators) will appear truncated to 22 characters.
981
+ attr_accessor :statement_descriptor_suffix_kana
982
+ # Provides information about a card payment that customers see on their statements. Concatenated with the Kanji prefix (shortened Kanji descriptor) or Kanji statement descriptor that’s set on the account to form the complete statement descriptor. Maximum 17 characters. On card statements, the *concatenation* of both prefix and suffix (including separators) will appear truncated to 17 characters.
983
+ attr_accessor :statement_descriptor_suffix_kanji
984
+
985
+ def initialize(
986
+ installments: nil,
987
+ request_extended_authorization: nil,
988
+ request_incremental_authorization: nil,
989
+ request_multicapture: nil,
990
+ request_overcapture: nil,
991
+ request_three_d_secure: nil,
992
+ restrictions: nil,
993
+ setup_future_usage: nil,
994
+ statement_descriptor_suffix_kana: nil,
995
+ statement_descriptor_suffix_kanji: nil
996
+ )
997
+ @installments = installments
998
+ @request_extended_authorization = request_extended_authorization
999
+ @request_incremental_authorization = request_incremental_authorization
1000
+ @request_multicapture = request_multicapture
1001
+ @request_overcapture = request_overcapture
1002
+ @request_three_d_secure = request_three_d_secure
1003
+ @restrictions = restrictions
1004
+ @setup_future_usage = setup_future_usage
1005
+ @statement_descriptor_suffix_kana = statement_descriptor_suffix_kana
1006
+ @statement_descriptor_suffix_kanji = statement_descriptor_suffix_kanji
1007
+ end
1008
+ end
1009
+
1010
+ class Cashapp < Stripe::RequestParams
1011
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1012
+ #
1013
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1014
+ #
1015
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1016
+ #
1017
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1018
+ attr_accessor :setup_future_usage
1019
+
1020
+ def initialize(setup_future_usage: nil)
1021
+ @setup_future_usage = setup_future_usage
1022
+ end
1023
+ end
1024
+
1025
+ class CustomerBalance < Stripe::RequestParams
1026
+ class BankTransfer < Stripe::RequestParams
1027
+ class EuBankTransfer < Stripe::RequestParams
1028
+ # The desired country code of the bank account information. Permitted values include: `BE`, `DE`, `ES`, `FR`, `IE`, or `NL`.
1029
+ attr_accessor :country
1030
+
1031
+ def initialize(country: nil)
1032
+ @country = country
1033
+ end
1034
+ end
1035
+ # Configuration for eu_bank_transfer funding type.
1036
+ attr_accessor :eu_bank_transfer
1037
+ # List of address types that should be returned in the financial_addresses response. If not specified, all valid types will be returned.
1038
+ #
1039
+ # Permitted values include: `sort_code`, `zengin`, `iban`, or `spei`.
1040
+ attr_accessor :requested_address_types
1041
+ # The list of bank transfer types that this PaymentIntent is allowed to use for funding.
1042
+ attr_accessor :type
1043
+
1044
+ def initialize(eu_bank_transfer: nil, requested_address_types: nil, type: nil)
1045
+ @eu_bank_transfer = eu_bank_transfer
1046
+ @requested_address_types = requested_address_types
1047
+ @type = type
1048
+ end
1049
+ end
1050
+ # Configuration for the bank transfer funding type, if the `funding_type` is set to `bank_transfer`.
1051
+ attr_accessor :bank_transfer
1052
+ # The funding method type to be used when there are not enough funds in the customer balance. Permitted values include: `bank_transfer`.
1053
+ attr_accessor :funding_type
1054
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1055
+ #
1056
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1057
+ #
1058
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1059
+ #
1060
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1061
+ attr_accessor :setup_future_usage
1062
+
1063
+ def initialize(bank_transfer: nil, funding_type: nil, setup_future_usage: nil)
1064
+ @bank_transfer = bank_transfer
1065
+ @funding_type = funding_type
1066
+ @setup_future_usage = setup_future_usage
1067
+ end
1068
+ end
1069
+
1070
+ class Eps < Stripe::RequestParams
1071
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1072
+ #
1073
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1074
+ #
1075
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1076
+ #
1077
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1078
+ attr_accessor :setup_future_usage
1079
+
1080
+ def initialize(setup_future_usage: nil)
1081
+ @setup_future_usage = setup_future_usage
1082
+ end
1083
+ end
1084
+
1085
+ class Fpx < Stripe::RequestParams
1086
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1087
+ #
1088
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1089
+ #
1090
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1091
+ #
1092
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1093
+ attr_accessor :setup_future_usage
1094
+
1095
+ def initialize(setup_future_usage: nil)
1096
+ @setup_future_usage = setup_future_usage
1097
+ end
1098
+ end
1099
+
1100
+ class Giropay < Stripe::RequestParams
1101
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1102
+ #
1103
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1104
+ #
1105
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1106
+ #
1107
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1108
+ attr_accessor :setup_future_usage
1109
+
1110
+ def initialize(setup_future_usage: nil)
1111
+ @setup_future_usage = setup_future_usage
1112
+ end
1113
+ end
1114
+
1115
+ class Grabpay < Stripe::RequestParams
1116
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1117
+ #
1118
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1119
+ #
1120
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1121
+ #
1122
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1123
+ attr_accessor :setup_future_usage
1124
+
1125
+ def initialize(setup_future_usage: nil)
1126
+ @setup_future_usage = setup_future_usage
1127
+ end
1128
+ end
1129
+
1130
+ class Ideal < Stripe::RequestParams
1131
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1132
+ #
1133
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1134
+ #
1135
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1136
+ #
1137
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1138
+ attr_accessor :setup_future_usage
1139
+
1140
+ def initialize(setup_future_usage: nil)
1141
+ @setup_future_usage = setup_future_usage
1142
+ end
1143
+ end
1144
+
1145
+ class KakaoPay < Stripe::RequestParams
1146
+ # Controls when the funds will be captured from the customer's account.
1147
+ attr_accessor :capture_method
1148
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1149
+ #
1150
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1151
+ #
1152
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1153
+ #
1154
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1155
+ attr_accessor :setup_future_usage
1156
+
1157
+ def initialize(capture_method: nil, setup_future_usage: nil)
1158
+ @capture_method = capture_method
1159
+ @setup_future_usage = setup_future_usage
1160
+ end
1161
+ end
1162
+
1163
+ class Klarna < Stripe::RequestParams
1164
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1165
+ #
1166
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1167
+ #
1168
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1169
+ #
1170
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1171
+ attr_accessor :setup_future_usage
1172
+
1173
+ def initialize(setup_future_usage: nil)
1174
+ @setup_future_usage = setup_future_usage
1175
+ end
1176
+ end
1177
+
1178
+ class Konbini < Stripe::RequestParams
1179
+ # The number of calendar days (between 1 and 60) after which Konbini payment instructions will expire. For example, if a PaymentIntent is confirmed with Konbini and `expires_after_days` set to 2 on Monday JST, the instructions will expire on Wednesday 23:59:59 JST. Defaults to 3 days.
1180
+ attr_accessor :expires_after_days
1181
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1182
+ #
1183
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1184
+ #
1185
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1186
+ #
1187
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1188
+ attr_accessor :setup_future_usage
1189
+
1190
+ def initialize(expires_after_days: nil, setup_future_usage: nil)
1191
+ @expires_after_days = expires_after_days
1192
+ @setup_future_usage = setup_future_usage
1193
+ end
1194
+ end
1195
+
1196
+ class KrCard < Stripe::RequestParams
1197
+ # Controls when the funds will be captured from the customer's account.
1198
+ attr_accessor :capture_method
1199
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1200
+ #
1201
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1202
+ #
1203
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1204
+ #
1205
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1206
+ attr_accessor :setup_future_usage
1207
+
1208
+ def initialize(capture_method: nil, setup_future_usage: nil)
1209
+ @capture_method = capture_method
1210
+ @setup_future_usage = setup_future_usage
1211
+ end
1212
+ end
1213
+
1214
+ class Link < Stripe::RequestParams
1215
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1216
+ #
1217
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1218
+ #
1219
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1220
+ #
1221
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1222
+ attr_accessor :setup_future_usage
1223
+
1224
+ def initialize(setup_future_usage: nil)
1225
+ @setup_future_usage = setup_future_usage
1226
+ end
1227
+ end
1228
+
1229
+ class Mobilepay < Stripe::RequestParams
1230
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1231
+ #
1232
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1233
+ #
1234
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1235
+ #
1236
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1237
+ attr_accessor :setup_future_usage
1238
+
1239
+ def initialize(setup_future_usage: nil)
1240
+ @setup_future_usage = setup_future_usage
1241
+ end
1242
+ end
1243
+
1244
+ class Multibanco < Stripe::RequestParams
1245
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1246
+ #
1247
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1248
+ #
1249
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1250
+ #
1251
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1252
+ attr_accessor :setup_future_usage
1253
+
1254
+ def initialize(setup_future_usage: nil)
1255
+ @setup_future_usage = setup_future_usage
1256
+ end
1257
+ end
1258
+
1259
+ class NaverPay < Stripe::RequestParams
1260
+ # Controls when the funds will be captured from the customer's account.
1261
+ attr_accessor :capture_method
1262
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1263
+ #
1264
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1265
+ #
1266
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1267
+ #
1268
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1269
+ attr_accessor :setup_future_usage
1270
+
1271
+ def initialize(capture_method: nil, setup_future_usage: nil)
1272
+ @capture_method = capture_method
1273
+ @setup_future_usage = setup_future_usage
1274
+ end
1275
+ end
1276
+
1277
+ class Oxxo < Stripe::RequestParams
1278
+ # The number of calendar days before an OXXO voucher expires. For example, if you create an OXXO voucher on Monday and you set expires_after_days to 2, the OXXO invoice will expire on Wednesday at 23:59 America/Mexico_City time.
1279
+ attr_accessor :expires_after_days
1280
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1281
+ #
1282
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1283
+ #
1284
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1285
+ #
1286
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1287
+ attr_accessor :setup_future_usage
1288
+
1289
+ def initialize(expires_after_days: nil, setup_future_usage: nil)
1290
+ @expires_after_days = expires_after_days
1291
+ @setup_future_usage = setup_future_usage
1292
+ end
1293
+ end
1294
+
1295
+ class P24 < Stripe::RequestParams
1296
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1297
+ #
1298
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1299
+ #
1300
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1301
+ #
1302
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1303
+ attr_accessor :setup_future_usage
1304
+ # Confirm that the payer has accepted the P24 terms and conditions.
1305
+ attr_accessor :tos_shown_and_accepted
1306
+
1307
+ def initialize(setup_future_usage: nil, tos_shown_and_accepted: nil)
1308
+ @setup_future_usage = setup_future_usage
1309
+ @tos_shown_and_accepted = tos_shown_and_accepted
1310
+ end
1311
+ end
1312
+
1313
+ class PayByBank < Stripe::RequestParams
1314
+ end
1315
+
1316
+ class Payco < Stripe::RequestParams
1317
+ # Controls when the funds will be captured from the customer's account.
1318
+ attr_accessor :capture_method
1319
+
1320
+ def initialize(capture_method: nil)
1321
+ @capture_method = capture_method
1322
+ end
1323
+ end
1324
+
1325
+ class Paynow < Stripe::RequestParams
1326
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1327
+ #
1328
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1329
+ #
1330
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1331
+ #
1332
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1333
+ attr_accessor :setup_future_usage
1334
+
1335
+ def initialize(setup_future_usage: nil)
1336
+ @setup_future_usage = setup_future_usage
1337
+ end
1338
+ end
1339
+
1340
+ class Paypal < Stripe::RequestParams
1341
+ # Controls when the funds will be captured from the customer's account.
1342
+ attr_accessor :capture_method
1343
+ # [Preferred locale](https://stripe.com/docs/payments/paypal/supported-locales) of the PayPal checkout page that the customer is redirected to.
1344
+ attr_accessor :preferred_locale
1345
+ # A reference of the PayPal transaction visible to customer which is mapped to PayPal's invoice ID. This must be a globally unique ID if you have configured in your PayPal settings to block multiple payments per invoice ID.
1346
+ attr_accessor :reference
1347
+ # The risk correlation ID for an on-session payment using a saved PayPal payment method.
1348
+ attr_accessor :risk_correlation_id
1349
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1350
+ #
1351
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1352
+ #
1353
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1354
+ #
1355
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1356
+ #
1357
+ # If you've already set `setup_future_usage` and you're performing a request using a publishable key, you can only update the value from `on_session` to `off_session`.
1358
+ attr_accessor :setup_future_usage
1359
+
1360
+ def initialize(
1361
+ capture_method: nil,
1362
+ preferred_locale: nil,
1363
+ reference: nil,
1364
+ risk_correlation_id: nil,
1365
+ setup_future_usage: nil
1366
+ )
1367
+ @capture_method = capture_method
1368
+ @preferred_locale = preferred_locale
1369
+ @reference = reference
1370
+ @risk_correlation_id = risk_correlation_id
1371
+ @setup_future_usage = setup_future_usage
1372
+ end
1373
+ end
1374
+
1375
+ class Pix < Stripe::RequestParams
1376
+ # The number of seconds (between 10 and 1209600) after which Pix payment will expire. Defaults to 86400 seconds.
1377
+ attr_accessor :expires_after_seconds
1378
+
1379
+ def initialize(expires_after_seconds: nil)
1380
+ @expires_after_seconds = expires_after_seconds
1381
+ end
1382
+ end
1383
+
1384
+ class RevolutPay < Stripe::RequestParams
1385
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1386
+ #
1387
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1388
+ #
1389
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1390
+ #
1391
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1392
+ attr_accessor :setup_future_usage
1393
+
1394
+ def initialize(setup_future_usage: nil)
1395
+ @setup_future_usage = setup_future_usage
1396
+ end
1397
+ end
1398
+
1399
+ class SamsungPay < Stripe::RequestParams
1400
+ # Controls when the funds will be captured from the customer's account.
1401
+ attr_accessor :capture_method
1402
+
1403
+ def initialize(capture_method: nil)
1404
+ @capture_method = capture_method
1405
+ end
1406
+ end
1407
+
1408
+ class SepaDebit < Stripe::RequestParams
1409
+ class MandateOptions < Stripe::RequestParams
1410
+ # Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: '/', '_', '-', '&', '.'. Cannot begin with 'STRIPE'.
1411
+ attr_accessor :reference_prefix
1412
+
1413
+ def initialize(reference_prefix: nil)
1414
+ @reference_prefix = reference_prefix
1415
+ end
1416
+ end
1417
+ # Additional fields for Mandate creation
1418
+ attr_accessor :mandate_options
1419
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1420
+ #
1421
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1422
+ #
1423
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1424
+ #
1425
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1426
+ attr_accessor :setup_future_usage
1427
+ # Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
1428
+ attr_accessor :target_date
1429
+
1430
+ def initialize(mandate_options: nil, setup_future_usage: nil, target_date: nil)
1431
+ @mandate_options = mandate_options
1432
+ @setup_future_usage = setup_future_usage
1433
+ @target_date = target_date
1434
+ end
1435
+ end
1436
+
1437
+ class Sofort < Stripe::RequestParams
1438
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1439
+ #
1440
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1441
+ #
1442
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1443
+ #
1444
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1445
+ attr_accessor :setup_future_usage
1446
+
1447
+ def initialize(setup_future_usage: nil)
1448
+ @setup_future_usage = setup_future_usage
1449
+ end
1450
+ end
1451
+
1452
+ class Swish < Stripe::RequestParams
1453
+ # The order reference that will be displayed to customers in the Swish application. Defaults to the `id` of the Payment Intent.
1454
+ attr_accessor :reference
1455
+
1456
+ def initialize(reference: nil)
1457
+ @reference = reference
1458
+ end
1459
+ end
1460
+
1461
+ class UsBankAccount < Stripe::RequestParams
1462
+ class FinancialConnections < Stripe::RequestParams
1463
+ # The list of permissions to request. If this parameter is passed, the `payment_method` permission must be included. Valid permissions include: `balances`, `ownership`, `payment_method`, and `transactions`.
1464
+ attr_accessor :permissions
1465
+ # List of data features that you would like to retrieve upon account creation.
1466
+ attr_accessor :prefetch
1467
+
1468
+ def initialize(permissions: nil, prefetch: nil)
1469
+ @permissions = permissions
1470
+ @prefetch = prefetch
1471
+ end
1472
+ end
1473
+ # Additional fields for Financial Connections Session creation
1474
+ attr_accessor :financial_connections
1475
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1476
+ #
1477
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1478
+ #
1479
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1480
+ #
1481
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1482
+ attr_accessor :setup_future_usage
1483
+ # Controls when Stripe will attempt to debit the funds from the customer's account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
1484
+ attr_accessor :target_date
1485
+ # Verification method for the intent
1486
+ attr_accessor :verification_method
1487
+
1488
+ def initialize(
1489
+ financial_connections: nil,
1490
+ setup_future_usage: nil,
1491
+ target_date: nil,
1492
+ verification_method: nil
1493
+ )
1494
+ @financial_connections = financial_connections
1495
+ @setup_future_usage = setup_future_usage
1496
+ @target_date = target_date
1497
+ @verification_method = verification_method
1498
+ end
1499
+ end
1500
+
1501
+ class WechatPay < Stripe::RequestParams
1502
+ # The app ID registered with WeChat Pay. Only required when client is ios or android.
1503
+ attr_accessor :app_id
1504
+ # The client type that the end customer will pay from
1505
+ attr_accessor :client
1506
+ # Indicates that you intend to make future payments with this PaymentIntent's payment method.
1507
+ #
1508
+ # If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
1509
+ #
1510
+ # If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
1511
+ #
1512
+ # When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
1513
+ attr_accessor :setup_future_usage
1514
+
1515
+ def initialize(app_id: nil, client: nil, setup_future_usage: nil)
1516
+ @app_id = app_id
1517
+ @client = client
1518
+ @setup_future_usage = setup_future_usage
1519
+ end
1520
+ end
1521
+ # contains details about the ACSS Debit payment method options.
1522
+ attr_accessor :acss_debit
1523
+ # contains details about the Affirm payment method options.
1524
+ attr_accessor :affirm
1525
+ # contains details about the Afterpay Clearpay payment method options.
1526
+ attr_accessor :afterpay_clearpay
1527
+ # contains details about the Alipay payment method options.
1528
+ attr_accessor :alipay
1529
+ # contains details about the AmazonPay payment method options.
1530
+ attr_accessor :amazon_pay
1531
+ # contains details about the AU Becs Debit payment method options.
1532
+ attr_accessor :au_becs_debit
1533
+ # contains details about the Bacs Debit payment method options.
1534
+ attr_accessor :bacs_debit
1535
+ # contains details about the Bancontact payment method options.
1536
+ attr_accessor :bancontact
1537
+ # contains details about the Boleto payment method options.
1538
+ attr_accessor :boleto
1539
+ # contains details about the Card payment method options.
1540
+ attr_accessor :card
1541
+ # contains details about the Cashapp Pay payment method options.
1542
+ attr_accessor :cashapp
1543
+ # contains details about the Customer Balance payment method options.
1544
+ attr_accessor :customer_balance
1545
+ # contains details about the EPS payment method options.
1546
+ attr_accessor :eps
1547
+ # contains details about the FPX payment method options.
1548
+ attr_accessor :fpx
1549
+ # contains details about the Giropay payment method options.
1550
+ attr_accessor :giropay
1551
+ # contains details about the Grabpay payment method options.
1552
+ attr_accessor :grabpay
1553
+ # contains details about the Ideal payment method options.
1554
+ attr_accessor :ideal
1555
+ # contains details about the Kakao Pay payment method options.
1556
+ attr_accessor :kakao_pay
1557
+ # contains details about the Klarna payment method options.
1558
+ attr_accessor :klarna
1559
+ # contains details about the Konbini payment method options.
1560
+ attr_accessor :konbini
1561
+ # contains details about the Korean card payment method options.
1562
+ attr_accessor :kr_card
1563
+ # contains details about the Link payment method options.
1564
+ attr_accessor :link
1565
+ # contains details about the Mobilepay payment method options.
1566
+ attr_accessor :mobilepay
1567
+ # contains details about the Multibanco payment method options.
1568
+ attr_accessor :multibanco
1569
+ # contains details about the Naver Pay payment method options.
1570
+ attr_accessor :naver_pay
1571
+ # contains details about the OXXO payment method options.
1572
+ attr_accessor :oxxo
1573
+ # contains details about the P24 payment method options.
1574
+ attr_accessor :p24
1575
+ # contains details about the Pay By Bank payment method options.
1576
+ attr_accessor :pay_by_bank
1577
+ # contains details about the PAYCO payment method options.
1578
+ attr_accessor :payco
1579
+ # contains details about the PayNow payment method options.
1580
+ attr_accessor :paynow
1581
+ # contains details about the PayPal payment method options.
1582
+ attr_accessor :paypal
1583
+ # contains details about the Pix payment method options.
1584
+ attr_accessor :pix
1585
+ # contains details about the RevolutPay payment method options.
1586
+ attr_accessor :revolut_pay
1587
+ # contains details about the Samsung Pay payment method options.
1588
+ attr_accessor :samsung_pay
1589
+ # contains details about the Sepa Debit payment method options.
1590
+ attr_accessor :sepa_debit
1591
+ # contains details about the Sofort payment method options.
1592
+ attr_accessor :sofort
1593
+ # contains details about the Swish payment method options.
1594
+ attr_accessor :swish
1595
+ # contains details about the Us Bank Account payment method options.
1596
+ attr_accessor :us_bank_account
1597
+ # contains details about the WeChat Pay payment method options.
1598
+ attr_accessor :wechat_pay
1599
+
1600
+ def initialize(
1601
+ acss_debit: nil,
1602
+ affirm: nil,
1603
+ afterpay_clearpay: nil,
1604
+ alipay: nil,
1605
+ amazon_pay: nil,
1606
+ au_becs_debit: nil,
1607
+ bacs_debit: nil,
1608
+ bancontact: nil,
1609
+ boleto: nil,
1610
+ card: nil,
1611
+ cashapp: nil,
1612
+ customer_balance: nil,
1613
+ eps: nil,
1614
+ fpx: nil,
1615
+ giropay: nil,
1616
+ grabpay: nil,
1617
+ ideal: nil,
1618
+ kakao_pay: nil,
1619
+ klarna: nil,
1620
+ konbini: nil,
1621
+ kr_card: nil,
1622
+ link: nil,
1623
+ mobilepay: nil,
1624
+ multibanco: nil,
1625
+ naver_pay: nil,
1626
+ oxxo: nil,
1627
+ p24: nil,
1628
+ pay_by_bank: nil,
1629
+ payco: nil,
1630
+ paynow: nil,
1631
+ paypal: nil,
1632
+ pix: nil,
1633
+ revolut_pay: nil,
1634
+ samsung_pay: nil,
1635
+ sepa_debit: nil,
1636
+ sofort: nil,
1637
+ swish: nil,
1638
+ us_bank_account: nil,
1639
+ wechat_pay: nil
1640
+ )
1641
+ @acss_debit = acss_debit
1642
+ @affirm = affirm
1643
+ @afterpay_clearpay = afterpay_clearpay
1644
+ @alipay = alipay
1645
+ @amazon_pay = amazon_pay
1646
+ @au_becs_debit = au_becs_debit
1647
+ @bacs_debit = bacs_debit
1648
+ @bancontact = bancontact
1649
+ @boleto = boleto
1650
+ @card = card
1651
+ @cashapp = cashapp
1652
+ @customer_balance = customer_balance
1653
+ @eps = eps
1654
+ @fpx = fpx
1655
+ @giropay = giropay
1656
+ @grabpay = grabpay
1657
+ @ideal = ideal
1658
+ @kakao_pay = kakao_pay
1659
+ @klarna = klarna
1660
+ @konbini = konbini
1661
+ @kr_card = kr_card
1662
+ @link = link
1663
+ @mobilepay = mobilepay
1664
+ @multibanco = multibanco
1665
+ @naver_pay = naver_pay
1666
+ @oxxo = oxxo
1667
+ @p24 = p24
1668
+ @pay_by_bank = pay_by_bank
1669
+ @payco = payco
1670
+ @paynow = paynow
1671
+ @paypal = paypal
1672
+ @pix = pix
1673
+ @revolut_pay = revolut_pay
1674
+ @samsung_pay = samsung_pay
1675
+ @sepa_debit = sepa_debit
1676
+ @sofort = sofort
1677
+ @swish = swish
1678
+ @us_bank_account = us_bank_account
1679
+ @wechat_pay = wechat_pay
1680
+ end
1681
+ end
1682
+
1683
+ class Permissions < Stripe::RequestParams
1684
+ # Determines which entity is allowed to update the shipping details.
1685
+ #
1686
+ # Default is `client_only`. Stripe Checkout client will automatically update the shipping details. If set to `server_only`, only your server is allowed to update the shipping details.
1687
+ #
1688
+ # When set to `server_only`, you must add the onShippingDetailsChange event handler when initializing the Stripe Checkout client and manually update the shipping details from your server using the Stripe API.
1689
+ attr_accessor :update_shipping_details
1690
+
1691
+ def initialize(update_shipping_details: nil)
1692
+ @update_shipping_details = update_shipping_details
1693
+ end
1694
+ end
1695
+
1696
+ class PhoneNumberCollection < Stripe::RequestParams
1697
+ # Set to `true` to enable phone number collection.
1698
+ #
1699
+ # Can only be set in `payment` and `subscription` mode.
1700
+ attr_accessor :enabled
1701
+
1702
+ def initialize(enabled: nil)
1703
+ @enabled = enabled
1704
+ end
1705
+ end
1706
+
1707
+ class SavedPaymentMethodOptions < Stripe::RequestParams
1708
+ # Uses the `allow_redisplay` value of each saved payment method to filter the set presented to a returning customer. By default, only saved payment methods with ’allow_redisplay: ‘always’ are shown in Checkout.
1709
+ attr_accessor :allow_redisplay_filters
1710
+ # Enable customers to choose if they wish to save their payment method for future use. Disabled by default.
1711
+ attr_accessor :payment_method_save
1712
+
1713
+ def initialize(allow_redisplay_filters: nil, payment_method_save: nil)
1714
+ @allow_redisplay_filters = allow_redisplay_filters
1715
+ @payment_method_save = payment_method_save
1716
+ end
1717
+ end
1718
+
1719
+ class SetupIntentData < Stripe::RequestParams
1720
+ # An arbitrary string attached to the object. Often useful for displaying to users.
1721
+ attr_accessor :description
1722
+ # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
1723
+ attr_accessor :metadata
1724
+ # The Stripe account for which the setup is intended.
1725
+ attr_accessor :on_behalf_of
1726
+
1727
+ def initialize(description: nil, metadata: nil, on_behalf_of: nil)
1728
+ @description = description
1729
+ @metadata = metadata
1730
+ @on_behalf_of = on_behalf_of
1731
+ end
1732
+ end
1733
+
1734
+ class ShippingAddressCollection < Stripe::RequestParams
1735
+ # An array of two-letter ISO country codes representing which countries Checkout should provide as options for
1736
+ # shipping locations.
1737
+ attr_accessor :allowed_countries
1738
+
1739
+ def initialize(allowed_countries: nil)
1740
+ @allowed_countries = allowed_countries
1741
+ end
1742
+ end
1743
+
1744
+ class ShippingOption < Stripe::RequestParams
1745
+ class ShippingRateData < Stripe::RequestParams
1746
+ class DeliveryEstimate < Stripe::RequestParams
1747
+ class Maximum < Stripe::RequestParams
1748
+ # A unit of time.
1749
+ attr_accessor :unit
1750
+ # Must be greater than 0.
1751
+ attr_accessor :value
1752
+
1753
+ def initialize(unit: nil, value: nil)
1754
+ @unit = unit
1755
+ @value = value
1756
+ end
1757
+ end
1758
+
1759
+ class Minimum < Stripe::RequestParams
1760
+ # A unit of time.
1761
+ attr_accessor :unit
1762
+ # Must be greater than 0.
1763
+ attr_accessor :value
1764
+
1765
+ def initialize(unit: nil, value: nil)
1766
+ @unit = unit
1767
+ @value = value
1768
+ end
1769
+ end
1770
+ # The upper bound of the estimated range. If empty, represents no upper bound i.e., infinite.
1771
+ attr_accessor :maximum
1772
+ # The lower bound of the estimated range. If empty, represents no lower bound.
1773
+ attr_accessor :minimum
1774
+
1775
+ def initialize(maximum: nil, minimum: nil)
1776
+ @maximum = maximum
1777
+ @minimum = minimum
1778
+ end
1779
+ end
1780
+
1781
+ class FixedAmount < Stripe::RequestParams
1782
+ class CurrencyOptions < Stripe::RequestParams
1783
+ # A non-negative integer in cents representing how much to charge.
1784
+ attr_accessor :amount
1785
+ # Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`.
1786
+ attr_accessor :tax_behavior
1787
+
1788
+ def initialize(amount: nil, tax_behavior: nil)
1789
+ @amount = amount
1790
+ @tax_behavior = tax_behavior
1791
+ end
1792
+ end
1793
+ # A non-negative integer in cents representing how much to charge.
1794
+ attr_accessor :amount
1795
+ # 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).
1796
+ attr_accessor :currency
1797
+ # Shipping rates 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).
1798
+ attr_accessor :currency_options
1799
+
1800
+ def initialize(amount: nil, currency: nil, currency_options: nil)
1801
+ @amount = amount
1802
+ @currency = currency
1803
+ @currency_options = currency_options
1804
+ end
1805
+ end
1806
+ # The estimated range for how long shipping will take, meant to be displayable to the customer. This will appear on CheckoutSessions.
1807
+ attr_accessor :delivery_estimate
1808
+ # The name of the shipping rate, meant to be displayable to the customer. This will appear on CheckoutSessions.
1809
+ attr_accessor :display_name
1810
+ # Describes a fixed amount to charge for shipping. Must be present if type is `fixed_amount`.
1811
+ attr_accessor :fixed_amount
1812
+ # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
1813
+ attr_accessor :metadata
1814
+ # Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`.
1815
+ attr_accessor :tax_behavior
1816
+ # A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`.
1817
+ attr_accessor :tax_code
1818
+ # The type of calculation to use on the shipping rate.
1819
+ attr_accessor :type
1820
+
1821
+ def initialize(
1822
+ delivery_estimate: nil,
1823
+ display_name: nil,
1824
+ fixed_amount: nil,
1825
+ metadata: nil,
1826
+ tax_behavior: nil,
1827
+ tax_code: nil,
1828
+ type: nil
1829
+ )
1830
+ @delivery_estimate = delivery_estimate
1831
+ @display_name = display_name
1832
+ @fixed_amount = fixed_amount
1833
+ @metadata = metadata
1834
+ @tax_behavior = tax_behavior
1835
+ @tax_code = tax_code
1836
+ @type = type
1837
+ end
1838
+ end
1839
+ # The ID of the Shipping Rate to use for this shipping option.
1840
+ attr_accessor :shipping_rate
1841
+ # Parameters to be passed to Shipping Rate creation for this shipping option.
1842
+ attr_accessor :shipping_rate_data
1843
+
1844
+ def initialize(shipping_rate: nil, shipping_rate_data: nil)
1845
+ @shipping_rate = shipping_rate
1846
+ @shipping_rate_data = shipping_rate_data
1847
+ end
1848
+ end
1849
+
1850
+ class SubscriptionData < Stripe::RequestParams
1851
+ class InvoiceSettings < Stripe::RequestParams
1852
+ class Issuer < Stripe::RequestParams
1853
+ # The connected account being referenced when `type` is `account`.
1854
+ attr_accessor :account
1855
+ # Type of the account referenced in the request.
1856
+ attr_accessor :type
1857
+
1858
+ def initialize(account: nil, type: nil)
1859
+ @account = account
1860
+ @type = type
1861
+ end
1862
+ end
1863
+ # The connected account that issues the invoice. The invoice is presented with the branding and support information of the specified account.
1864
+ attr_accessor :issuer
1865
+
1866
+ def initialize(issuer: nil)
1867
+ @issuer = issuer
1868
+ end
1869
+ end
1870
+
1871
+ class TransferData < Stripe::RequestParams
1872
+ # A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the destination account. By default, the entire amount is transferred to the destination.
1873
+ attr_accessor :amount_percent
1874
+ # ID of an existing, connected Stripe account.
1875
+ attr_accessor :destination
1876
+
1877
+ def initialize(amount_percent: nil, destination: nil)
1878
+ @amount_percent = amount_percent
1879
+ @destination = destination
1880
+ end
1881
+ end
1882
+
1883
+ class TrialSettings < Stripe::RequestParams
1884
+ class EndBehavior < Stripe::RequestParams
1885
+ # Indicates how the subscription should change when the trial ends if the user did not provide a payment method.
1886
+ attr_accessor :missing_payment_method
1887
+
1888
+ def initialize(missing_payment_method: nil)
1889
+ @missing_payment_method = missing_payment_method
1890
+ end
1891
+ end
1892
+ # Defines how the subscription should behave when the user's free trial ends.
1893
+ attr_accessor :end_behavior
1894
+
1895
+ def initialize(end_behavior: nil)
1896
+ @end_behavior = end_behavior
1897
+ end
1898
+ end
1899
+ # A non-negative decimal between 0 and 100, with at most two decimal places. This represents the percentage of the subscription invoice total that will be transferred to the application owner's Stripe account. To use an application fee percent, the request must be made on behalf of another account, using the `Stripe-Account` header or an OAuth key. For more information, see the application fees [documentation](https://stripe.com/docs/connect/subscriptions#collecting-fees-on-subscriptions).
1900
+ attr_accessor :application_fee_percent
1901
+ # A future timestamp to anchor the subscription's billing cycle for new subscriptions.
1902
+ attr_accessor :billing_cycle_anchor
1903
+ # The tax rates that will apply to any subscription item that does not have
1904
+ # `tax_rates` set. Invoices created will have their `default_tax_rates` populated
1905
+ # from the subscription.
1906
+ attr_accessor :default_tax_rates
1907
+ # The subscription's description, meant to be displayable to the customer.
1908
+ # Use this field to optionally store an explanation of the subscription
1909
+ # for rendering in the [customer portal](https://stripe.com/docs/customer-management).
1910
+ attr_accessor :description
1911
+ # All invoices will be billed using the specified settings.
1912
+ attr_accessor :invoice_settings
1913
+ # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
1914
+ attr_accessor :metadata
1915
+ # The account on behalf of which to charge, for each of the subscription's invoices.
1916
+ attr_accessor :on_behalf_of
1917
+ # Determines how to handle prorations resulting from the `billing_cycle_anchor`. If no value is passed, the default is `create_prorations`.
1918
+ attr_accessor :proration_behavior
1919
+ # If specified, the funds from the subscription's invoices will be transferred to the destination and the ID of the resulting transfers will be found on the resulting charges.
1920
+ attr_accessor :transfer_data
1921
+ # Unix timestamp representing the end of the trial period the customer
1922
+ # will get before being charged for the first time. Has to be at least
1923
+ # 48 hours in the future.
1924
+ attr_accessor :trial_end
1925
+ # Integer representing the number of trial period days before the
1926
+ # customer is charged for the first time. Has to be at least 1.
1927
+ attr_accessor :trial_period_days
1928
+ # Settings related to subscription trials.
1929
+ attr_accessor :trial_settings
1930
+
1931
+ def initialize(
1932
+ application_fee_percent: nil,
1933
+ billing_cycle_anchor: nil,
1934
+ default_tax_rates: nil,
1935
+ description: nil,
1936
+ invoice_settings: nil,
1937
+ metadata: nil,
1938
+ on_behalf_of: nil,
1939
+ proration_behavior: nil,
1940
+ transfer_data: nil,
1941
+ trial_end: nil,
1942
+ trial_period_days: nil,
1943
+ trial_settings: nil
1944
+ )
1945
+ @application_fee_percent = application_fee_percent
1946
+ @billing_cycle_anchor = billing_cycle_anchor
1947
+ @default_tax_rates = default_tax_rates
1948
+ @description = description
1949
+ @invoice_settings = invoice_settings
1950
+ @metadata = metadata
1951
+ @on_behalf_of = on_behalf_of
1952
+ @proration_behavior = proration_behavior
1953
+ @transfer_data = transfer_data
1954
+ @trial_end = trial_end
1955
+ @trial_period_days = trial_period_days
1956
+ @trial_settings = trial_settings
1957
+ end
1958
+ end
1959
+
1960
+ class TaxIdCollection < Stripe::RequestParams
1961
+ # Enable tax ID collection during checkout. Defaults to `false`.
1962
+ attr_accessor :enabled
1963
+ # Describes whether a tax ID is required during checkout. Defaults to `never`.
1964
+ attr_accessor :required
1965
+
1966
+ def initialize(enabled: nil, required: nil)
1967
+ @enabled = enabled
1968
+ @required = required
1969
+ end
1970
+ end
1971
+ # Settings for price localization with [Adaptive Pricing](https://docs.stripe.com/payments/checkout/adaptive-pricing).
1972
+ attr_accessor :adaptive_pricing
1973
+ # Configure actions after a Checkout Session has expired.
1974
+ attr_accessor :after_expiration
1975
+ # Enables user redeemable promotion codes.
1976
+ attr_accessor :allow_promotion_codes
1977
+ # Settings for automatic tax lookup for this session and resulting payments, invoices, and subscriptions.
1978
+ attr_accessor :automatic_tax
1979
+ # Specify whether Checkout should collect the customer's billing address. Defaults to `auto`.
1980
+ attr_accessor :billing_address_collection
1981
+ # If set, Checkout displays a back button and customers will be directed to this URL if they decide to cancel payment and return to your website. This parameter is not allowed if ui_mode is `embedded` or `custom`.
1982
+ attr_accessor :cancel_url
1983
+ # A unique string to reference the Checkout Session. This can be a
1984
+ # customer ID, a cart ID, or similar, and can be used to reconcile the
1985
+ # session with your internal systems.
1986
+ attr_accessor :client_reference_id
1987
+ # Configure fields for the Checkout Session to gather active consent from customers.
1988
+ attr_accessor :consent_collection
1989
+ # 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). Required in `setup` mode when `payment_method_types` is not set.
1990
+ attr_accessor :currency
1991
+ # Collect additional information from your customer using custom fields. Up to 3 fields are supported.
1992
+ attr_accessor :custom_fields
1993
+ # Display additional text for your customers using custom text.
1994
+ attr_accessor :custom_text
1995
+ # ID of an existing Customer, if one exists. In `payment` mode, the customer’s most recently saved card
1996
+ # payment method will be used to prefill the email, name, card details, and billing address
1997
+ # on the Checkout page. In `subscription` mode, the customer’s [default payment method](https://stripe.com/docs/api/customers/update#update_customer-invoice_settings-default_payment_method)
1998
+ # will be used if it’s a card, otherwise the most recently saved card will be used. A valid billing address, billing name and billing email are required on the payment method for Checkout to prefill the customer's card details.
1999
+ #
2000
+ # If the Customer already has a valid [email](https://stripe.com/docs/api/customers/object#customer_object-email) set, the email will be prefilled and not editable in Checkout.
2001
+ # If the Customer does not have a valid `email`, Checkout will set the email entered during the session on the Customer.
2002
+ #
2003
+ # If blank for Checkout Sessions in `subscription` mode or with `customer_creation` set as `always` in `payment` mode, Checkout will create a new Customer object based on information provided during the payment flow.
2004
+ #
2005
+ # You can set [`payment_intent_data.setup_future_usage`](https://stripe.com/docs/api/checkout/sessions/create#create_checkout_session-payment_intent_data-setup_future_usage) to have Checkout automatically attach the payment method to the Customer you pass in for future reuse.
2006
+ attr_accessor :customer
2007
+ # Configure whether a Checkout Session creates a [Customer](https://stripe.com/docs/api/customers) during Session confirmation.
2008
+ #
2009
+ # When a Customer is not created, you can still retrieve email, address, and other customer data entered in Checkout
2010
+ # with [customer_details](https://stripe.com/docs/api/checkout/sessions/object#checkout_session_object-customer_details).
2011
+ #
2012
+ # Sessions that don't create Customers instead are grouped by [guest customers](https://stripe.com/docs/payments/checkout/guest-customers)
2013
+ # in the Dashboard. Promotion codes limited to first time customers will return invalid for these Sessions.
2014
+ #
2015
+ # Can only be set in `payment` and `setup` mode.
2016
+ attr_accessor :customer_creation
2017
+ # If provided, this value will be used when the Customer object is created.
2018
+ # If not provided, customers will be asked to enter their email address.
2019
+ # Use this parameter to prefill customer data if you already have an email
2020
+ # on file. To access information about the customer once a session is
2021
+ # complete, use the `customer` field.
2022
+ attr_accessor :customer_email
2023
+ # Controls what fields on Customer can be updated by the Checkout Session. Can only be provided when `customer` is provided.
2024
+ attr_accessor :customer_update
2025
+ # The coupon or promotion code to apply to this Session. Currently, only up to one may be specified.
2026
+ attr_accessor :discounts
2027
+ # Specifies which fields in the response should be expanded.
2028
+ attr_accessor :expand
2029
+ # The Epoch time in seconds at which the Checkout Session will expire. It can be anywhere from 30 minutes to 24 hours after Checkout Session creation. By default, this value is 24 hours from creation.
2030
+ attr_accessor :expires_at
2031
+ # Generate a post-purchase Invoice for one-time payments.
2032
+ attr_accessor :invoice_creation
2033
+ # A list of items the customer is purchasing. Use this parameter to pass one-time or recurring [Prices](https://stripe.com/docs/api/prices).
2034
+ #
2035
+ # For `payment` mode, there is a maximum of 100 line items, however it is recommended to consolidate line items if there are more than a few dozen.
2036
+ #
2037
+ # For `subscription` mode, there is a maximum of 20 line items with recurring Prices and 20 line items with one-time Prices. Line items with one-time Prices will be on the initial invoice only.
2038
+ attr_accessor :line_items
2039
+ # The IETF language tag of the locale Checkout is displayed in. If blank or `auto`, the browser's locale is used.
2040
+ attr_accessor :locale
2041
+ # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
2042
+ attr_accessor :metadata
2043
+ # The mode of the Checkout Session. Pass `subscription` if the Checkout Session includes at least one recurring item.
2044
+ attr_accessor :mode
2045
+ # A list of optional items the customer can add to their order at checkout. Use this parameter to pass one-time or recurring [Prices](https://stripe.com/docs/api/prices).
2046
+ #
2047
+ # There is a maximum of 10 optional items allowed on a Checkout Session, and the existing limits on the number of line items allowed on a Checkout Session apply to the combined number of line items and optional items.
2048
+ #
2049
+ # For `payment` mode, there is a maximum of 100 combined line items and optional items, however it is recommended to consolidate items if there are more than a few dozen.
2050
+ #
2051
+ # For `subscription` mode, there is a maximum of 20 line items and optional items with recurring Prices and 20 line items and optional items with one-time Prices.
2052
+ attr_accessor :optional_items
2053
+ # A subset of parameters to be passed to PaymentIntent creation for Checkout Sessions in `payment` mode.
2054
+ attr_accessor :payment_intent_data
2055
+ # Specify whether Checkout should collect a payment method. When set to `if_required`, Checkout will not collect a payment method when the total due for the session is 0.
2056
+ # This may occur if the Checkout Session includes a free trial or a discount.
2057
+ #
2058
+ # Can only be set in `subscription` mode. Defaults to `always`.
2059
+ #
2060
+ # If you'd like information on how to collect a payment method outside of Checkout, read the guide on configuring [subscriptions with a free trial](https://stripe.com/docs/payments/checkout/free-trials).
2061
+ attr_accessor :payment_method_collection
2062
+ # The ID of the payment method configuration to use with this Checkout session.
2063
+ attr_accessor :payment_method_configuration
2064
+ # This parameter allows you to set some attributes on the payment method created during a Checkout session.
2065
+ attr_accessor :payment_method_data
2066
+ # Payment-method-specific configuration.
2067
+ attr_accessor :payment_method_options
2068
+ # A list of the types of payment methods (e.g., `card`) this Checkout Session can accept.
2069
+ #
2070
+ # You can omit this attribute to manage your payment methods from the [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods).
2071
+ # See [Dynamic Payment Methods](https://stripe.com/docs/payments/payment-methods/integration-options#using-dynamic-payment-methods) for more details.
2072
+ #
2073
+ # Read more about the supported payment methods and their requirements in our [payment
2074
+ # method details guide](/docs/payments/checkout/payment-methods).
2075
+ #
2076
+ # If multiple payment methods are passed, Checkout will dynamically reorder them to
2077
+ # prioritize the most relevant payment methods based on the customer's location and
2078
+ # other characteristics.
2079
+ attr_accessor :payment_method_types
2080
+ # This property is used to set up permissions for various actions (e.g., update) on the CheckoutSession object.
2081
+ #
2082
+ # For specific permissions, please refer to their dedicated subsections, such as `permissions.update.shipping_details`.
2083
+ attr_accessor :permissions
2084
+ # Controls phone number collection settings for the session.
2085
+ #
2086
+ # We recommend that you review your privacy policy and check with your legal contacts
2087
+ # before using this feature. Learn more about [collecting phone numbers with Checkout](https://stripe.com/docs/payments/checkout/phone-numbers).
2088
+ attr_accessor :phone_number_collection
2089
+ # This parameter applies to `ui_mode: embedded`. Learn more about the [redirect behavior](https://stripe.com/docs/payments/checkout/custom-success-page?payment-ui=embedded-form) of embedded sessions. Defaults to `always`.
2090
+ attr_accessor :redirect_on_completion
2091
+ # The URL to redirect your customer back to after they authenticate or cancel their payment on the
2092
+ # payment method's app or site. This parameter is required if `ui_mode` is `embedded` or `custom`
2093
+ # and redirect-based payment methods are enabled on the session.
2094
+ attr_accessor :return_url
2095
+ # Controls saved payment method settings for the session. Only available in `payment` and `subscription` mode.
2096
+ attr_accessor :saved_payment_method_options
2097
+ # A subset of parameters to be passed to SetupIntent creation for Checkout Sessions in `setup` mode.
2098
+ attr_accessor :setup_intent_data
2099
+ # When set, provides configuration for Checkout to collect a shipping address from a customer.
2100
+ attr_accessor :shipping_address_collection
2101
+ # The shipping rate options to apply to this Session. Up to a maximum of 5.
2102
+ attr_accessor :shipping_options
2103
+ # Describes the type of transaction being performed by Checkout in order
2104
+ # to customize relevant text on the page, such as the submit button.
2105
+ # `submit_type` can only be specified on Checkout Sessions in
2106
+ # `payment` or `subscription` mode. If blank or `auto`, `pay` is used.
2107
+ attr_accessor :submit_type
2108
+ # A subset of parameters to be passed to subscription creation for Checkout Sessions in `subscription` mode.
2109
+ attr_accessor :subscription_data
2110
+ # The URL to which Stripe should send customers when payment or setup
2111
+ # is complete.
2112
+ # This parameter is not allowed if ui_mode is `embedded` or `custom`. If you'd like to use
2113
+ # information from the successful Checkout Session on your page, read the
2114
+ # guide on [customizing your success page](https://stripe.com/docs/payments/checkout/custom-success-page).
2115
+ attr_accessor :success_url
2116
+ # Controls tax ID collection during checkout.
2117
+ attr_accessor :tax_id_collection
2118
+ # The UI mode of the Session. Defaults to `hosted`.
2119
+ attr_accessor :ui_mode
2120
+
2121
+ def initialize(
2122
+ adaptive_pricing: nil,
2123
+ after_expiration: nil,
2124
+ allow_promotion_codes: nil,
2125
+ automatic_tax: nil,
2126
+ billing_address_collection: nil,
2127
+ cancel_url: nil,
2128
+ client_reference_id: nil,
2129
+ consent_collection: nil,
2130
+ currency: nil,
2131
+ custom_fields: nil,
2132
+ custom_text: nil,
2133
+ customer: nil,
2134
+ customer_creation: nil,
2135
+ customer_email: nil,
2136
+ customer_update: nil,
2137
+ discounts: nil,
2138
+ expand: nil,
2139
+ expires_at: nil,
2140
+ invoice_creation: nil,
2141
+ line_items: nil,
2142
+ locale: nil,
2143
+ metadata: nil,
2144
+ mode: nil,
2145
+ optional_items: nil,
2146
+ payment_intent_data: nil,
2147
+ payment_method_collection: nil,
2148
+ payment_method_configuration: nil,
2149
+ payment_method_data: nil,
2150
+ payment_method_options: nil,
2151
+ payment_method_types: nil,
2152
+ permissions: nil,
2153
+ phone_number_collection: nil,
2154
+ redirect_on_completion: nil,
2155
+ return_url: nil,
2156
+ saved_payment_method_options: nil,
2157
+ setup_intent_data: nil,
2158
+ shipping_address_collection: nil,
2159
+ shipping_options: nil,
2160
+ submit_type: nil,
2161
+ subscription_data: nil,
2162
+ success_url: nil,
2163
+ tax_id_collection: nil,
2164
+ ui_mode: nil
2165
+ )
2166
+ @adaptive_pricing = adaptive_pricing
2167
+ @after_expiration = after_expiration
2168
+ @allow_promotion_codes = allow_promotion_codes
2169
+ @automatic_tax = automatic_tax
2170
+ @billing_address_collection = billing_address_collection
2171
+ @cancel_url = cancel_url
2172
+ @client_reference_id = client_reference_id
2173
+ @consent_collection = consent_collection
2174
+ @currency = currency
2175
+ @custom_fields = custom_fields
2176
+ @custom_text = custom_text
2177
+ @customer = customer
2178
+ @customer_creation = customer_creation
2179
+ @customer_email = customer_email
2180
+ @customer_update = customer_update
2181
+ @discounts = discounts
2182
+ @expand = expand
2183
+ @expires_at = expires_at
2184
+ @invoice_creation = invoice_creation
2185
+ @line_items = line_items
2186
+ @locale = locale
2187
+ @metadata = metadata
2188
+ @mode = mode
2189
+ @optional_items = optional_items
2190
+ @payment_intent_data = payment_intent_data
2191
+ @payment_method_collection = payment_method_collection
2192
+ @payment_method_configuration = payment_method_configuration
2193
+ @payment_method_data = payment_method_data
2194
+ @payment_method_options = payment_method_options
2195
+ @payment_method_types = payment_method_types
2196
+ @permissions = permissions
2197
+ @phone_number_collection = phone_number_collection
2198
+ @redirect_on_completion = redirect_on_completion
2199
+ @return_url = return_url
2200
+ @saved_payment_method_options = saved_payment_method_options
2201
+ @setup_intent_data = setup_intent_data
2202
+ @shipping_address_collection = shipping_address_collection
2203
+ @shipping_options = shipping_options
2204
+ @submit_type = submit_type
2205
+ @subscription_data = subscription_data
2206
+ @success_url = success_url
2207
+ @tax_id_collection = tax_id_collection
2208
+ @ui_mode = ui_mode
2209
+ end
2210
+ end
2211
+
2212
+ class RetrieveParams < Stripe::RequestParams
2213
+ # Specifies which fields in the response should be expanded.
2214
+ attr_accessor :expand
2215
+
2216
+ def initialize(expand: nil)
2217
+ @expand = expand
2218
+ end
2219
+ end
2220
+
2221
+ class UpdateParams < Stripe::RequestParams
2222
+ class CollectedInformation < Stripe::RequestParams
2223
+ class ShippingDetails < Stripe::RequestParams
2224
+ class Address < Stripe::RequestParams
2225
+ # City, district, suburb, town, or village.
2226
+ attr_accessor :city
2227
+ # Two-letter country code ([ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
2228
+ attr_accessor :country
2229
+ # Address line 1 (e.g., street, PO Box, or company name).
2230
+ attr_accessor :line1
2231
+ # Address line 2 (e.g., apartment, suite, unit, or building).
2232
+ attr_accessor :line2
2233
+ # ZIP or postal code.
2234
+ attr_accessor :postal_code
2235
+ # State, county, province, or region.
2236
+ attr_accessor :state
2237
+
2238
+ def initialize(
2239
+ city: nil,
2240
+ country: nil,
2241
+ line1: nil,
2242
+ line2: nil,
2243
+ postal_code: nil,
2244
+ state: nil
2245
+ )
2246
+ @city = city
2247
+ @country = country
2248
+ @line1 = line1
2249
+ @line2 = line2
2250
+ @postal_code = postal_code
2251
+ @state = state
2252
+ end
2253
+ end
2254
+ # The address of the customer
2255
+ attr_accessor :address
2256
+ # The name of customer
2257
+ attr_accessor :name
2258
+
2259
+ def initialize(address: nil, name: nil)
2260
+ @address = address
2261
+ @name = name
2262
+ end
2263
+ end
2264
+ # The shipping details to apply to this Session.
2265
+ attr_accessor :shipping_details
2266
+
2267
+ def initialize(shipping_details: nil)
2268
+ @shipping_details = shipping_details
2269
+ end
2270
+ end
2271
+
2272
+ class ShippingOption < Stripe::RequestParams
2273
+ class ShippingRateData < Stripe::RequestParams
2274
+ class DeliveryEstimate < Stripe::RequestParams
2275
+ class Maximum < Stripe::RequestParams
2276
+ # A unit of time.
2277
+ attr_accessor :unit
2278
+ # Must be greater than 0.
2279
+ attr_accessor :value
2280
+
2281
+ def initialize(unit: nil, value: nil)
2282
+ @unit = unit
2283
+ @value = value
2284
+ end
2285
+ end
2286
+
2287
+ class Minimum < Stripe::RequestParams
2288
+ # A unit of time.
2289
+ attr_accessor :unit
2290
+ # Must be greater than 0.
2291
+ attr_accessor :value
2292
+
2293
+ def initialize(unit: nil, value: nil)
2294
+ @unit = unit
2295
+ @value = value
2296
+ end
2297
+ end
2298
+ # The upper bound of the estimated range. If empty, represents no upper bound i.e., infinite.
2299
+ attr_accessor :maximum
2300
+ # The lower bound of the estimated range. If empty, represents no lower bound.
2301
+ attr_accessor :minimum
2302
+
2303
+ def initialize(maximum: nil, minimum: nil)
2304
+ @maximum = maximum
2305
+ @minimum = minimum
2306
+ end
2307
+ end
2308
+
2309
+ class FixedAmount < Stripe::RequestParams
2310
+ class CurrencyOptions < Stripe::RequestParams
2311
+ # A non-negative integer in cents representing how much to charge.
2312
+ attr_accessor :amount
2313
+ # Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`.
2314
+ attr_accessor :tax_behavior
2315
+
2316
+ def initialize(amount: nil, tax_behavior: nil)
2317
+ @amount = amount
2318
+ @tax_behavior = tax_behavior
2319
+ end
2320
+ end
2321
+ # A non-negative integer in cents representing how much to charge.
2322
+ attr_accessor :amount
2323
+ # 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).
2324
+ attr_accessor :currency
2325
+ # Shipping rates 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).
2326
+ attr_accessor :currency_options
2327
+
2328
+ def initialize(amount: nil, currency: nil, currency_options: nil)
2329
+ @amount = amount
2330
+ @currency = currency
2331
+ @currency_options = currency_options
2332
+ end
2333
+ end
2334
+ # The estimated range for how long shipping will take, meant to be displayable to the customer. This will appear on CheckoutSessions.
2335
+ attr_accessor :delivery_estimate
2336
+ # The name of the shipping rate, meant to be displayable to the customer. This will appear on CheckoutSessions.
2337
+ attr_accessor :display_name
2338
+ # Describes a fixed amount to charge for shipping. Must be present if type is `fixed_amount`.
2339
+ attr_accessor :fixed_amount
2340
+ # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
2341
+ attr_accessor :metadata
2342
+ # Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of `inclusive`, `exclusive`, or `unspecified`.
2343
+ attr_accessor :tax_behavior
2344
+ # A [tax code](https://stripe.com/docs/tax/tax-categories) ID. The Shipping tax code is `txcd_92010001`.
2345
+ attr_accessor :tax_code
2346
+ # The type of calculation to use on the shipping rate.
2347
+ attr_accessor :type
2348
+
2349
+ def initialize(
2350
+ delivery_estimate: nil,
2351
+ display_name: nil,
2352
+ fixed_amount: nil,
2353
+ metadata: nil,
2354
+ tax_behavior: nil,
2355
+ tax_code: nil,
2356
+ type: nil
2357
+ )
2358
+ @delivery_estimate = delivery_estimate
2359
+ @display_name = display_name
2360
+ @fixed_amount = fixed_amount
2361
+ @metadata = metadata
2362
+ @tax_behavior = tax_behavior
2363
+ @tax_code = tax_code
2364
+ @type = type
2365
+ end
2366
+ end
2367
+ # The ID of the Shipping Rate to use for this shipping option.
2368
+ attr_accessor :shipping_rate
2369
+ # Parameters to be passed to Shipping Rate creation for this shipping option.
2370
+ attr_accessor :shipping_rate_data
2371
+
2372
+ def initialize(shipping_rate: nil, shipping_rate_data: nil)
2373
+ @shipping_rate = shipping_rate
2374
+ @shipping_rate_data = shipping_rate_data
2375
+ end
2376
+ end
2377
+ # Information about the customer collected within the Checkout Session.
2378
+ attr_accessor :collected_information
2379
+ # Specifies which fields in the response should be expanded.
2380
+ attr_accessor :expand
2381
+ # 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. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
2382
+ attr_accessor :metadata
2383
+ # The shipping rate options to apply to this Session. Up to a maximum of 5.
2384
+ attr_accessor :shipping_options
2385
+
2386
+ def initialize(
2387
+ collected_information: nil,
2388
+ expand: nil,
2389
+ metadata: nil,
2390
+ shipping_options: nil
2391
+ )
2392
+ @collected_information = collected_information
2393
+ @expand = expand
2394
+ @metadata = metadata
2395
+ @shipping_options = shipping_options
2396
+ end
2397
+ end
2398
+
2399
+ class ExpireParams < Stripe::RequestParams
2400
+ # Specifies which fields in the response should be expanded.
2401
+ attr_accessor :expand
2402
+
2403
+ def initialize(expand: nil)
2404
+ @expand = expand
2405
+ end
2406
+ end
2407
+
2408
+ # Creates a Checkout Session object.
2409
+ def create(params = {}, opts = {})
2410
+ request(
2411
+ method: :post,
2412
+ path: "/v1/checkout/sessions",
2413
+ params: params,
2414
+ opts: opts,
2415
+ base_address: :api
2416
+ )
2417
+ end
2418
+
2419
+ # A Checkout Session can be expired when it is in one of these statuses: open
2420
+ #
2421
+ # After it expires, a customer can't complete a Checkout Session and customers loading the Checkout Session see a message saying the Checkout Session is expired.
2422
+ def expire(session, params = {}, opts = {})
2423
+ request(
2424
+ method: :post,
2425
+ path: format("/v1/checkout/sessions/%<session>s/expire", { session: CGI.escape(session) }),
2426
+ params: params,
2427
+ opts: opts,
2428
+ base_address: :api
2429
+ )
2430
+ end
2431
+
2432
+ # Returns a list of Checkout Sessions.
2433
+ def list(params = {}, opts = {})
2434
+ request(
2435
+ method: :get,
2436
+ path: "/v1/checkout/sessions",
2437
+ params: params,
2438
+ opts: opts,
2439
+ base_address: :api
2440
+ )
2441
+ end
2442
+
2443
+ # Retrieves a Checkout Session object.
2444
+ def retrieve(session, params = {}, opts = {})
2445
+ request(
2446
+ method: :get,
2447
+ path: format("/v1/checkout/sessions/%<session>s", { session: CGI.escape(session) }),
2448
+ params: params,
2449
+ opts: opts,
2450
+ base_address: :api
2451
+ )
2452
+ end
2453
+
2454
+ # Updates a Checkout Session object.
2455
+ def update(session, params = {}, opts = {})
2456
+ request(
2457
+ method: :post,
2458
+ path: format("/v1/checkout/sessions/%<session>s", { session: CGI.escape(session) }),
2459
+ params: params,
2460
+ opts: opts,
2461
+ base_address: :api
2462
+ )
2463
+ end
2464
+ end
2465
+ end
2466
+ end