v28.2.0

• #1931 This release changes the pinned API version to 2024-12-18.acacia.
  • Add support for network_advice_code and network_decline_code on Charge.outcome, Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
  • Add support for credits_application_invoice_voided on Billing.CreditBalanceTransaction.credit
  • Change type of Billing.CreditBalanceTransaction.credit.type from literal('credits_granted') to enum('credits_application_invoice_voided'|'credits_granted')
  • Add support for allow_redisplay on Card and Source
  • Add support for regulated_status on Card, Charge.payment_method_details.card, ConfirmationToken.payment_method_preview.card, and PaymentMethod.card
  • Add support for funding on Charge.payment_method_details.amazon_pay and Charge.payment_method_details.revolut_pay
  • Add support for network_transaction_id on Charge.payment_method_details.card
  • Add support for reference_prefix on Checkout.Session.payment_method_options.bacs_debit.mandate_options, Checkout.Session.payment_method_options.sepa_debit.mandate_options, PaymentIntent.payment_method_options.bacs_debit.mandate_options, PaymentIntent.payment_method_options.sepa_debit.mandate_options, PaymentIntentConfirmParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentConfirmParams.payment_method_options.sepa_debit.mandate_options, PaymentIntentCreateParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentCreateParams.payment_method_options.sepa_debit.mandate_options, PaymentIntentUpdateParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentUpdateParams.payment_method_options.sepa_debit.mandate_options, SetupIntent.payment_method_options.bacs_debit.mandate_options, SetupIntent.payment_method_options.sepa_debit.mandate_options, SetupIntentConfirmParams.payment_method_options.bacs_debit.mandate_options, SetupIntentConfirmParams.payment_method_options.sepa_debit.mandate_options, SetupIntentCreateParams.payment_method_options.bacs_debit.mandate_options, SetupIntentCreateParams.payment_method_options.sepa_debit.mandate_options, SetupIntentUpdateParams.payment_method_options.bacs_debit.mandate_options, SetupIntentUpdateParams.payment_method_options.sepa_debit.mandate_options, checkout.SessionCreateParams.payment_method_options.bacs_debit.mandate_options, and checkout.SessionCreateParams.payment_method_options.sepa_debit.mandate_options
  • Add support for new values al_tin, am_tin, ao_tin, ba_tin, bb_tin, bs_tin, cd_nif, gn_nif, kh_tin, me_pib, mk_vat, mr_nif, np_pan, sn_ninea, sr_fin, tj_tin, ug_tin, zm_tin, and zw_tin on enums CustomerCreateParams.tax_id_data[].type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, TaxIdCreateParams.type, and tax.CalculationCreateParams.customer_details.tax_ids[].type
  • Add support for visa_compliance on Dispute.evidence.enhanced_evidence, Dispute.evidence_details.enhanced_eligibility, and DisputeUpdateParams.evidence.enhanced_evidence
  • Add support for new value request_signature on enum forwarding.RequestCreateParams.replacements[]
  • Add support for account_holder_address and bank_address on FundingInstructions.bank_transfer.financial_addresses[].iban, FundingInstructions.bank_transfer.financial_addresses[].sort_code, FundingInstructions.bank_transfer.financial_addresses[].spei, FundingInstructions.bank_transfer.financial_addresses[].zengin, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].iban, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].sort_code, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].spei, and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].zengin
  • Add support for account_holder_name on FundingInstructions.bank_transfer.financial_addresses[].spei and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].spei
  • Add support for disabled_reason on Invoice.automatic_tax, Subscription.automatic_tax, SubscriptionSchedule.default_settings.automatic_tax, and SubscriptionSchedule.phases[].automatic_tax
  • Add support for tax_id on Issuing.Authorization.merchant_data and Issuing.Transaction.merchant_data
  • Add support for trial_period_days on PaymentLinkUpdateParams.subscription_data
  • Add support for al, am, ao, ba, bb, bs, cd, gn, kh, me, mk, mr, np, pe, sn, sr, tj, ug, uy, zm, and zw on Tax.Registration.country_options and tax.RegistrationCreateParams.country_options
  • Add support for new value 2024-12-18.acacia on enum WebhookEndpointCreateParams.api_version

See the changelog for more details.

v28.2.0-beta.4

• #1929 Update generated code for beta
  • Add support for allow_redisplay on Card and Source
  • Add support for new values am_tin, ao_tin, ba_tin, bb_tin, bs_tin, cd_nif, gn_nif, kh_tin, me_pib, mk_vat, mr_nif, np_pan, sn_ninea, sr_fin, tj_tin, ug_tin, zm_tin, and zw_tin on enums OrderCreateParams.tax_details.tax_ids[].type and OrderUpdateParams.tax_details.tax_ids[].type
  • Remove support for amount_refunded on PaymentRecord
  • Add support for account on Terminal.Reader.action.collect_payment_method, Terminal.Reader.action.confirm_payment_intent, Terminal.Reader.action.process_payment_intent, and Terminal.Reader.action.refund_payment

See the changelog for more details.

v28.2.0-beta.3

• #1930 Change types for capital FinancingSummary back to BigDecimal
  • The type for Capital.FinancingSummary.Details.advancePaidOutAt, Capital.FinancingSummary.Details.repaymentsBeginAt, Capital.FinancingSummary.Details.CurrentRepaymentInterval.repaymentsBeginAt have been changed to BigDecimal to reflect the API

See the changelog for more details.

v28.2.0-beta.2

• #1926 Update generated code for beta
  • Add support for automatic_indirect_tax on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for reference_prefix on Checkout.Session.payment_method_options.bacs_debit.mandate_options, Checkout.Session.payment_method_options.sepa_debit.mandate_options, Order.payment.settings.payment_method_options.sepa_debit.mandate_options, OrderCreateParams.payment.settings.payment_method_options.sepa_debit.mandate_options, OrderUpdateParams.payment.settings.payment_method_options.sepa_debit.mandate_options, PaymentIntent.payment_method_options.bacs_debit.mandate_options, PaymentIntent.payment_method_options.sepa_debit.mandate_options, PaymentIntentConfirmParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentConfirmParams.payment_method_options.sepa_debit.mandate_options, PaymentIntentCreateParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentCreateParams.payment_method_options.sepa_debit.mandate_options, PaymentIntentUpdateParams.payment_method_options.bacs_debit.mandate_options, PaymentIntentUpdateParams.payment_method_options.sepa_debit.mandate_options, SetupIntent.payment_method_options.bacs_debit.mandate_options, SetupIntent.payment_method_options.sepa_debit.mandate_options, SetupIntentConfirmParams.payment_method_options.bacs_debit.mandate_options, SetupIntentConfirmParams.payment_method_options.sepa_debit.mandate_options, SetupIntentCreateParams.payment_method_options.bacs_debit.mandate_options, SetupIntentCreateParams.payment_method_options.sepa_debit.mandate_options, SetupIntentUpdateParams.payment_method_options.bacs_debit.mandate_options, SetupIntentUpdateParams.payment_method_options.sepa_debit.mandate_options, checkout.SessionCreateParams.payment_method_options.bacs_debit.mandate_options, and checkout.SessionCreateParams.payment_method_options.sepa_debit.mandate_options
  • Add support for disabled_reason on Invoice.automatic_tax, Subscription.automatic_tax, SubscriptionSchedule.default_settings.automatic_tax, and SubscriptionSchedule.phases[].automatic_tax
  • Add support for trial_period_days on PaymentLinkUpdateParams.subscription_data

See the changelog for more details.

v28.2.0-beta.1

• #1924 Update generated code for beta
  • Add support for network_advice_code and network_decline_code on Charge.outcome, Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
  • Add support for funding on Charge.payment_method_details.amazon_pay and Charge.payment_method_details.revolut_pay
  • Add support for amount_requested and partial_authorization on Charge.payment_method_details.card
  • Add support for metadata on LineItem and checkout.SessionCreateParams.line_items[]
  • Add support for line_items on Checkout.Session.permissions.update, checkout.SessionCreateParams.permissions.update, and checkout.SessionUpdateParams
  • Add support for adjustable_quantity and display on LineItem
  • Add support for request_partial_authorization on PaymentIntent.payment_method_options.card, PaymentIntentConfirmParams.payment_method_options.card, PaymentIntentCreateParams.payment_method_options.card, and PaymentIntentUpdateParams.payment_method_options.card
  • Add support for payment_method_options on PaymentIntentIncrementAuthorizationParams
  • Add support for new value invoice.overpaid on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]

See the changelog for more details.

v28.1.0

• #1923 This release changes the pinned API version to 2024-11-20.acacia.
  • Add support for respond test helper method on resource Issuing.Authorization
  • Add support for authorizer on AccountPersonsParams.relationship and TokenCreateParams.person.relationship
  • Add support for adaptive_pricing on Checkout.Session and checkout.SessionCreateParams
  • Add support for mandate_options on Checkout.Session.payment_method_options.bacs_debit, Checkout.Session.payment_method_options.sepa_debit, checkout.SessionCreateParams.payment_method_options.bacs_debit, and checkout.SessionCreateParams.payment_method_options.sepa_debit
  • Add support for request_extended_authorization, request_incremental_authorization, request_multicapture, and request_overcapture on Checkout.Session.payment_method_options.card and checkout.SessionCreateParams.payment_method_options.card
  • Add support for capture_method on checkout.SessionCreateParams.payment_method_options.kakao_pay, checkout.SessionCreateParams.payment_method_options.kr_card, checkout.SessionCreateParams.payment_method_options.naver_pay, checkout.SessionCreateParams.payment_method_options.payco, and checkout.SessionCreateParams.payment_method_options.samsung_pay
  • Add support for new value subscribe on enums PaymentLinkCreateParams.submit_type and checkout.SessionCreateParams.submit_type
  • Add support for new value li_vat on enums CustomerCreateParams.tax_id_data[].type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, TaxIdCreateParams.type, and tax.CalculationCreateParams.customer_details.tax_ids[].type
  • Add support for new value financial_account_statement on enum FileListParams.purpose
  • Add support for account_holder_address, account_holder_name, account_type, and bank_address on FundingInstructions.bank_transfer.financial_addresses[].aba, FundingInstructions.bank_transfer.financial_addresses[].swift, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].aba, and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].swift
  • Add support for new value service_tax on enums InvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type, InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type, TaxRateCreateParams.tax_type, and TaxRateUpdateParams.tax_type
  • Add support for merchant_amount and merchant_currency on issuing.AuthorizationCreateParams
  • Change issuing.AuthorizationCreateParams.amount to be optional
  • Add support for fraud_challenges and verified_by_fraud_challenge on Issuing.Authorization
  • Add support for new value link on enums PaymentIntentConfirmParams.payment_method_options.card.network, PaymentIntentCreateParams.payment_method_options.card.network, PaymentIntentUpdateParams.payment_method_options.card.network, SetupIntentConfirmParams.payment_method_options.card.network, SetupIntentCreateParams.payment_method_options.card.network, SetupIntentUpdateParams.payment_method_options.card.network, SubscriptionCreateParams.payment_settings.payment_method_options.card.network, and SubscriptionUpdateParams.payment_settings.payment_method_options.card.network
  • Add support for submit_type on PaymentLinkUpdateParams
  • Add support for trace_id on Payout
  • Add support for network_decline_code on Refund.destination_details.blik and Refund.destination_details.swish
  • Add support for new value 2024-11-20.acacia on enum WebhookEndpointCreateParams.api_version

See the changelog for more details.

v28.1.0-beta.3

• #1922 Update generated code for beta
  • Add support for account_holder_address and bank_address on FundingInstructions.bank_transfer.financial_addresses[].iban, FundingInstructions.bank_transfer.financial_addresses[].sort_code, FundingInstructions.bank_transfer.financial_addresses[].spei, FundingInstructions.bank_transfer.financial_addresses[].zengin, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].iban, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].sort_code, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].spei, and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].zengin
  • Add support for account_holder_name on FundingInstructions.bank_transfer.financial_addresses[].spei and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].spei
  • Add support for new value subscribe on enum PaymentLinkUpdateParams.submit_type

See the changelog for more details.

v28.1.0-beta.2

• #1917 Update generated code for beta
  • Add support for new resources Issuing.FraudLiabilityDebit, PaymentAttemptRecord, and PaymentRecord
  • Add support for list and retrieve methods on resources FraudLiabilityDebit and PaymentAttemptRecord
  • Add support for report_payment_attempt_canceled, report_payment_attempt_failed, report_payment_attempt_guaranteed, report_payment_attempt, report_payment, and retrieve methods on resource PaymentRecord
  • Remove support for money_movement on AccountSessionCreateParams.components.financial_account.features
  • Add support for card_management, card_spend_dispute_management, cardholder_management, and spend_control_management on AccountSessionCreateParams.components.issuing_card.features
  • Add support for disable_stripe_user_authentication on AccountSessionCreateParams.components.issuing_cards_list.features
  • Add support for adaptive_pricing on Checkout.Session and checkout.SessionCreateParams
  • Add support for mandate_options on Checkout.Session.payment_method_options.bacs_debit, Checkout.Session.payment_method_options.sepa_debit, checkout.SessionCreateParams.payment_method_options.bacs_debit, and checkout.SessionCreateParams.payment_method_options.sepa_debit
  • Add support for request_decremental_authorization, request_extended_authorization, request_incremental_authorization, request_multicapture, and request_overcapture on Checkout.Session.payment_method_options.card and checkout.SessionCreateParams.payment_method_options.card
  • Add support for capture_method on checkout.SessionCreateParams.payment_method_options.kakao_pay, checkout.SessionCreateParams.payment_method_options.kr_card, checkout.SessionCreateParams.payment_method_options.naver_pay, checkout.SessionCreateParams.payment_method_options.payco, and checkout.SessionCreateParams.payment_method_options.samsung_pay
  • Add support for new value li_vat on enums CustomerCreateParams.tax_id_data[].type, InvoiceCreatePreviewParams.customer_details.tax_ids[].type, InvoiceUpcomingLinesParams.customer_details.tax_ids[].type, InvoiceUpcomingParams.customer_details.tax_ids[].type, OrderCreateParams.tax_details.tax_ids[].type, OrderUpdateParams.tax_details.tax_ids[].type, TaxIdCreateParams.type, and tax.CalculationCreateParams.customer_details.tax_ids[].type
  • Add support for account_holder_address, account_holder_name, account_type, and bank_address on FundingInstructions.bank_transfer.financial_addresses[].aba, FundingInstructions.bank_transfer.financial_addresses[].swift, PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].aba, and PaymentIntent.next_action.display_bank_transfer_instructions.financial_addresses[].swift
  • Add support for new value custom on enums InvoiceCreateParams.payment_settings.payment_method_types[], InvoiceUpdateParams.payment_settings.payment_method_types[], SubscriptionCreateParams.payment_settings.payment_method_types[], and SubscriptionUpdateParams.payment_settings.payment_method_types[]
  • Add support for new value service_tax on enums InvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type, InvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_data.tax_type, TaxRateCreateParams.tax_type, and TaxRateUpdateParams.tax_type
  • Add support for payment_record_data and payment_record on InvoiceAttachPaymentParams
  • Remove support for out_of_band_payment on InvoiceAttachPaymentParams
  • Add support for amount_overpaid on Invoice
  • Add support for merchant_amount and merchant_currency on issuing.AuthorizationCreateParams
  • Change issuing.AuthorizationCreateParams.amount to be optional
  • Add support for new value link on enums PaymentIntentConfirmParams.payment_method_options.card.network, PaymentIntentCreateParams.payment_method_options.card.network, PaymentIntentUpdateParams.payment_method_options.card.network, SetupIntentConfirmParams.payment_method_options.card.network, SetupIntentCreateParams.payment_method_options.card.network, SetupIntentUpdateParams.payment_method_options.card.network, SubscriptionCreateParams.payment_settings.payment_method_options.card.network, and SubscriptionUpdateParams.payment_settings.payment_method_options.card.network
  • Add support for submit_type on PaymentLinkUpdateParams
  • Add support for new values invoice.payment_attempt_required and issuing_fraud_liability_debit.created on enums WebhookEndpointCreateParams.enabled_events[] and WebhookEndpointUpdateParams.enabled_events[]

See the changelog for more details.

v28.0.1

• #1919 Catch JsonSyntaxException when processing all errors
• #1916 Restore testReportsRawRequestUsageTelemetry test
• #1915 add major version blurb to changelog

See the changelog for more details.

v28.1.0-beta.1

• #1914 Update generated code for beta
  • Add support for trigger_action method on resource PaymentIntent
  • Add support for id_bank_transfer_payments_bca and id_bank_transfer_payments on Account.capabilities, AccountCreateParams.capabilities, and AccountUpdateParams.capabilities
  • Add support for bank_bca_onboarding on Account.settings, AccountCreateParams.settings, and AccountUpdateParams.settings
  • Add support for send_money on AccountSessionCreateParams.components.recipients.features
  • Add support for id_bank_transfer on Charge.payment_method_details, ConfirmationToken.payment_method_preview, ConfirmationTokenCreateParams.payment_method_data, Invoice.payment_settings.payment_method_options, InvoiceCreateParams.payment_settings.payment_method_options, InvoiceUpdateParams.payment_settings.payment_method_options, PaymentIntent.payment_method_options, PaymentIntentConfirmParams.payment_method_data, PaymentIntentConfirmParams.payment_method_options, PaymentIntentCreateParams.payment_method_data, PaymentIntentCreateParams.payment_method_options, PaymentIntentUpdateParams.payment_method_data, PaymentIntentUpdateParams.payment_method_options, PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, PaymentMethodConfiguration, PaymentMethodCreateParams, PaymentMethod, Refund.destination_details, SetupAttempt.payment_method_details, SetupIntentConfirmParams.payment_method_data, SetupIntentCreateParams.payment_method_data, SetupIntentUpdateParams.payment_method_data, Subscription.payment_settings.payment_method_options, SubscriptionCreateParams.payment_settings.payment_method_options, and SubscriptionUpdateParams.payment_settings.payment_method_options
  • Add support for gopay, qris, and shopeepay on PaymentMethodConfigurationCreateParams, PaymentMethodConfigurationUpdateParams, and PaymentMethodConfiguration
• #1909 Do not allow setting Stripe.stripeVersion
  • Stripe.stripeVersion is no longer settable. If you were using this to set the beta headers, use the helper method Stripe.addBetaVersion() instead.

See the changelog for more details.