• #2084 Pull in V2 FinancialAccount changes for June release
  • Add support for Close and New methods on resource V2MoneyManagementFinancialAccount
  • Add support for new value storer on enum V2CoreAccount.AppliedConfigurations
  • Add support for Storer on V2CoreAccountConfigurationParams and V2CoreAccountConfiguration
  • Add support for new values financial_addresses.bank_accounts, holds_currencies.gbp, inbound_transfers.financial_accounts, outbound_payments.bank_accounts, outbound_payments.cards, outbound_payments.financial_accounts, outbound_transfers.bank_accounts, and outbound_transfers.financial_accounts on enum V2CoreAccountRequirementsEntriesImpactRestrictsCapabilities.Capability
  • Add support for new value storer on enum V2CoreAccountRequirementsEntriesImpactRestrictsCapabilities.Configuration
  • Add support for StatusDetails on V2MoneyManagementFinancialAccount
  • Add support for Status on V2MoneyManagementFinancialAccountListParams
  • Add support for thin events V2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationStorerUpdatedEvent with related object V2CoreAccount
  • Add support for error types AlreadyExistsError and NonZeroBalanceError

See the changelog for more details.

• #2069 Update generated code for beta
  • Change type of CheckoutSessionSubscriptionDataParams.BillingMode, InvoiceCreatePreviewScheduleDetailsParams.BillingMode, InvoiceCreatePreviewSubscriptionDetailsParams.BillingMode, QuoteSubscriptionData.BillingMode, QuoteSubscriptionDataParams.BillingMode, SubscriptionParams.BillingMode, and SubscriptionScheduleParams.BillingMode from enum('classic'|'flexible') to billing_mode
  • Add support for SubmissionMethod on DisputeEvidenceDetails
  • Add support for OnDemand and Subscriptions on OrderPaymentSettingsPaymentMethodOptionsKlarnaParams
  • Change type of OrderPaymentSettingsPaymentMethodOptionsKlarna.SetupFutureUsage and OrderPaymentSettingsPaymentMethodOptionsKlarnaParams.SetupFutureUsage from literal('none') to enum('none'|'off_session'|'on_session')
  • Add support for Crypto on PaymentAttemptRecordPaymentMethodDetails and PaymentRecordPaymentMethodDetails
  • Add support for new value buut on enums PaymentAttemptRecordPaymentMethodDetailsIdeal.Bank and PaymentRecordPaymentMethodDetailsIdeal.Bank
  • Add support for new value BUUTNL2A on enums PaymentAttemptRecordPaymentMethodDetailsIdeal.BIC and PaymentRecordPaymentMethodDetailsIdeal.BIC
  • Change type of PaymentIntentConfirmPaymentMethodOptionsGopayParams.SetupFutureUsage, PaymentIntentPaymentMethodOptionsGopay.SetupFutureUsage, and PaymentIntentPaymentMethodOptionsGopayParams.SetupFutureUsage from literal('none') to enum('none'|'off_session')
  • Add support for new value crypto on enum QuotePreviewInvoicePaymentSettings.PaymentMethodTypes
  • Change type of QuotePreviewSubscriptionSchedule.BillingMode, Subscription.BillingMode, and SubscriptionSchedule.BillingMode from enum('classic'|'flexible') to SubscriptionsResourceBillingMode
  • Change type of SubscriptionMigrateParams.BillingMode from literal('flexible') to billing_mode_migrate
  • Remove support for BillingModeDetails on Subscription
  • Add support for new value xx on enums V2CoreAccountConfigurationCustomerAutomaticIndirectTaxLocation.Country, V2CoreAccountConfigurationCustomerShippingAddress.Country, V2CoreAccountConfigurationMerchantSupportAddress.Country, V2CoreAccountIdentity.Country, V2CoreAccountIdentityBusinessDetailsAddress.Country, V2CoreAccountIdentityBusinessDetailsScriptAddressesKana.Country, V2CoreAccountIdentityBusinessDetailsScriptAddressesKanji.Country, V2CoreAccountIdentityIndividualAdditionalAddresses.Country, V2CoreAccountIdentityIndividualAddress.Country, V2CoreAccountIdentityIndividualScriptAddressesKana.Country, V2CoreAccountIdentityIndividualScriptAddressesKanji.Country, V2CorePersonAdditionalAddresses.Country, V2CorePersonAddress.Country, V2CorePersonScriptAddressesKana.Country, V2CorePersonScriptAddressesKanji.Country, and V2MoneyManagementFinancialAccount.Country
  • Add support for new value unsupported_entity_type on enums V2CoreAccountConfigurationCustomerCapabilitiesAutomaticIndirectTaxStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesAchDebitPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesAcssDebitPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesAffirmPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesAfterpayClearpayPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesAlmaPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesAmazonPayPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesAuBecsDebitPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesBacsDebitPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesBancontactPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesBlikPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesBoletoPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesCardPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesCartesBancairesPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesCashappPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesEpsPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesFpxPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesGbBankTransferPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesGrabpayPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesIdealPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesJcbPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesJpBankTransferPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesKakaoPayPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesKlarnaPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesKonbiniPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesKrCardPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesLinkPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesMobilepayPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesMultibancoPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesMxBankTransferPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesNaverPayPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesOxxoPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesP24PaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesPayByBankPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesPaycoPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesPaynowPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesPromptpayPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesRevolutPayPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesSamsungPayPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesSepaBankTransferPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesSepaDebitPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesStripeBalancePayoutsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesSwishPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesTwintPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesUsBankTransferPaymentsStatusDetail.Code, V2CoreAccountConfigurationMerchantCapabilitiesZipPaymentsStatusDetail.Code, V2CoreAccountConfigurationRecipientCapabilitiesBankAccountsLocalStatusDetail.Code, V2CoreAccountConfigurationRecipientCapabilitiesBankAccountsWireStatusDetail.Code, V2CoreAccountConfigurationRecipientCapabilitiesCardsStatusDetail.Code, V2CoreAccountConfigurationRecipientCapabilitiesStripeBalancePayoutsStatusDetail.Code, and V2CoreAccountConfigurationRecipientCapabilitiesStripeBalanceStripeTransfersStatusDetail.Code
  • Add support for ProofOfAddress on V2CoreAccountIdentityBusinessDetailsDocumentsParams and V2CoreAccountIdentityBusinessDetailsDocuments
  • Add support for new value xx on enums V2CoreAccountIdentityIndividual.Nationalities and V2CorePerson.Nationalities
  • Add support for Metadata on V2MoneyManagementFinancialAccount
  • Remove support for Description on V2MoneyManagementFinancialAccount
  • Add support for new value pending on enum V2MoneyManagementFinancialAccount.Status
  • Remove support for Attempts on V2PaymentsOffSessionPayment
  • Add support for FromAccount, OutboundPayment, and OutboundTransfer on V2MoneyManagementReceivedCreditBalanceTransfer
  • Change type of V2MoneyManagementReceivedCreditBalanceTransfer.Type from literal('payout_v1') to enum('outbound_payment'|'outbound_transfer'|'payout_v1')
  • Add support for error codes recipient_feature_not_active, storer_capability_missing, and storer_capability_not_active on FeatureNotEnabledError
  • Remove support for error code outbound_payment_recipient_feature_not_active on FeatureNotEnabledError
  • Add support for error code insufficient_funds on InsufficientFundsError
  • Remove support for error codes outbound_payment_insufficient_funds and outbound_transfer_insufficient_funds on InsufficientFundsError
  • Add support for error codes recipient_amount_limit_exceeded and recipient_count_limit_exceeded on QuotaExceededError
  • Remove support for error codes outbound_payment_recipient_amount_limit_exceeded and outbound_payment_recipient_count_limit_exceeded on QuotaExceededError
  • Add support for error code recipient_email_does_not_exist on RecipientNotNotifiableError
  • Remove support for error code outbound_payment_recipient_email_does_not_exist on RecipientNotNotifiableError

See the changelog for more details.

• #2078 Update generated code
  • Add support for Migrate method on resource Subscription
  • Add support for CollectPaymentMethod and ConfirmPaymentIntent methods on resource TerminalReader
  • Add support for CryptoPayments on AccountCapabilitiesParams and AccountCapabilities
  • Add support for ProofOfAddress on AccountDocumentsParams
  • Add support for MonthlyPayoutDays and WeeklyPayoutDays on AccountSettingsPayoutsScheduleParams and AccountSettingsPayoutsSchedule
  • Add support for Crypto on ChargePaymentMethodDetails, ConfirmationTokenPaymentMethodDataParams, ConfirmationTokenPaymentMethodPreview, PaymentIntentConfirmPaymentMethodDataParams, PaymentIntentConfirmPaymentMethodOptionsParams, PaymentIntentPaymentMethodDataParams, PaymentIntentPaymentMethodOptionsParams, PaymentIntentPaymentMethodOptions, PaymentMethodParams, PaymentMethod, SetupIntentConfirmPaymentMethodDataParams, and SetupIntentPaymentMethodDataParams
  • Add support for Subscriptions on CheckoutSessionPaymentMethodOptionsKlarnaParams, PaymentIntentConfirmPaymentMethodOptionsKlarnaParams, and PaymentIntentPaymentMethodOptionsKlarnaParams
  • Add support for BillingMode on CheckoutSessionSubscriptionDataParams, InvoiceCreatePreviewScheduleDetailsParams, InvoiceCreatePreviewSubscriptionDetailsParams, QuoteSubscriptionDataParams, QuoteSubscriptionData, SubscriptionParams, SubscriptionScheduleParams, SubscriptionSchedule, and Subscription
  • Change type of ConfirmationTokenPaymentMethodOptionsCardInstallmentsPlan.Type, ConfirmationTokenPaymentMethodOptionsCardInstallmentsPlanParams.Type, InvoicePaymentSettingsPaymentMethodOptionsCardInstallmentsPlanParams.Type, PaymentIntentConfirmPaymentMethodOptionsCardInstallmentsPlanParams.Type, PaymentIntentPaymentMethodOptionsCardInstallmentsPlan.Type, and PaymentIntentPaymentMethodOptionsCardInstallmentsPlanParams.Type from literal('fixed_count') to enum('bonus'|'fixed_count'|'revolving')
  • Add support for new value buut on enum ConfirmationTokenPaymentMethodPreviewIdeal.Bank
  • Add support for new value BUUTNL2A on enum ConfirmationTokenPaymentMethodPreviewIdeal.BIC
  • Add support for new value crypto on enums ConfirmationTokenPaymentMethodPreview.Type and PaymentMethod.Type
  • Change type of Dispute.EnhancedEligibilityTypes from literal('visa_compelling_evidence_3') to enum('visa_compelling_evidence_3'|'visa_compliance')
  • Add support for new value compliance on enum DisputePaymentMethodDetailsCard.CaseType
  • Add support for new value terminal.reader.action_updated on enum Event.Type
  • Add support for RelatedPerson on IdentityVerificationSessionParams and IdentityVerificationSession
  • Add support for Matching on IdentityVerificationSessionOptions
  • Add support for new value crypto on enums InvoicePaymentSettings.PaymentMethodTypes and SubscriptionPaymentSettings.PaymentMethodTypes
  • Add support for Klarna on MandatePaymentMethodDetails, SetupIntentConfirmPaymentMethodOptionsParams, SetupIntentPaymentMethodOptionsParams, and SetupIntentPaymentMethodOptions
  • Add support for OnDemand on PaymentIntentConfirmPaymentMethodOptionsKlarnaParams and PaymentIntentPaymentMethodOptionsKlarnaParams
  • Change type of PaymentIntentConfirmPaymentMethodOptionsKlarnaParams.SetupFutureUsage, PaymentIntentPaymentMethodOptionsKlarna.SetupFutureUsage, and PaymentIntentPaymentMethodOptionsKlarnaParams.SetupFutureUsage from literal('none') to enum('none'|'off_session'|'on_session')
  • Add support for Ua on TaxRegistrationCountryOptionsParams and TaxRegistrationCountryOptions
  • Change type of TerminalLocationParams.DisplayName from string to emptyable(string)
  • Add support for CollectPaymentMethod and ConfirmPaymentIntent on TerminalReaderAction
  • Add support for new values collect_payment_method and confirm_payment_intent on enum TerminalReaderAction.Type
  • Add support for Status on TreasuryFinancialAccountListParams
  • Add support for snapshot event EventTypeTerminalReaderActionUpdated with resource TerminalReader
• #2082 Add form information to amount
• #2076 Switch to use generated API versions and add major/monthly version constants
  • Export constants for the major and monthly API versions
    • e.g. 2025-05-28.basil has major version basil and monthly version 2025-05-28

See the changelog for more details.

• #2081 Pull in OffSessionPayment changes for the May release

See the changelog for more details.

• #2073 Update DisputeReason to include value noncompliant
  • Adds noncompliant to DisputeReason enum
• #2070 Fix failing telemetry test
• #2068 Deduplicate telemetry strings
  • Fixes a bug where telemetry strings could have duplicate values

See the changelog for more details.

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.

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.

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

See the changelog for more details.

• #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.

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.