[Snyk] Upgrade stripe from 15.12.0 to 18.1.1 #156
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Snyk has created this PR to upgrade stripe from 15.12.0 to 18.1.1. See this package in npm: stripe See this project in Snyk: https://app.snyk.io/org/nerds-github/project/ef708957-d107-4807-bb9b-ffb67ea15337?utm_source=github&utm_medium=referral&page=upgrade-pr
Reviewer's GuideThis PR upgrades the Stripe SDK from v15.8.0 to v18.1.1 in the dashboard application by updating the dependency declaration in package.json. ER Diagram: Stripe API Entity Attribute Changes (Post-SDK Upgrade to v18.1.1)erDiagram
Account {
string business_profile_minority_owned_business_designation "new (v18.1.0, via BusinessProfile entity)"
string company_registration_date "new (v18.1.0, via Company entity)"
}
Charge {
string invoice "removed (v18.0.0)"
string billing_details_tax_id "new (v18.1.0, via BillingDetails entity)"
}
Invoice {
string application_fee_amount "removed (v18.0.0)"
string charge_attribute "removed (v18.0.0, attribute named 'charge')"
string payment_intent_attribute "removed (v18.0.0, attribute named 'payment_intent')"
string payments "new (v18.0.0, array of payment objects)"
number amount_overpaid "new (v18.0.0)"
string parent_attribute "new (v18.0.0, attribute named 'parent')"
}
PaymentIntent {
string invoice "removed (v18.0.0)"
}
Event {
string context "new (v18.1.0)"
}
Refund {
string pending_reason "new (v18.1.0)"
}
Class Diagram: Key Stripe SDK Class Changes (Upgrade to v18.1.1)classDiagram
direction LR
class StripeClient {
+rawRequest(String method, String path, Object params, RawRequestOptions options) Object
}
class RawRequestOptions {
+String host (new option in v18.1.1)
+Boolean streaming (new option in v18.1.1)
}
StripeClient ..> RawRequestOptions : uses
class Account {
+BusinessProfile business_profile
+Company company
%% Other existing fields
}
class BusinessProfile {
+String minority_owned_business_designation (new in v18.1.0)
%% Other existing fields
}
class Company {
+String registration_date (new in v18.1.0)
%% Other existing fields
}
Account "1" *-- "1" BusinessProfile
Account "1" *-- "1" Company
class Charge {
+BillingDetails billing_details
-String invoice (removed in v18.0.0)
%% Other existing fields
}
class BillingDetails {
+String tax_id (new in v18.1.0)
%% Other existing fields
}
Charge "1" *-- "1" BillingDetails
class Invoice {
-String application_fee_amount (removed in v18.0.0)
-String charge (removed in v18.0.0)
-String payment_intent (removed in v18.0.0)
+List~Object~ payments (new in v18.0.0)
+Number amount_overpaid (new in v18.0.0)
+Object parent (new in v18.0.0)
%% Other existing fields
}
class PaymentIntent {
-String invoice (removed in v18.0.0)
%% Other existing fields
}
class Event {
+Object context (new in v18.1.0)
%% Other existing fields
}
class Refund {
+String pending_reason (new in v18.1.0)
%% Other existing fields
}
File-Level Changes
Tips and commandsInteracting with Sourcery
Customizing Your ExperienceAccess your dashboard to:
Getting Help
|
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Snyk has created this PR to upgrade stripe from 15.12.0 to 18.1.1.
ℹ️ Keep your dependencies up-to-date. This makes it easier to fix existing vulnerabilities and to more quickly identify and fix newly disclosed vulnerabilities when they affect your project.
The recommended version is 53 versions ahead of your current version.
The recommended version was released 21 days ago.
Issues fixed by the recommended upgrade:
SNYK-JS-SUPABASEAUTHJS-10255365
Release notes
Package name: stripe
hostandstreamingin request options.See the changelog for more details.
This release changes the pinned API version to
2025-04-30.basil.minority_owned_business_designationonAccount.business_profile,AccountCreateParams.business_profile, andAccountUpdateParams.business_profileregistration_dateonAccount.company,AccountCreateParams.company,AccountUpdateParams.company, andTokenCreateParams.account.companyus_cfpb_dataonAccountCreatePersonParams,AccountUpdatePersonParams,Person, andTokenCreateParams.personverification_legal_entity_structure_mismatchon enumsAccount.future_requirements.errors[].code,Account.requirements.errors[].code,BankAccount.future_requirements.errors[].code,BankAccount.requirements.errors[].code,Capability.future_requirements.errors[].code,Capability.requirements.errors[].code,Person.future_requirements.errors[].code, andPerson.requirements.errors[].codetax_id_prohibitedon enumsInvoice.last_finalization_error.code,PaymentIntent.last_payment_error.code,SetupAttempt.setup_error.code,SetupIntent.last_setup_error.code, andStripeError.codetax_idonCharge.billing_details,ConfirmationToken.payment_method_preview.billing_details,ConfirmationTokenCreateParams.testHelpers.payment_method_data.billing_details,PaymentIntentConfirmParams.payment_method_data.billing_details,PaymentIntentCreateParams.payment_method_data.billing_details,PaymentIntentUpdateParams.payment_method_data.billing_details,PaymentMethod.billing_details,PaymentMethodCreateParams.billing_details,PaymentMethodUpdateParams.billing_details,SetupIntentConfirmParams.payment_method_data.billing_details,SetupIntentCreateParams.payment_method_data.billing_details, andSetupIntentUpdateParams.payment_method_data.billing_detailswallet_optionsonCheckout.SessionCreateParamsandCheckout.SessionprovideronCheckout.Session.automatic_tax,Invoice.automatic_tax, andQuote.automatic_taxaw_tin,az_tin,bd_bin,bf_ifu,bj_ifu,cm_niu,cv_nif,et_tin,kg_tin, andla_tinon enumsCheckout.Session.customer_details.tax_ids[].type,Invoice.customer_tax_ids[].type,Tax.Calculation.customer_details.tax_ids[].type,Tax.Transaction.customer_details.tax_ids[].type, andTaxId.typepayment_method_optionsonConfirmationTokenCreateParams.testHelpersinstallmentsonConfirmationToken.payment_method_options.cardaw_tin,az_tin,bd_bin,bf_ifu,bj_ifu,cm_niu,cv_nif,et_tin,kg_tin, andla_tinon enumsCustomerCreateParams.tax_id_data[].type,CustomerCreateTaxIdParams.type,InvoiceCreatePreviewParams.customer_details.tax_ids[].type,Tax.CalculationCreateParams.customer_details.tax_ids[].type, andTaxIdCreateParams.typecontextonEventaffirmon enumsInvoice.payment_settings.payment_method_types,InvoiceCreateParams.payment_settings.payment_method_types,InvoiceUpdateParams.payment_settings.payment_method_types,Subscription.payment_settings.payment_method_types,SubscriptionCreateParams.payment_settings.payment_method_types, andSubscriptionUpdateParams.payment_settings.payment_method_typesInvoiceLineItem.parent.subscription_item_details.subscriptionfromstringtostring | nullbillieonPaymentIntent.payment_method_options,PaymentIntentConfirmParams.payment_method_options,PaymentIntentCreateParams.payment_method_options, andPaymentIntentUpdateParams.payment_method_optionspixonPaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams, andPaymentMethodConfigurationklarnaonPaymentMethodDomainpending_reasononRefundTax.CalculationLineItem.referencefromstring | nulltostringaw,az,bd,bf,bj,cm,cv,et,in,kg,la, andphonTax.Registration.country_optionsandTax.RegistrationCreateParams.country_options2025-04-30.basilon enumWebhookEndpointCreateParams.api_versionSee the changelog for more details.
FxQuoteandPaymentIntentAmountDetailsLineItemcreate,list, andretrievemethods on resourceFxQuoteattach_payment_intentmethod on resourceInvoiceregistration_dateonAccount.company,AccountCreateParams.company,AccountUpdateParams.company, andTokenCreateParams.account.companycustomer_referenceandorder_referenceonChargeCaptureParams.payment_details,ChargeUpdateParams.payment_details,PaymentIntent.payment_details,PaymentIntentCaptureParams.payment_details,PaymentIntentConfirmParams.payment_details,PaymentIntentCreateParams.payment_details, andPaymentIntentUpdateParams.payment_detailstax_idonCharge.billing_details,ConfirmationToken.payment_method_preview.billing_details,ConfirmationTokenCreateParams.testHelpers.payment_method_data.billing_details,PaymentIntentConfirmParams.payment_method_data.billing_details,PaymentIntentCreateParams.payment_method_data.billing_details,PaymentIntentUpdateParams.payment_method_data.billing_details,PaymentMethod.billing_details,PaymentMethodCreateParams.billing_details,PaymentMethodUpdateParams.billing_details,SetupIntentConfirmParams.payment_method_data.billing_details,SetupIntentCreateParams.payment_method_data.billing_details,SetupIntentUpdateParams.payment_method_data.billing_details, andTreasury.OutboundPaymentCreateParams.destination_payment_method_data.billing_detailsprice_dataonCheckout.SessionUpdateParams.line_items[]Checkout.SessionUpdateParams.line_items[].quantityfromlongIntegertoemptyable(longInteger)scriptonCouponCreateParamsandCoupontypeonCouponfx_quote.expiredon enumEvent.typeaffirmon enumsInvoice.payment_settings.payment_method_types,InvoiceCreateParams.payment_settings.payment_method_types,InvoiceUpdateParams.payment_settings.payment_method_types,QuotePreviewInvoice.payment_settings.payment_method_types,Subscription.payment_settings.payment_method_types,SubscriptionCreateParams.payment_settings.payment_method_types, andSubscriptionUpdateParams.payment_settings.payment_method_typesfx_quoteonPaymentIntentConfirmParams,PaymentIntentCreateParams,PaymentIntentUpdateParams,PaymentIntent,TransferCreateParams, andTransferdiscount_amount,line_items,shipping, andtaxonPaymentIntent.amount_detailspixonPaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams, andPaymentMethodConfigurationus_cfpb_dataonPersonandTokenCreateParams.personpending_reasononRefundaw,az,bd,bj,et,kg,la, andphonTax.Registration.country_optionsandTax.RegistrationCreateParams.country_optionsfx_quote.expiredon enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointUpdateParams.enabled_eventsFxQuoteExpiredEventwith resourceFxQuoteSee the changelog for more details.
#2298 Update generated code for beta
Breaking changes
V2.MoneyManagement.ReceivedDebit.status_transitionsfroman objecttoan object | nullbank_accounts.local_uk,bank_accounts.wire_uk,cards_uk, andcrypto_wallets_v2from enumEventsV2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent.updated_capabilityAdditions
Privacy.RedactionJobRootObjects,Privacy.RedactionJobValidationError, andPrivacy.RedactionJobcancel,create,list,retrieve,run,update, andvalidatemethods on resourceRedactionJoblistandretrievemethods on resourceRedactionJobValidationErrorminority_owned_business_designationonAccount.business_profile,AccountCreateParams.business_profile, andAccountUpdateParams.business_profileverification_legal_entity_structure_mismatchon enumsAccount.future_requirements.errors[].code,Account.requirements.errors[].code,AccountCapability.future_requirements.errors[].code,AccountCapability.requirements.errors[].code,AccountPerson.future_requirements.errors[].code,AccountPerson.requirements.errors[].code,BankAccount.future_requirements.errors[].code, andBankAccount.requirements.errors[].codeexport_tax_transactionsandpayment_disputesonAccountSessionCreateParams.componentstax_id_prohibitedon enumsInvoice.last_finalization_error.code,PaymentIntent.last_payment_error.code,QuotePreviewInvoice.last_finalization_error.code,SetupAttempt.setup_error.code,SetupIntent.last_setup_error.code, andStripeError.codefixed_term_loanon enumCapital.FinancingOffer.typewallet_optionsonCheckout.SessionCreateParamsandCheckout.Sessionprivacy.redaction_job.canceled,privacy.redaction_job.created,privacy.redaction_job.ready,privacy.redaction_job.succeeded, andprivacy.redaction_job.validation_erroron enumEvent.typeklarnaonPaymentMethodDomainTax.CalculationLineItem.referencefromstring | nulltostringinonTax.Registration.country_optionsandTax.RegistrationCreateParams.country_optionsprivacy.redaction_job.canceled,privacy.redaction_job.created,privacy.redaction_job.ready,privacy.redaction_job.succeeded, andprivacy.redaction_job.validation_erroron enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointUpdateParams.enabled_events#2300 Handle external_resource field
external_accountfield inExternalAccountsCreateParamsfrom astringto a union type.See the changelog for more details.
#2288 Update generated code for beta
This release changes the pinned API version to
2025-03-31.previewBreaking Changes
amount_overpaidonInvoicePaymentout_of_band_paymentandpayment_recordfrom enumInvoicePayment.payment.typeinterchange_fees,net_total,network_fees, andtransaction_volumeonIssuing.Settlementbilling_thresholdsonQuotePreviewSubscriptionSchedule.default_settings,QuotePreviewSubscriptionSchedule.phases[].items[], andQuotePreviewSubscriptionSchedule.phases[]coupononQuotePreviewSubscriptionSchedule.phases[]valueonTerminal.Reader.action.collect_inputs.inputs[].selection.choices[],Terminal.Reader.action.collect_inputs.inputs[].selection, andTerminal.ReaderCollectInputsParams.inputs[].selection.choices[]Checkout.Session.permissions.updateto be optionalInvoicePayment.is_defaultfromboolean | nulltobooleanInvoice.amount_overpaidandQuotePreviewInvoice.amount_overpaidto be requiredPaymentAttemptRecord.payment_method_details.typeandPaymentRecord.payment_method_details.typefromliteral('custom')tostringPaymentAttemptRecord.payment_recordfromstringtostring | nullPaymentAttemptRecord.payment_method_details.customandPaymentRecord.payment_method_details.customto be optionalPaymentRecordReportPaymentParams.payment_referenceto be optionalPaymentRecord.latest_payment_attempt_recordfromstringtostring | nullAdditions
BalanceSettingsretrieveandupdatemethods on resourceBalanceSettingscreate,del,list,retrieve, andupdatemethods on a newExternalAccountServiceclass to access cards and bank accounts made available in the new pathv1/external_accounts. Access this viaStripeClient.externalAccountsstripe_balance_paymentsonAccount.capabilities,AccountCreateParams.capabilities, andAccountUpdateParams.capabilitiescustomer_accountonBilling.CreditBalanceSummaryRetrieveParams,Billing.CreditBalanceSummary,Billing.CreditBalanceTransactionListParams,Billing.CreditGrantCreateParams,Billing.CreditGrantListParams,Billing.CreditGrant,BillingPortal.SessionCreateParams,BillingPortal.Session,Checkout.SessionCreateParams,Checkout.SessionListParams,Checkout.Session,ConfirmationToken.payment_method_preview,CreditNoteListParams,CreditNote,CustomerBalanceTransaction,CustomerCashBalanceTransaction,CustomerCashBalance,CustomerPaymentMethod,CustomerSessionCreateParams,CustomerSession,CustomerTaxId.owner,CustomerTaxId,Customer,Discount,FinancialConnections.Account.account_holder,FinancialConnections.AccountListParams.account_holder,FinancialConnections.Session.account_holder,FinancialConnections.SessionCreateParams.account_holder,InvoiceCreateParams,InvoiceCreatePreviewParams,InvoiceItemCreateParams,InvoiceItemListParams,InvoiceItem,InvoiceListParams,Invoice,PaymentIntentCreateParams,PaymentIntentListParams,PaymentIntentUpdateParams,PaymentIntent,PaymentMethodAttachParams,PaymentMethod,PromotionCodeCreateParams,PromotionCodeListParams,PromotionCode,QuoteCreateParams,QuoteListParams,QuotePreviewInvoice,QuotePreviewSubscriptionSchedule,QuoteUpdateParams,Quote,SetupAttempt,SetupIntentCreateParams,SetupIntentListParams,SetupIntentUpdateParams,SetupIntent,SubscriptionCreateParams,SubscriptionListParams,SubscriptionScheduleCreateParams,SubscriptionScheduleListParams,SubscriptionSchedule,Subscription,TaxId.owner,TaxIdCreateParams.owner,TaxIdListParams.owner, andTaxIdstripe_balanceonCharge.payment_method_details,ConfirmationToken.payment_method_preview,ConfirmationTokenCreateParams.testHelpers.payment_method_data,CustomerPaymentMethod,PaymentAttemptRecord.payment_method_details,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,PaymentMethodCreateParams,PaymentMethod,PaymentRecord.payment_method_details,SetupAttempt.payment_method_details,SetupIntentConfirmParams.payment_method_data,SetupIntentCreateParams.payment_method_data, andSetupIntentUpdateParams.payment_method_dataupdate_line_itemsandupdate_shipping_detailsonCheckout.Session.permissionsandCheckout.SessionCreateParams.permissionsprovideronCheckout.Session.automatic_tax,Invoice.automatic_tax,Quote.automatic_tax, andQuotePreviewInvoice.automatic_taxtax_calculation_referenceonCreditNoteLineItem,CreditNotePreviewLines,InvoiceLineItem,LineItem,PaymentLinkLineItem,QuoteComputedUpfrontLineItems,QuoteLineItem, andSessionLineItempayment_method_optionsonConfirmationTokenCreateParams.testHelpersinstallmentsonConfirmationToken.payment_method_options.cardcontextonEventrelated_customer_accountonIdentity.VerificationSession,identity.VerificationSessionCreateParams, andidentity.VerificationSessionListParamsnetwork_dataonIssuing.DisputeSettlementDetailinterchange_fees_amount,net_total_amount,network_fees_amount,other_fees_amount,other_fees_count, andtransaction_amountonIssuing.Settlementreported_byonPaymentAttemptRecordach_credit_transfer,ach_debit,acss_debit,affirm,afterpay_clearpay,alipay,alma,amazon_pay,au_becs_debit,bacs_debit,bancontact,blik,boleto,card_present,card,cashapp,customer_balance,eps,fpx,giropay,gopay,grabpay,id_bank_transfer,ideal,interac_present,kakao_pay,klarna,konbini,kr_card,link,mb_way,mobilepay,multibanco,naver_pay,nz_bank_account,oxxo,p24,pay_by_bank,payco,paynow,paypal,payto,pix,promptpay,qris,rechnung,revolut_pay,samsung_pay,satispay,sepa_credit_transfer,sepa_debit,shopeepay,sofort,stripe_account,swish,twint,us_bank_account,wechat_pay,wechat, andziponPaymentAttemptRecord.payment_method_detailsandPaymentRecord.payment_method_detailspayout_methodonPayoutCreateParamsandPayoutconfirmation_secret,parent, andtotal_taxesonQuotePreviewInvoiceforwarding_api_retryable_upstream_error,setup_intent_mobile_wallet_unsupported,v2_account_disconnection_unsupported, andv2_account_missing_configurationon enumQuotePreviewInvoice.last_finalization_error.codeklarna,nz_bank_account, andstripe_balanceon enumQuotePreviewInvoice.payment_settings.payment_method_typesidandtextonTerminal.Reader.action.collect_inputs.inputs[].selection.choices[],Terminal.Reader.action.collect_inputs.inputs[].selection, andTerminal.ReaderCollectInputsParams.inputs[].selection.choices[]New APIs for Money CardManagement
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, andV2.MoneyManagement.Transactioncreatemethod on resourceV2.MoneyManagement.OutboundPaymentQuotelistandretrievemethods on resourcesV2.MoneyManagement.Adjustment,V2.MoneyManagement.FinancialAccount,V2.MoneyManagement.ReceivedCredit,V2.MoneyManagement.ReceivedDebit,V2.MoneyManagement.TransactionEntry, andV2.MoneyManagement.Transactioncreate,list, andretrievemethods on resourcesV2.MoneyManagement.FinancialAddressandV2.MoneyManagement.InboundTransfercancel,create,list, andretrievemethods on resourcesV2.MoneyManagement.OutboundPaymentandV2.MoneyManagement.OutboundTransferarchive,list,retrieve, andunarchivemethods on resourceV2.MoneyManagement.PayoutMethodcancel,create,list,retrieve, andupdatemethods on resourceV2.MoneyManagement.OutboundSetupIntentretrievemethod on resourceV2.MoneyManagement.PayoutMethodsBankAccountSpecaccount_number,fedwire_routing_number, androuting_numberon enuminvalid_payment_method.invalid_paramV2MoneyManagementFinancialAccountCreatedEventwith related objectV2.MoneyManagement.FinancialAccountV2MoneyManagementFinancialAddressActivatedEventandV2MoneyManagementFinancialAddressFailedEventwith related objectV2.MoneyManagement.FinancialAddressV2MoneyManagementInboundTransferAvailableEvent,V2MoneyManagementInboundTransferBankDebitFailedEvent,V2MoneyManagementInboundTransferBankDebitProcessingEvent,V2MoneyManagementInboundTransferBankDebitQueuedEvent,V2MoneyManagementInboundTransferBankDebitReturnedEvent, andV2MoneyManagementInboundTransferBankDebitSucceededEventwith related objectV2.MoneyManagement.InboundTransferV2MoneyManagementOutboundPaymentCanceledEvent,V2MoneyManagementOutboundPaymentCreatedEvent,V2MoneyManagementOutboundPaymentFailedEvent,V2MoneyManagementOutboundPaymentPostedEvent, andV2MoneyManagementOutboundPaymentReturnedEventwith related objectV2.MoneyManagement.OutboundPaymentV2MoneyManagementOutboundTransferCanceledEvent,V2MoneyManagementOutboundTransferCreatedEvent,V2MoneyManagementOutboundTransferFailedEvent,V2MoneyManagementOutboundTransferPostedEvent, andV2MoneyManagementOutboundTransferReturnedEventwith related objectV2.MoneyManagement.OutboundTransferV2MoneyManagementReceivedCreditAvailableEvent,V2MoneyManagementReceivedCreditFailedEvent,V2MoneyManagementReceivedCreditReturnedEvent, andV2MoneyManagementReceivedCreditSucceededEventwith related objectV2.MoneyManagement.ReceivedCreditV2MoneyManagementReceivedDebitCanceledEvent,V2MoneyManagementReceivedDebitFailedEvent,V2MoneyManagementReceivedDebitPendingEvent,V2MoneyManagementReceivedDebitSucceededEvent, andV2MoneyManagementReceivedDebitUpdatedEventwith related objectV2.MoneyManagement.ReceivedDebitAlreadyCanceledError,BlockedByStripeError,ControlledByDashboardError,FeatureNotEnabledError,FinancialAccountNotOpenError,InsufficientFundsError,InvalidPayoutMethodError,NotCancelableError, andRecipientNotNotifiableErrorNew APIs for Accounts v2 in private preview
See SaaS platform payments with subscription billing using Accounts v2
V2.Core.AccountLink,V2.Core.Account,V2.Core.Person,V2.Core.Vault.GbBankAccount,V2.Core.Vault.UsBankAccountclose,create,list,retrieve, andupdatemethods on resourceV2.Core.Accountcreatemethod on resourceV2.Core.AccountLinkacknowledge_confirmation_of_payee,archive,create,initiate_confirmation_of_payee, andretrievemethods on resourceV2.Core.Vault.GbBankAccountarchive,create,retrieve, andupdatemethods on resourceV2.Core.Vault.UsBankAccountV2CoreAccountIncludingConfigurationCustomerCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationCustomerUpdatedEvent,V2CoreAccountIncludingConfigurationMerchantCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationMerchantUpdatedEvent,V2CoreAccountIncludingConfigurationRecipientCapabilityStatusUpdatedEvent,V2CoreAccountIncludingConfigurationRecipientUpdatedEvent,V2CoreAccountIncludingIdentityUpdatedEvent, andV2CoreAccountIncludingRequirementsUpdatedEventV2CoreAccountLinkCompletedEventwith related objectV2.Core.AccountLinkV2CoreAccountPersonCreatedEvent,V2CoreAccountPersonDeletedEvent, andV2CoreAccountPersonUpdatedEventwith related objectV2.Core.PersonChanges
Billing.CreditBalanceSummaryRetrieveParams.customer,Billing.CreditBalanceTransactionListParams.customer,Billing.CreditGrantCreateParams.customer,BillingPortal.SessionCreateParams.customer,CustomerSessionCreateParams.customer,InvoiceItemCreateParams.customer,PaymentMethodAttachParams.customer, andSubscriptionCreateParams.customerto be optionalCreditNote.refundsto be requiredPaymentAttemptRecord.payment_method_details.customandPaymentRecord.payment_method_details.customfromPaymentsPrimitivesPaymentRecordsResourcePaymentMethodCustomDetails | nulltoPaymentsPrimitivesPaymentRecordsResourcePaymentMethodCustomDetailsOrderCreateParams.payment.settings.payment_method_options.wechat_pay.clientandOrderUpdateParams.payment.settings.payment_method_options.wechat_pay.clientto be optionalSee the changelog for more details.
#2279 Support for APIs in the new API version 2025-03-31.basil
This release changes the pinned API version to
2025-03-31.basil.Please review details for the breaking changes and alternatives in the Stripe API changelog before upgrading.
SubscriptionItemUsageRecordSummaryandSubscriptionItemUsageRecordlistUpcomingLinesandretrieveUpcomingmethods on resourceInvoicecreateUsageRecordandlistUsageRecordSummariesmethods on resourceSubscriptionItemsinvoiceonChargeandPaymentIntentshipping_detailsonCheckout.Sessioncarrier,phone, andtracking_numberonCheckout.Session.collected_information.shipping_details. Makenameandaddressrequired instead of optional.refundonCreditNoteCreateParams,CreditNoteListPreviewLineItemsParams,CreditNotePreviewParams, andCreditNotetax_amountsonCreditNoteLineItem,CreditNote, andInvoiceLineItemamount_excluding_taxandunit_amount_excluding_taxonCreditNoteLineItemandInvoiceLineItemcoupononCustomerCreateParams,CustomerUpdateParams,InvoiceCreatePreviewParams.schedule_details.phases[],InvoiceCreatePreviewParams,SubscriptionCreateParams,SubscriptionSchedule.phases[],SubscriptionScheduleCreateParams.phases[],SubscriptionScheduleUpdateParams.phases[], andSubscriptionUpdateParamspromotion_codeonCustomerCreateParams,CustomerUpdateParams,SubscriptionCreateParams, andSubscriptionUpdateParamspriceonInvoiceAddLinesParams.lines[],InvoiceItemCreateParams,InvoiceItemUpdateParams,InvoiceItem,InvoiceLineItemUpdateParams,InvoiceLineItem, andInvoiceUpdateLinesParams.lines[]. Usepricing` instead.billing_thresholdsonInvoiceCreatePreviewParams.schedule_details.phases[].items[],InvoiceCreatePreviewParams.schedule_details.phases[],InvoiceCreatePreviewParams.subscription_details.items[],SubscriptionCreateParams.items[],SubscriptionCreateParams,SubscriptionItemCreateParams,SubscriptionItemUpdateParams,SubscriptionItem,SubscriptionSchedule.default_settings,SubscriptionSchedule.phases[].items[],SubscriptionSchedule.phases[],SubscriptionScheduleCreateParams.default_settings,SubscriptionScheduleCreateParams.phases[].items[],SubscriptionScheduleCreateParams.phases[],SubscriptionScheduleUpdateParams.default_settings,SubscriptionScheduleUpdateParams.phases[].items[],SubscriptionScheduleUpdateParams.phases[],SubscriptionUpdateParams.items[],SubscriptionUpdateParams, andSubscriptionapplication_fee_amount,charge,paid_out_of_band,paid,payment_intent,quote,subscription,subscription_details,subscription_proration_date,tax,total_tax_amounts, andtransfer_dataonInvoicediscountonInvoiceandSubscriptioninvoice_item,proration_details,proration,tax_rates, andtypeonInvoiceLineItemplanandsubscription_itemonInvoiceItemandInvoiceLineItemunit_amountonInvoiceItemCreateParams,InvoiceItemUpdateParams, andInvoiceItemsubscriptionandunit_amount_decimalonInvoiceItemnaver_payonPaymentMethodUpdateParamsaggregate_usageonPlanCreateParams,Plan,Price.recurring, andPriceCreateParams.recurringcurrent_period_endandcurrent_period_startonSubscriptionpagehas been removed from all V2 list method params (e.g.EventService.list()); use the auto paginator or thenext_page_urlandprevious_page_urlfields instead (more info)Changes
Checkout.Session.collected_informationto be requiredCheckout.Session.collected_information.shipping_detailsto be requiredCheckout.Session.collected_information.shipping_details.addressto be requiredCheckout.Session.collected_information.shipping_details.nameto be requiredPaymentIntentConfirmParams.payment_method_options.wechat_pay.client,PaymentIntentCreateParams.payment_method_options.wechat_pay.client, andPaymentIntentUpdateParams.payment_method_options.wechat_pay.clientto be optionalpolitical_exposureon resourcesPersonandTokenand paramsToken.CreateParamsfrom string to enum("existing" | "none")Additions
InvoicePaymentlistandretrievemethods on resourceInvoicePaymentbillie_payments,nz_bank_account_becs_debit_payments, andsatispay_paymentsonAccount.capabilities,AccountCreateParams.capabilities, andAccountUpdateParams.capabilitieshosted_payment_method_saveonAccount.settings.invoicesandAccountUpdateParams.settings.invoicesinvoicesonAccountCreateParams.settingsinformation_missing,invalid_signator,verification_failed_authorizer_authority, andverification_rejected_ownership_exemption_reasonon enumsAccount.future_requirements.errors[].code,Account.requirements.errors[].code,AccountCapability.future_requirements.errors[].code,AccountCapability.requirements.errors[].code,AccountPerson.future_requirements.errors[].code,AccountPerson.requirements.errors[].code,BankAccount.future_requirements.errors[].code, andBankAccount.requirements.errors[].codeforwarding_api_retryable_upstream_errorandsetup_intent_mobile_wallet_unsupportedon enumsInvoice.last_finalization_error.code,PaymentIntent.last_payment_error.code,SetupAttempt.setup_error.code,SetupIntent.last_setup_error.code, andStripeError.codestripe_balance_payment_debit_reversalandstripe_balance_payment_debiton enumBalanceTransaction.typelaston enumsBilling.Meter.default_aggregation.formulaandBilling.MeterCreateParams.default_aggregation.formulapresentment_detailsonCharge,Checkout.Session,PaymentIntent, andRefundbillieandsatispayonCharge.payment_method_details,ConfirmationToken.payment_method_preview,ConfirmationTokenCreateParams.testHelpers.payment_method_data,CustomerPaymentMethod,PaymentIntentConfirmParams.payment_method_data,PaymentIntentCreateParams.payment_method_data,PaymentIntentUpdateParams.payment_method_data,PaymentMethodConfigurationCreateParams,PaymentMethodConfigurationUpdateParams,PaymentMethodConfiguration,PaymentMethodCreateParams,PaymentMethod,SetupIntentConfirmParams.payment_method_data,SetupIntentCreateParams.payment_method_data, andSetupIntentUpdateParams.payment_method_datanz_bank_accountonCharge.payment_method_details,ConfirmationToken.payment_method_preview,ConfirmationTokenCreateParams.testHelpers.payment_method_data,CustomerPaymentMethod,Mandate.payment_method_details,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,SetupAttempt.payment_method_details,SetupIntentConfirmParams.payment_method_data,SetupIntentCreateParams.payment_method_data, andSetupIntentUpdateParams.payment_method_dataoptional_itemsonCheckout.SessionCreateParams,Checkout.Session,PaymentLinkCreateParams, andPaymentLinkpermissionsonCheckout.SessionCreateParamsandCheckout.Sessionbillieandsatispayon enumCheckout.SessionCreateParams.payment_method_typescustomon enumsCheckout.Session.ui_modeandCheckout.SessionCreateParams.ui_modeshipping_optionsonCheckout.SessionUpdateParamsbillie,nz_bank_account, andsatispayon enumsConfirmationTokenCreateParams.testHelpers.payment_method_data.type,PaymentIntentConfirmParams.payment_method_data.type,PaymentIntentCreateParams.payment_method_data.type,PaymentIntentUpdateParams.payment_method_data.type,SetupIntentConfirmParams.payment_method_data.type,SetupIntentCreateParams.payment_method_data.type, andSetupIntentUpdateParams.payment_method_data.typebuyer_idonConfirmationToken.payment_method_preview.naver_pay,CustomerPaymentMethod.naver_pay, andPaymentMethod.naver_paybillie,nz_bank_account, andsatispayon enumsConfirmationToken.payment_method_preview.type,CustomerPaymentMethod.type, andPaymentMethod.typerefundsonCreditNoteCreateParams,CreditNoteListPreviewLineItemsParams,CreditNotePreviewParams, andCreditNotetotal_taxesonCreditNoteandInvoicetaxesonCreditNoteLineItemandInvoiceLineItemcheckout_sessiononCustomerBalanceTransactioncheckout_session_subscription_payment_canceledandcheckout_session_subscription_paymenton enumCustomerBalanceTransaction.typebillie,nz_bank_account, andsatispayon enumsCustomerPaymentMethodListParams.type,PaymentMethodCreateParams.type, andPaymentMethodListParams.typeinvoice.overpaidon enumEvent.typeklarnaandnz_bank_accounton enumsInvoice.payment_settings.payment_method_types,InvoiceCreateParams.payment_settings.payment_method_types,InvoiceUpdateParams.payment_settings.payment_method_types,Subscription.payment_settings.payment_method_types,SubscriptionCreateParams.payment_settings.payment_method_types, andSubscriptionUpdateParams.payment_settings.payment_method_typespricingonInvoiceAddLinesParams.lines[],InvoiceItemCreateParams,InvoiceItemUpdateParams,InvoiceItem,InvoiceLineItemUpdateParams,InvoiceLineItem, andInvoiceUpdateLinesParams.lines[]taxability_reasononInvoiceAddLinesParams.lines[].tax_amounts[],InvoiceLineItemUpdateParams.tax_amounts[], andInvoiceUpdateLinesParams.lines[].tax_amounts[]jurisdiction_levelonInvoiceAddLinesParams.lines[].tax_amounts[].tax_rate_data,InvoiceLineItemUpdateParams.tax_amounts[].tax_rate_data, andInvoiceUpdateLinesParams.lines[].tax_amounts[].tax_rate_dataamount_overpaid,confirmation_secret, andpaymentsonInvoiceparentonInvoiceItem,InvoiceLineItem, andInvoiceexpiredon enumsIssuing.Authorization.statusandIssuing.AuthorizationListParams.statusnetwork_fallbackon enumIssuing.Authorization.request_history[].reasonnaver_payonMandate.payment_method_detailsandSetupAttempt.payment_method_detailssetup_future_usageonPaymentIntent.payment_method_options.naver_pay,PaymentIntentConfirmParams.payment_method_options.naver_pay,PaymentIntentCreateParams.payment_method_options.naver_pay, andPaymentIntentUpdateParams.payment_method_options.naver_payexpiredon enumPaymentIntent.cancellation_reasondefault_valueonPaymentLink.custom_fields[].dropdown,PaymentLink.custom_fields[].numeric,PaymentLink.custom_fields[].text,PaymentLinkCreateParams.custom_fields[].dropdown,PaymentLinkCreateParams.custom_fields[].numeric,PaymentLinkCreateParams.custom_fields[].text,PaymentLinkUpdateParams.custom_fields[].dropdown,PaymentLinkUpdateParams.custom_fields[].numeric, andPaymentLinkUpdateParams.custom_fields[].textbillieandsatispayon enumsPaymentLink.payment_method_types,PaymentLinkCreateParams.payment_method_types, andPaymentLinkUpdateParams.payment_method_typesnz_bank_transferonRefund.destination_detailscanceledon enumReview.closed_reasoncurrent_period_endandcurrent_period_startonSubscriptionItemwifionTerminal.ConfigurationCreateParams,Terminal.ConfigurationUpdateParams, andTerminal.Configurationinvoice.overpaidon enumsWebhookEndpointCreateParams.enabled_eventsandWebhookEndpointUpdateParams.enabled_events2025-03-01.dashboardand2025-03-31.basilon enumWebhookEndpointCreateParams.api_versionSee the changelog for more details.
#2271 Beta SDK updates between Open API versions 1473 and 1505
succeed_input_collectionandtimeout_input_collectiontest helper methods on resourceTerminal.ReaderAccount.risk_controls.rejected_reasonfrom enum to enum | nullCheckout.Session.collected_information.shipping_detailsandCheckout.Session.collected_informationto be requiredtarget_dateonOrder.payment.settings.payment_method_options.acss_debit,Order.payment.settings.payment_method_options.sepa_debit,OrderCreateParams.payment.settings.payment_method_options.acss_debit,OrderCreateParams.payment.settings.payment_method_options.sepa_debit,OrderUpdateParams.payment.settings.payment_method_options.acss_debit, andOrderUpdateParams.payment.settings.payment_method_options.sepa_debit#2272 Merge master
See the changelog for more details.
pricesonBilling.CreditBalanceSummaryRetrieveParams.filter.applicability_scope,Billing.CreditGrant.applicability_config.scope, andBilling.CreditGrantCreateParams.applicability_config.scopeBilling.CreditBalanceSummaryRetrieveParams.filter.applicability_scope.price_type,Billing.CreditGrant.applicability_config.scope.price_type, andBilling.CreditGrantCreateParams.applicability_config.scope.price_typeto be optionalpriorityonBilling.CreditGrantCreateParamsandBilling.CreditGranttarget_dateonCheckout.Session.payment_method_options.acss_debit,Checkout.Session.payment_method_options.au_becs_debit,Checkout.Session.payment_method_options.bacs_debit,Checkout.Session.payment_method_options.sepa_debit,Checkout.Session.payment_method_options.us_bank_account,Checkout.SessionCreateParams.payment_method_options.acss_debit,Checkout.SessionCreateParams.payment_method_options.au_becs_debit,Checkout.SessionCreateParams.payment_method_options.bacs_debit,Checkout.SessionCreateParams.payment_method_options.sepa_debit,Checkout.SessionCreateParams.payment_method_options.us_bank_account,PaymentIntent.payment_method_options.acss_debit,PaymentIntent.payment_method_options.au_becs_debit,PaymentIntent.payment_method_options.bacs_debit,PaymentIntent.payment_method_options.sepa_debit,PaymentIntent.payment_method_options.us_bank_account,PaymentIntentConfirmParams.payment_method_options.acss_debit,PaymentIntentConfirmParams.payment_method_options.au_becs_debit,PaymentIntentConfirmParams.payment_method_options.bacs_debit,PaymentIntentConfirmParams.payment_method_options.sepa_debit,PaymentIntentConfirmParams.payment_method_options.us_bank_account,PaymentIntentCreateParams.payment_method_options.acss_debit,PaymentIntentCreateParams.payment_method_options.au_becs_debit,PaymentIntentCreateParams.payment_method_options.bacs_debit,PaymentIntentCreateParams.payment_method_options.sepa_debit,PaymentIntentCreateParams.payment_method_options.us_bank_account,PaymentIntentUpdateParams.payment_method_options.acss_debit,PaymentIntentUpdateParams.payment_method_options.au_becs_debit,PaymentIntentUpdateParams.payment_method_options.bacs_debit,PaymentIntentUpdateParams.payment_method_options.sepa_debit, andPaymentIntentUpdateParams.payment_method_options.us_bank_accountrestrictionsonCheckout.Session.payment_method_options.cardandCheckout.SessionCreateParams.payment_method_options.cardcollected_informationonCheckout.SessionUpdateParamsandCheckout.SessionCheckout.Session.discounts,Refund.destination_details.blik.network_decline_code, andRefund.destination_details.swish.network_decline_codeto be requiredmetadataonProductCreateParams.default_price_dataTokenCreateParams.person.political_exposurefromstringtoenum('existing'|'none')2025-02-24.acaciaon enumWebhookEndpointCreateParams.api_versionOPENAPI_VERSIONinto npm bundleSee