v82.3.0-beta.1

This release changes the pinned API version to 2025-05-28.preview.

• #2060 Update generated code for beta

  Breaking changes

  • Remove support for deprecated previews
    • Remove support for resources BillingMeterErrorReport, GiftCardsCard, GiftCardsTransaction, and PrivacyRedactionJobRootObjects
    • Remove support for Get, List, New, Update, and Validate methods on resource GiftCardsCard
    • Remove support for Cancel, Confirm, Get, List, New, and Update methods on resource GiftCardsTransaction
    • Remove support for Provisioning on ProductParams and Product
    • Remove support for snapshot event EventTypeBillingMeterErrorReportTriggered with resource BillingMeterErrorReport
    • Remove support for error codes gift_card_balance_insufficient, gift_card_code_exists, and gift_card_inactive on Error and QuotePreviewInvoiceLastFinalizationError
  • Remove support for Credits on OrderParams and Order
  • Remove support for AmountRemaining on Order
  • Remove support for AmountCredit on OrderTotalDetails
  • Remove support for AsyncWorkflows on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentDecrementAuthorizationParams, PaymentIntentIncrementAuthorizationParams, PaymentIntentParams, and PaymentIntent
  • Remove support for values credits_attributed_to_debits and legacy_prorations from enums QuotePreviewSubscriptionSchedule.BillingMode, QuoteSubscriptionData.BillingMode, Subscription.BillingMode, and SubscriptionSchedule.BillingMode
  • Remove support for StatusDetails and Status on TaxAssociation
  • Change type of InvoiceCreatePreviewSubscriptionDetailsParams.CancelAt and SubscriptionParams.CancelAt from DateTime to DateTime | enum('max_period_end'|'min_period_end')
  • Change type of CheckoutSessionLineItemParams.Quantity from emptyable(longInteger) to longInteger
  • Change type of PrivacyRedactionJob.Objects from $Privacy.RedactionJobRootObjects to RedactionResourceRootObjects
  • Change type of PrivacyRedactionJob.Status from string to enum
  • Change type of PrivacyRedactionJob.ValidationBehavior from string to enum('error'|'fix')
  • Change type of PrivacyRedactionJobValidationError.Code from string to enum
  • Change type of PrivacyRedactionJobValidationError.ErroringObject from map(string: string) to RedactionResourceErroringObject

  Other changes

  • Add support for Migrate method on resource Subscription
  • Add support for Distance, PickupLocationName, ReturnLocationName, and VehicleIdentificationNumber on ChargeCapturePaymentDetailsCarRentalParams, ChargePaymentDetailsCarRentalParams, PaymentIntentCapturePaymentDetailsCarRentalParams, PaymentIntentConfirmPaymentDetailsCarRentalParams, PaymentIntentPaymentDetailsCarRentalParams, and PaymentIntentPaymentDetailsCarRental
  • Add support for DriverIdentificationNumber and DriverTaxNumber on ChargeCapturePaymentDetailsCarRentalDriverParams, ChargePaymentDetailsCarRentalDriverParams, PaymentIntentCapturePaymentDetailsCarRentalDriverParams, PaymentIntentConfirmPaymentDetailsCarRentalDriverParams, PaymentIntentPaymentDetailsCarRentalDriverParams, and PaymentIntentPaymentDetailsCarRentalDriver
  • Add support for Institution on FinancialConnectionsAccount
  • Add support for Countries on FinancialConnectionsInstitution
  • Add support for Location and Reader on PaymentAttemptRecordPaymentMethodDetailsAffirm, PaymentAttemptRecordPaymentMethodDetailsWechatPay, PaymentRecordPaymentMethodDetailsAffirm, and PaymentRecordPaymentMethodDetailsWechatPay
  • Add support for Hooks on PaymentIntentCaptureParams, PaymentIntentConfirmParams, PaymentIntentDecrementAuthorizationParams, PaymentIntentIncrementAuthorizationParams, PaymentIntentParams, and PaymentIntent
  • Add support for CardPresent on PaymentIntentAmountDetailsLineItemPaymentMethodOptions
  • Change type of PaymentRecordReportPaymentAttemptCanceledParams.Metadata, PaymentRecordReportPaymentAttemptFailedParams.Metadata, PaymentRecordReportPaymentAttemptGuaranteedParams.Metadata, PaymentRecordReportPaymentAttemptParams.Metadata, and PaymentRecordReportPaymentParams.Metadata from map(string: string) to emptyable(map(string: string))
  • Add support for Livemode on PrivacyRedactionJob
  • Add support for new values classic and flexible on enums QuotePreviewSubscriptionSchedule.BillingMode, QuoteSubscriptionData.BillingMode, Subscription.BillingMode, and SubscriptionSchedule.BillingMode
  • Add support for BillingThresholds on QuotePreviewSubscriptionScheduleDefaultSettings, QuotePreviewSubscriptionSchedulePhaseItem, and QuotePreviewSubscriptionSchedulePhase
  • Add support for BillingModeDetails on Subscription
  • Add support for TaxTransactionAttempts on TaxAssociation
  • Add support for ConfirmConfig on TerminalReaderActionConfirmPaymentIntent and TerminalReaderConfirmPaymentIntentParams
  • Add support for error code forwarding_api_upstream_error on QuotePreviewInvoiceLastFinalizationError

See the changelog for more details.

v82.2.0

This release changes the pinned API version to 2025-05-28.basil.

• #2063 Update generated code
  • Add support for AttachPayment method on resource Invoice
  • Add support for CollectInputs method on resource TerminalReader
  • Add support for SucceedInputCollection and TimeoutInputCollection test helper methods on resource TerminalReader
  • Add support for PixPayments on AccountCapabilitiesParams and AccountCapabilities
  • Add support for DisputesList and PaymentDisputes on AccountSessionComponentsParams and AccountSessionComponents
  • Add support for RefundAndDisputePrefunding on Balance
  • Add support for BalanceType on BalanceTransaction
  • Add support for Location and Reader on ChargePaymentMethodDetailsAffirm and ChargePaymentMethodDetailsWechatPay
  • Add support for PaymentMethodRemove on CheckoutSessionSavedPaymentMethodOptionsParams
  • Add support for SetupFutureUsage on CheckoutSessionPaymentMethodOptionsNaverPay
  • Add support for PostPaymentAmount and PrePaymentAmount on CreditNote
  • Add support for new value mixed on enum CreditNote.Type
  • Add support for new value invoice_payment.paid on enum Event.Type
  • Add support for Sex, UnparsedPlaceOfBirth, and UnparsedSex on IdentityVerificationReportDocument and IdentityVerificationSessionVerifiedOutputs
  • Add support for BillingThresholds on InvoiceCreatePreviewScheduleDetailsPhaseItemParams, InvoiceCreatePreviewScheduleDetailsPhaseParams, InvoiceCreatePreviewSubscriptionDetailsItemParams, SubscriptionItemParams, SubscriptionItem, SubscriptionParams, SubscriptionScheduleDefaultSettingsParams, SubscriptionScheduleDefaultSettings, SubscriptionSchedulePhaseItemParams, SubscriptionSchedulePhaseItem, SubscriptionSchedulePhaseParams, SubscriptionSchedulePhase, and Subscription
  • Add support for Satispay on PaymentIntentConfirmPaymentMethodOptionsParams, PaymentIntentPaymentMethodOptionsParams, and PaymentIntentPaymentMethodOptions
  • Add support for CaptureMethod on PaymentIntentPaymentMethodOptionsBillie
  • Add support for KakaoPay, KrCard, NaverPay, Payco, and SamsungPay on PaymentMethodConfigurationParams and PaymentMethodConfiguration
  • Add support for NetworkDeclineCode on RefundDestinationDetailsPaypal
  • Add support for Metadata on TaxCalculationLineItemParams and TaxCalculationLineItem
  • Add support for ReturnURL on TerminalReaderActionProcessPaymentIntentProcessConfig and TerminalReaderProcessPaymentIntentProcessConfigParams
  • Add support for CollectInputs on TerminalReaderAction
  • Add support for new value collect_inputs on enum TerminalReaderAction.Type
  • Add support for new value simulated_stripe_s700 on enum TerminalReader.DeviceType
  • Add support for snapshot event EventTypeInvoicePaymentPaid with resource InvoicePayment
  • Add support for error code forwarding_api_upstream_error on Error, InvoiceLastFinalizationError, PaymentIntentLastPaymentError, SetupAttemptSetupError, SetupIntentLastSetupError, and StripeError
• #2062 Adds CONTRIBUTING.md

See the changelog for more details.

v82.2.0-beta.2

• #2059 Update generated code for beta
  Release specs are identical.

See the changelog for more details.

v82.2.0-beta.1

• #2034 Update generated code for beta
  This release changes the pinned API version to 2025-04-30.preview.

  • Add support for BillingMode on CheckoutSessionSubscriptionDataParams, InvoiceCreatePreviewScheduleDetailsParams, InvoiceCreatePreviewSubscriptionDetailsParams, QuotePreviewSubscriptionSchedule, QuoteSubscriptionDataParams, QuoteSubscriptionData, SubscriptionParams, SubscriptionScheduleParams, SubscriptionSchedule, and Subscription
  • Add support for new values aw_tin, az_tin, bd_bin, bf_ifu, bj_ifu, cm_niu, cv_nif, et_tin, kg_tin, and la_tin on enums CheckoutSessionCollectedInformationTaxIds.Type, OrderTaxDetailsTaxId.Type, and QuotePreviewInvoiceCustomerTaxIds.Type
  • Add support for AccountNumber on ConfirmationTokenPaymentMethodPreviewAcssDebit and PaymentMethodAcssDebit
  • Add support for new value balance_settings.updated on enum Event.Type

• #2054 Unexport GetBaseEvent and V2ErrorCode

  • ⚠️ Unexported GetBaseEvent --> getBaseEvent. This function should not be called. Instead, type-cast the V2Event to a concrete Event struct.
  • ⚠️ Removed the V2ErrorCode type. Error codes should not be handled programmatically for V2 errors.

See the changelog for more details.

v82.1.0

This release changes the pinned API version to 2025-04-30.basil.

🎉 Introducing new Stripe Client

Starting with v82.1, the new stripe.Client type is replacing client.API to provide a more ergonomic, consistent, and less error-prone experience. You create the former using stripe.NewClient(stripeKey). It’s almost a drop-in replacement, except for the differences listed below.

1. Service method names now align with Stripe API docs. The stripe.Client uses Create, Retrieve, Update, and Delete (instead of New, Get, Update, and Del).
2. The first argument of each service method is a context.Context.
3. Parameter objects are now method-specific. For example, CustomerCreateParams and CustomerDeleteParams instead of simply CustomerParams. This allows us to put the right fields in the right methods at compile time.
4. Services are all version-namespaced for symmetry. E.g. stripeClient.V1Accounts and stripeClient.V2Accounts.
5. List methods return an iter.Seq2, so they can be ranged over without explicit calls to Next, Current, and Err.

🎉 Native support in Go for V2 APIs

params := &stripe.V2CoreEventListParams{ObjectID: stripe.String("mtr_123")}
for event, err := range sc.V2CoreEvents.List(context.TODO(), params) {
  // handle err
  // process event object
}

• All V2 APIs are now supported natively through the stripe.Client

More details can be found at https://github.com/stripe/stripe-go/wiki/Migration-guide-for-Stripe-Client

• #2029 Update generated code
  • Add support for MinorityOwnedBusinessDesignation on AccountBusinessProfileParams and AccountBusinessProfile
  • Add support for RegistrationDate on AccountCompanyParams, AccountCompany, and TokenAccountCompanyParams
  • Add support for USCfpbData on AccountParams, PersonParams, Person, and TokenPersonParams
  • Add support for new value tax_id_prohibited on enums InvoiceLastFinalizationError.Code, PaymentIntentLastPaymentError.Code, SetupAttemptSetupError.Code, SetupIntentLastSetupError.Code, and StripeError.Code
  • Add support for new value verification_legal_entity_structure_mismatch on enums BankAccountFutureRequirementsErrors.Code and BankAccountRequirementsErrors.Code
  • Add support for TaxID on ChargeBillingDetails, ConfirmationTokenPaymentMethodDataBillingDetailsParams, ConfirmationTokenPaymentMethodPreviewBillingDetails, PaymentIntentConfirmPaymentMethodDataBillingDetailsParams, PaymentIntentPaymentMethodDataBillingDetailsParams, PaymentMethodBillingDetailsParams, PaymentMethodBillingDetails, SetupIntentConfirmPaymentMethodDataBillingDetailsParams, SetupIntentPaymentMethodDataBillingDetailsParams, TestHelpersConfirmationTokenPaymentMethodDataBillingDetailsParams, and TreasuryOutboundPaymentDestinationPaymentMethodDataBillingDetailsParams
  • Add support for WalletOptions on CheckoutSessionParams and CheckoutSession
  • Add support for Provider on CheckoutSessionAutomaticTax, InvoiceAutomaticTax, and QuoteAutomaticTax
  • Add support for new values aw_tin, az_tin, bd_bin, bf_ifu, bj_ifu, cm_niu, cv_nif, et_tin, kg_tin, and la_tin on enums CheckoutSessionCustomerDetailsTaxIds.Type, TaxCalculationCustomerDetailsTaxId.Type, TaxId.Type, and TaxTransactionCustomerDetailsTaxId.Type
  • Add support for PaymentMethodOptions on ConfirmationTokenParams and TestHelpersConfirmationTokenParams
  • Add support for Installments on ConfirmationTokenPaymentMethodOptionsCard
  • Add support for Context on Event
  • Add support for new value affirm on enums InvoicePaymentSettings.PaymentMethodTypes and SubscriptionPaymentSettings.PaymentMethodTypes
  • Add support for Billie on PaymentIntentConfirmPaymentMethodOptionsParams, PaymentIntentPaymentMethodOptionsParams, and PaymentIntentPaymentMethodOptions
  • Add support for Pix on PaymentMethodConfigurationParams and PaymentMethodConfiguration
  • Add support for Klarna on PaymentMethodDomain
  • Add support for PendingReason on Refund
  • Add support for Aw, Az, Bd, Bf, Bj, Cm, Cv, ET, In, Kg, La, and Ph on TaxRegistrationCountryOptionsParams and TaxRegistrationCountryOptions
• #2022 Improved handling for enums in params
  • You can now pass string enums into stripe.String. For example, stripe.String(stripe.CurrencyUSD) instead of stripe.String(string(stripe.CurrencyUSD))
• #1916 perf: do not computing signature when timestamp is not valid
• #1860 fix: typo in error
• #2018 Backport beta fixes

See the changelog for more details.

v82.1.0-beta.3

• #2023 Update generated code for beta
  • Add support for new resources FxQuote and PaymentIntentAmountDetailsLineItem
  • Add support for new services fxquote.Client (accessed by client.API.FxQuotes) and paymentintentamountdetailslineitem.Client (accessed by client.API.PaymentIntentAmountDetailsLineItems)
  • Remove support for service invoicepayment.Client (accessed by client.API.InvoicePayments)
  • Add support for Get, List, and New methods on resource FxQuote
  • Remove support for AttachPaymentIntent method on resource Invoice
  • Remove support for Get and List methods on resource InvoicePayment
  • Add support for List method on resource PaymentIntentAmountDetailsLineItem
  • Add support for List method on service paymentintentamountdetailslineitem.Client
  • Add support for Get, List, and New methods on service fxquote.Client
  • Remove support for Get and List methods on service invoicepayment.Client
  • Remove support for AttachPaymentIntent method on service invoice.Client
  • Add support for RegistrationDate on AccountCompanyParams, AccountCompany, and TokenAccountCompanyParams
  • Add support for USCfpbData on AccountParams, PersonParams, Person, and TokenPersonParams
  • Add support for CustomerReference and OrderReference on ChargeCapturePaymentDetailsParams, ChargePaymentDetailsParams, PaymentIntentCapturePaymentDetailsParams, PaymentIntentConfirmPaymentDetailsParams, PaymentIntentPaymentDetailsParams, and PaymentIntentPaymentDetails
  • Add support for TaxID on ChargeBillingDetails, ConfirmationTokenPaymentMethodDataBillingDetailsParams, ConfirmationTokenPaymentMethodPreviewBillingDetails, PaymentIntentConfirmPaymentMethodDataBillingDetailsParams, PaymentIntentPaymentMethodDataBillingDetailsParams, PaymentMethodBillingDetailsParams, PaymentMethodBillingDetails, SetupIntentConfirmPaymentMethodDataBillingDetailsParams, SetupIntentPaymentMethodDataBillingDetailsParams, TestHelpersConfirmationTokenPaymentMethodDataBillingDetailsParams, and TreasuryOutboundPaymentDestinationPaymentMethodDataBillingDetailsParams
  • Add support for PriceData on CheckoutSessionLineItemParams
  • Add support for Script on CouponParams and Coupon
  • Add support for Type on Coupon
  • Add support for new value fx_quote.expired on enum Event.Type
  • Add support for new value affirm on enums InvoicePaymentSettings.PaymentMethodTypes, QuotePreviewInvoicePaymentSettings.PaymentMethodTypes, and SubscriptionPaymentSettings.PaymentMethodTypes
  • Add support for FxQuote on PaymentIntentConfirmParams, PaymentIntentParams, PaymentIntent, TransferParams, and Transfer
  • Add support for DiscountAmount, LineItems, Shipping, and Tax on PaymentIntentAmountDetails
  • Add support for Pix on PaymentMethodConfigurationParams and PaymentMethodConfiguration
  • Add support for PendingReason on Refund
  • Add support for Aw, Az, Bd, Bj, ET, Kg, La, and Ph on TaxRegistrationCountryOptionsParams and TaxRegistrationCountryOptions
  • Add support for snapshot event EventTypeFxQuoteExpired with resource FxQuote
• #2033 Mbroshi/merge go beta

See the changelog for more details.

v82.1.0-beta.2

• #2019 Update generated code for beta

  Breaking changes

  • Change type of V2MoneyManagementReceivedDebit.StatusTransitions from an object to nullable(an object)
  • Remove support for values bank_accounts.local_uk, bank_accounts.wire_uk, cards_uk, and crypto_wallets_v2 from enum EventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.UpdatedCapability

  Additions

  • Add support for new resources Privacy.RedactionJobRootObjects, Privacy.RedactionJobValidationError, and Privacy.RedactionJob
  • Add support for Cancel, Get, List, New, Run, Update, and Validate methods on resource RedactionJob
  • Add support for Get and List methods on resource RedactionJobValidationError
  • Add support for MinorityOwnedBusinessDesignation on AccountBusinessProfileParams and AccountBusinessProfile
  • Add support for ExportTaxTransactions and PaymentDisputes on AccountSessionComponentsParams
  • Add support for new value tax_id_prohibited on enums InvoiceLastFinalizationError.Code, PaymentIntentLastPaymentError.Code, QuotePreviewInvoiceLastFinalizationError.Code, SetupAttemptSetupError.Code, SetupIntentLastSetupError.Code, and StripeError.Code
  • Add support for new value verification_legal_entity_structure_mismatch on enums BankAccountFutureRequirementsErrors.Code and BankAccountRequirementsErrors.Code
  • Add support for new value fixed_term_loan on enum CapitalFinancingOffer.Type
  • Add support for WalletOptions on CheckoutSessionParams and CheckoutSession
  • Add support for new values privacy.redaction_job.canceled, privacy.redaction_job.created, privacy.redaction_job.ready, privacy.redaction_job.succeeded, and privacy.redaction_job.validation_error on enum Event.Type
  • Add support for Klarna on PaymentMethodDomain
  • Add support for In on TaxRegistrationCountryOptionsParams and TaxRegistrationCountryOptions

• #2014 Handle top-level External Account service

  • Add support for top-level External Account CRUDL calls by adding separate GetCard/GetBankAccount, NewCard/NewBankAccount, etc. calls.

See the changelog for more details.

v82.1.0-beta.1

• #2009 Update generated code for beta

  This release changes the pinned API version to 2025-03-31.preview

Breaking Changes

• Remove support for AmountOverpaid on InvoicePayment
• Remove support for values out_of_band_payment and payment_record from enum InvoicePaymentPayment.Type
• Remove support for RateCardSubscriptionDetails on InvoiceItemParent
• Remove support for ApplicationFeeAmount, PaidOutOfBand, and Paid on QuotePreviewInvoice
• Remove support for BillingThresholds on QuotePreviewSubscriptionScheduleDefaultSettings, QuotePreviewSubscriptionSchedulePhasesItems, and QuotePreviewSubscriptionSchedulePhases
• Remove support for Value on TerminalReaderActionCollectInputsInputsSelectionChoices, TerminalReaderActionCollectInputsInputsSelection, and TerminalReaderCollectInputsInputsSelectionChoicesParams
• Change type of InvoiceCreatePreviewSubscriptionDetailsParams.CancelAt and SubscriptionParams.CancelAt from DateTime | literal('min_period_end') to DateTime
• Change type of PaymentAttemptRecord.payment_method_details.type and PaymentRecord.payment_method_details.type from literal('custom') to string
• Change type of PaymentAttemptRecord.payment_record from string to nullable(string)
• Change type of PaymentRecord.latest_payment_attempt_record from string to nullable(string)

Additions

• Add support for new resources BalanceSettings and TlExternalAccount
• Add support for Get and Update methods on resource BalanceSettings
• Add support for Del, Get, List, New, and Update methods on resource TlExternalAccount
• Add support for StripeBalancePayments on AccountCapabilitiesParams and AccountCapabilities
• Add support for CustomerAccount on BillingCreditBalanceSummaryParams, BillingCreditBalanceSummary, BillingCreditBalanceTransactionListParams, BillingCreditGrantListParams, BillingCreditGrantParams, BillingCreditGrant, BillingPortalSessionParams, BillingPortalSession, CashBalance, CheckoutSessionListParams, CheckoutSessionParams, CheckoutSession, ConfirmationTokenPaymentMethodPreview, CreditNoteListParams, CreditNote, CustomerBalanceTransaction, CustomerCashBalanceTransaction, CustomerSessionParams, CustomerSession, Customer, Discount, FinancialConnectionsAccountAccountHolder, FinancialConnectionsAccountListAccountHolderParams, FinancialConnectionsSessionAccountHolderParams, FinancialConnectionsSessionAccountHolder, InvoiceCreatePreviewParams, InvoiceItemListParams, InvoiceItemParams, InvoiceItem, InvoiceListParams, InvoiceParams, Invoice, PaymentIntentListParams, PaymentIntentParams, PaymentIntent, PaymentMethodAttachParams, PaymentMethod, PromotionCodeListParams, PromotionCodeParams, PromotionCode, QuoteListParams, QuoteParams, QuotePreviewInvoice, QuotePreviewSubscriptionSchedule, Quote, SetupAttempt, SetupIntentListParams, SetupIntentParams, SetupIntent, SubscriptionListParams, SubscriptionParams, SubscriptionScheduleListParams, SubscriptionScheduleParams, SubscriptionSchedule, Subscription, TaxIdOwner, and TaxId
• Add support for StripeBalance on ChargePaymentMethodDetails, ConfirmationTokenPaymentMethodDataParams, ConfirmationTokenPaymentMethodPreview, PaymentAttemptRecordPaymentMethodDetails, PaymentIntentConfirmPaymentMethodDataParams, PaymentIntentConfirmPaymentMethodOptionsParams, PaymentIntentPaymentMethodDataParams, PaymentIntentPaymentMethodOptionsParams, PaymentIntentPaymentMethodOptions, PaymentMethodParams, PaymentMethod, PaymentRecordPaymentMethodDetails, SetupAttemptPaymentMethodDetails, SetupIntentConfirmPaymentMethodDataParams, and SetupIntentPaymentMethodDataParams
• Add support for UpdateLineItems on CheckoutSessionPermissionsParams and CheckoutSessionPermissions
• Add support for Provider on CheckoutSessionAutomaticTax, InvoiceAutomaticTax, QuoteAutomaticTax, and QuotePreviewInvoiceAutomaticTax
• Add support for PaymentMethodOptions on ConfirmationTokenParams
• Add support for Installments on ConfirmationTokenPaymentMethodOptionsCard
• Add support for DurationInMonths on CouponParams
• Add support for new value repeating on enum Coupon.Duration
• Add support for TaxCalculationReference on CreditNoteLineItem, InvoiceLineItem, and LineItem
• Add support for Context on Event
• Add support for RelatedCustomerAccount on IdentityVerificationSessionListParams, IdentityVerificationSessionParams, and IdentityVerificationSession
• Add support for CancelAtPeriodEnd on InvoiceCreatePreviewSubscriptionDetailsParams, SubscriptionParams, and Subscription
• Add support for NzBankAccount on PaymentAttemptRecordPaymentMethodDetails and PaymentRecordPaymentMethodDetails
• Add support for Billie on PaymentIntentConfirmPaymentMethodOptionsParams, PaymentIntentPaymentMethodOptionsParams, and PaymentIntentPaymentMethodOptions
• Add support for PayoutMethod on PayoutParams and Payout
• Add support for ConfirmationSecret and Parent on QuotePreviewInvoice
• Add support for new values forwarding_api_retryable_upstream_error, v2_account_disconnection_unsupported, and v2_account_missing_configuration on enum QuotePreviewInvoiceLastFinalizationError.Code
• Add support for new values nz_bank_account and stripe_balance on enum QuotePreviewInvoicePaymentSettings.PaymentMethodTypes
• Add support for ID and Text on TerminalReaderActionCollectInputsInputsSelectionChoices, TerminalReaderActionCollectInputsInputsSelection, and TerminalReaderCollectInputsInputsSelectionChoicesParams

New APIs for Money CardManagement

• Add support for new resources V2.FinancialAddressCreditSimulation, V2.FinancialAddressGeneratedMicrodeposits, V2.MoneyManagement.Adjustment, V2.MoneyManagement.FinancialAccount, V2.MoneyManagement.FinancialAddress, V2.MoneyManagement.InboundTransfer, V2.MoneyManagement.OutboundPaymentQuote, V2.MoneyManagement.OutboundPayment, V2.MoneyManagement.OutboundSetupIntent, V2.MoneyManagement.OutboundTransfer, V2.MoneyManagement.PayoutMethod, V2.MoneyManagement.PayoutMethodsBankAccountSpec, V2.MoneyManagement.ReceivedCredit, V2.MoneyManagement.ReceivedDebit, V2.MoneyManagement.TransactionEntry, and V2.MoneyManagement.Transaction
• Add support for New method on resource V2.MoneyManagement.OutboundPaymentQuote
• Add support for Get and List methods on resources V2.MoneyManagement.Adjustment, V2.MoneyManagement.FinancialAccount, V2.MoneyManagement.ReceivedCredit, V2.MoneyManagement.ReceivedDebit, V2.MoneyManagement.TransactionEntry, and V2.MoneyManagement.Transaction
• Add support for Get, List, and New methods on resources V2.MoneyManagement.FinancialAddress and V2.MoneyManagement.InboundTransfer
• Add support for Cancel, Get, List, and New methods on resources V2.MoneyManagement.OutboundPayment and V2.MoneyManagement.OutboundTransfer
• Add support for Archive, Get, List, and Unarchive methods on resource V2.MoneyManagement.PayoutMethod
• Add support for Cancel, Get, List, New, and Update methods on resource V2.MoneyManagement.OutboundSetupIntent
• Add support for Get method on resource V2.MoneyManagement.PayoutMethodsBankAccountSpec
• Add support for new values account_number, fedwire_routing_number, and routing_number on enum InvalidPaymentMethod.InvalidParam
• Add support for new thin event V2MoneyManagementFinancialAccountCreatedEvent with related object V2.MoneyManagement.FinancialAccount
• Add support for new thin events V2MoneyManagementFinancialAddressActivatedEvent and V2MoneyManagementFinancialAddressFailedEvent with related object V2.MoneyManagement.FinancialAddress
• Add support for new thin events V2MoneyManagementInboundTransferAvailableEvent, V2MoneyManagementInboundTransferBankDebitFailedEvent, V2MoneyManagementInboundTransferBankDebitProcessingEvent, V2MoneyManagementInboundTransferBankDebitQueuedEvent, V2MoneyManagementInboundTransferBankDebitReturnedEvent, and V2MoneyManagementInboundTransferBankDebitSucceededEvent with related object V2.MoneyManagement.InboundTransfer
• Add support for new thin events V2MoneyManagementOutboundPaymentCanceledEvent, V2MoneyManagementOutboundPaymentCreatedEvent, V2MoneyManagementOutboundPaymentFailedEvent, V2MoneyManagementOutboundPaymentPostedEvent, and V2MoneyManagementOutboundPaymentReturnedEvent with related object V2.MoneyManagement.OutboundPayment
• Add support for new thin events V2MoneyManagementOutboundTransferCanceledEvent, V2MoneyManagementOutboundTransferCreatedEvent, V2MoneyManagementOutboundTransferFailedEvent, V2MoneyManagementOutboundTransferPostedEvent, and V2MoneyManagementOutboundTransferReturnedEvent with related object V2.MoneyManagement.OutboundTransfer
• Add support for new thin events V2MoneyManagementReceivedCreditAvailableEvent, V2MoneyManagementReceivedCreditFailedEvent, V2MoneyManagementReceivedCreditReturnedEvent, and V2MoneyManagementReceivedCreditSucceededEvent with related object V2.MoneyManagement.ReceivedCredit
• Add support for new thin events V2MoneyManagementReceivedDebitCanceledEvent, V2MoneyManagementReceivedDebitFailedEvent, V2MoneyManagementReceivedDebitPendingEvent, V2MoneyManagementReceivedDebitSucceededEvent, and V2MoneyManagementReceivedDebitUpdatedEvent with related object V2.MoneyManagement.ReceivedDebit
• Add support for new error types AlreadyCanceledError, BlockedByStripeError, ControlledByDashboardError, FeatureNotEnabledError, FinancialAccountNotOpenError, InsufficientFundsError, InvalidPayoutMethodError, NotCancelableError, and RecipientNotNotifiableError
  ...

v82.0.0

• #1992 Support for APIs in the new API version 2025-03-31.basil

  This release changes the pinned API version to 2025-03-31.basil.

  ⚠️ Breaking changes due to changes in the Stripe API

  Please review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.

  • Remove support for resources UsageRecordSummary and UsageRecord
  • Remove support for New method on resource UsageRecord
  • Remove support for List method on resource UsageRecordSummary
  • Remove support for UpcomingLines and Upcoming methods on resource Invoice
  • Remove support for UsageRecordSummaries method on resource SubscriptionItem
  • Remove support for Invoice on Charge and PaymentIntent
  • Remove support for ShippingDetails on CheckoutSession
  • Remove support for Carrier, Phone, and TrackingNumber on CheckoutSessionCollectedInformationShippingDetails
  • Remove support for Refund on CreditNoteParams, CreditNotePreviewLinesParams, CreditNotePreviewParams, and CreditNote
  • Remove support for TaxAmounts on CreditNoteLineItem, CreditNote, and InvoiceLineItem
  • Remove support for AmountExcludingTax and UnitAmountExcludingTax on CreditNoteLineItem and InvoiceLineItem
  • Remove support for Coupon on CustomerParams, InvoiceCreatePreviewParams, InvoiceCreatePreviewScheduleDetailsPhasesParams, SubscriptionParams, SubscriptionSchedulePhasesParams, and SubscriptionSchedulePhases
  • Remove support for PromotionCode on CustomerParams and SubscriptionParams
  • Remove support for Price on InvoiceAddLinesLinesParams, InvoiceItemParams, InvoiceItem, InvoiceLineItemParams, InvoiceLineItem, and InvoiceUpdateLinesLinesParams
  • Remove support for BillingThresholds on InvoiceCreatePreviewScheduleDetailsPhasesItemsParams, InvoiceCreatePreviewScheduleDetailsPhasesParams, InvoiceCreatePreviewSubscriptionDetailsItemsParams, SubscriptionItemParams, SubscriptionItem, SubscriptionItemsParams, SubscriptionParams, SubscriptionScheduleDefaultSettingsParams, SubscriptionScheduleDefaultSettings, SubscriptionSchedulePhasesItemsParams, SubscriptionSchedulePhasesItems, SubscriptionSchedulePhasesParams, SubscriptionSchedulePhases, and Subscription
  • Remove support for ApplicationFeeAmount, Charge, PaidOutOfBand, Paid, PaymentIntent, Quote, Subscription, SubscriptionDetails, SubscriptionProrationDate, Tax, TotalTaxAmounts, and TransferData on Invoice
  • Remove support for Discount on Invoice and Subscription
  • Remove support for InvoiceItem, ProrationDetails, Proration, TaxRates, and Type on InvoiceLineItem
  • Remove support for Plan and SubscriptionItem on InvoiceItem and InvoiceLineItem
  • Remove support for UnitAmount on InvoiceItemParams and InvoiceItem
  • Remove support for Subscription and UnitAmountDecimal on InvoiceItem
  • Remove support for NaverPay on PaymentMethodParams
  • Remove support for AggregateUsage on PlanParams, Plan, PriceRecurringParams, and PriceRecurring
  • Remove support for CurrentPeriodEnd and CurrentPeriodStart on Subscription

  ⚠️ Other Breaking changes in the SDK

  • #1999 Upgrade to go 1.18
    • Go version 1.18 or later is now required to address security vulnerabilities in Go <= 1.17. In particular, HTTP/2 is enabled now by default for all users (it was disabled for Go <= 1.14).
  • #1998 Breaking changes to support V2
    • Renamed the stripe.Amount type in the stripe.Balance object to stripe.BalanceAmount
    • Changed the signature of the CallRaw method in the stripe.Backend interface to accept a []byte instead of *form.Values in its fourth argument. Call sites can safely replace a *form.Values argument v with []byte(v.Encode()) (Encode is nil-safe).

  Additions to Stripe API

  • Add support for new resource InvoicePayment
  • Add support for Get and List methods on resource InvoicePayment
  • Add support for BilliePayments, NzBankAccountBECSDebitPayments, and SatispayPayments on AccountCapabilitiesParams and AccountCapabilities
  • Add support for HostedPaymentMethodSave on AccountSettingsInvoicesParams and AccountSettingsInvoices
  • Add support for Invoices on AccountSettingsParams
  • Add support for new values forwarding_api_retryable_upstream_error and setup_intent_mobile_wallet_unsupported on enums InvoiceLastFinalizationError.Code, PaymentIntentLastPaymentError.Code, SetupAttemptSetupError.Code, SetupIntentLastSetupError.Code, and StripeError.Code
  • Add support for new values stripe_balance_payment_debit_reversal and stripe_balance_payment_debit on enum BalanceTransaction.Type
  • Add support for new values information_missing, invalid_signator, verification_failed_authorizer_authority, and verification_rejected_ownership_exemption_reason on enums BankAccountFutureRequirementsErrors.Code and BankAccountRequirementsErrors.Code
  • Add support for new value last on enum BillingMeterDefaultAggregation.Formula
  • Add support for PresentmentDetails on Charge, CheckoutSession, PaymentIntent, and Refund
  • Add support for Billie and Satispay on ChargePaymentMethodDetails, ConfirmationTokenPaymentMethodDataParams, ConfirmationTokenPaymentMethodPreview, PaymentIntentConfirmPaymentMethodDataParams, PaymentIntentPaymentMethodDataParams, PaymentMethodConfigurationParams, PaymentMethodConfiguration, PaymentMethodParams, PaymentMethod, SetupIntentConfirmPaymentMethodDataParams, and SetupIntentPaymentMethodDataParams
  • Add support for NzBankAccount on ChargePaymentMethodDetails, ConfirmationTokenPaymentMethodDataParams, ConfirmationTokenPaymentMethodPreview, MandatePaymentMethodDetails, PaymentIntentConfirmPaymentMethodDataParams, PaymentIntentConfirmPaymentMethodOptionsParams, PaymentIntentPaymentMethodDataParams, PaymentIntentPaymentMethodOptionsParams, PaymentIntentPaymentMethodOptions, PaymentMethodConfigurationParams, PaymentMethodConfiguration, PaymentMethodParams, PaymentMethod, SetupAttemptPaymentMethodDetails, SetupIntentConfirmPaymentMethodDataParams, and SetupIntentPaymentMethodDataParams
  • Add support for OptionalItems on CheckoutSessionParams, CheckoutSession, PaymentLinkParams, and PaymentLink
  • Add support for Permissions on CheckoutSessionParams and CheckoutSession
  • Add support for ShippingOptions on CheckoutSessionParams
  • Add support for new value custom on enum CheckoutSession.UIMode
  • Add support for BuyerID on ConfirmationTokenPaymentMethodPreviewNaverPay and PaymentMethodNaverPay
  • Add support for new values billie, nz_bank_account, and satispay on enums ConfirmationTokenPaymentMethodPreview.Type and PaymentMethod.Type
  • Add support for Refunds on CreditNoteParams, CreditNotePreviewLinesParams, CreditNotePreviewParams, and CreditNote
  • Add support for TotalTaxes on CreditNote and Invoice
  • Add support for Taxes on CreditNoteLineItem and InvoiceLineItem
  • Add support for TaxabilityReason on InvoiceAddLinesLinesTaxAmountsParams, InvoiceLineItemTaxAmountsParams, and InvoiceUpdateLinesLinesTaxAmountsParams
  • Add support for JurisdictionLevel on InvoiceAddLinesLinesTaxAmountsTaxRateDataParams, InvoiceLineItemTaxAmountsTaxRateDataParams, and InvoiceUpdateLinesLinesTaxAmountsTaxRateDataParams
  • Add support for AmountOverpaid, ConfirmationSecret, and Payments on Invoice
  • Add support for Parent on InvoiceItem, InvoiceLineItem, and Invoice
  • Add support for new values klarna and nz_bank_account on enums InvoicePaymentSettings.PaymentMethodTypes and SubscriptionPaymentSettings.PaymentMethodTypes
  • Add support for CheckoutSession on CustomerBalanceTransaction
  • Add support for new values checkout_session_subscription_payment_canceled and checkout_session_subscription_payment on enum CustomerBalanceTransaction.Type
  • Add support for new value invoice.overpaid on enum Event.Type
  • Add support for Pricing on InvoiceAddLinesLinesParams, InvoiceItemParams, InvoiceItem, InvoiceLineItemParams, InvoiceLineItem, and InvoiceUpdateLinesLinesParams
  • Add support for Wifi on TerminalConfigurationParams and TerminalConfiguration
  • Add support for NzBankTransfer on RefundDestinationDetails
  • Add support for new value canceled on enum Review.ClosedReason
  • Add support for CurrentPeriodEnd and CurrentPeriodStart on SubscriptionItem
  • Add support for NaverPay on MandatePaymentMethodDetails and SetupAttemptPaymentMethodDetails
  • Add support for SetupFutureUsage on PaymentIntentConfirmPaymentMethodOptionsNaverPayParams, PaymentIntentPaymentMethodOptionsNaverPayParams, and PaymentIntentPaymentMethodOptionsNaverPay
  • Add support for new value expired on enum PaymentIntent.CancellationReason
  • Add support for DefaultValue on PaymentLinkCustomFieldsDropdownParams, PaymentLinkCustomFieldsDropdown, PaymentLinkCustomFieldsNumericParams, PaymentLinkCustomFieldsNumeric, PaymentLinkCustomFieldsTextParams, and PaymentLinkCustomFieldsText
  • Add support for new values billie and satispay on enum PaymentLink.PaymentMethodTypes

See the changelog for more details.

v81.5.0-beta.1

• #1997 Beta SDK updates between Open API versions 1473 and 1505

  • Add support for SucceedInputCollection and TimeoutInputCollection test helper methods on resource Terminal.Reader
  • Add support for TargetDate on OrderPaymentSettingsPaymentMethodOptionsAcssDebitParams, OrderPaymentSettingsPaymentMethodOptionsAcssDebit, OrderPaymentSettingsPaymentMethodOptionsSepaDebitParams, and OrderPaymentSettingsPaymentMethodOptionsSepaDebit

• #1995 Revert "Merge pull request #1987 from stripe/latest-codegen-beta"

• #1987 Update generated code for beta

  • Add support for SucceedInputCollection and TimeoutInputCollection test helper methods on resource Terminal.Reader
  • Add support for new value setup_intent_mobile_wallet_unsupported on enums InvoiceLastFinalizationErrorCode, PaymentIntentLastPaymentErrorCode, SetupAttemptSetupErrorCode, SetupIntentLastSetupErrorCode, and StripeErrorCode
  • Remove support for Carrier, Phone, and TrackingNumber on CheckoutSessionCollectedInformationShippingDetails
  • Add support for InterchangeFeesAmount, NetTotalAmount, NetworkFeesAmount, OtherFeesAmount, OtherFeesCount, and TransactionAmount on IssuingSettlement
  • Remove support for InterchangeFees, NetTotal, NetworkFees, and TransactionVolume on IssuingSettlement
  • Add support for TargetDate on OrderPaymentSettingsPaymentMethodOptionsAcssDebitParams, OrderPaymentSettingsPaymentMethodOptionsAcssDebit, OrderPaymentSettingsPaymentMethodOptionsSepaDebitParams, and OrderPaymentSettingsPaymentMethodOptionsSepaDebit
  • Add support for ACHCreditTransfer, ACHDebit, ACSSDebit, AUBECSDebit, Affirm, AfterpayClearpay, Alipay, Alma, AmazonPay, BACSDebit, BLIK, Bancontact, Boleto, CardPresent, Card, CashApp, CustomerBalance, EPS, FPX, Giropay, Gopay, Grabpay, IDBankTransfer, IDEAL, InteracPresent, KakaoPay, Klarna, Konbini, KrCard, Link, MbWay, Mobilepay, Multibanco, NaverPay, OXXO, P24, PayByBank, PayNow, Payco, Paypal, Payto, Pix, PromptPay, Qris, Rechnung, RevolutPay, SEPACreditTransfer, SEPADebit, SamsungPay, Shopeepay, Sofort, StripeAccount, Swish, TWINT, USBankAccount, WeChatPay, WeChat, and Zip on PaymentAttemptRecordPaymentMethodDetails and PaymentRecordPaymentMethodDetails
  • Change type of PaymentAttemptRecordPaymentMethodDetailsCustom and PaymentRecordPaymentMethodDetailsCustom from nullable(PaymentsPrimitivesPaymentRecordsResourcePaymentMethodDetailsResourceCustomDetails) to PaymentsPrimitivesPaymentRecordsResourcePaymentMethodCustomDetails
  • Change type of PaymentAttemptRecordPaymentMethodDetailsType and PaymentRecordPaymentMethodDetailsType from literal('custom') to string
  • Add support for Wifi on TerminalConfigurationParams and TerminalConfiguration

See the changelog for more details.