This release changes the pinned API version to 2025-12-15.preview.
- #2498 Add EventNotificationHandler
- #2509 Update generated code for beta
- Add support for new resources
Reserve.Hold,Reserve.Plan, andReserve.Release - Add support for
listandretrievemethods on resourcesReserve.HoldandReserve.Release - Add support for
retrievemethod on resourceReserve.Plan - Change
Billing.CreditBalanceSummary.customer_account,Billing.CreditGrant.customer_account,BillingPortal.Session.customer_account,CashBalance.customer_account,Checkout.Session.customer_account,ConfirmationToken.payment_method_preview.customer_account,CreditNote.customer_account,CustomerBalanceTransaction.customer_account,CustomerCashBalanceTransaction.customer_account,CustomerSession.customer_account,Discount.customer_account,Invoice.customer_account,InvoiceItem.customer_account,PaymentIntent.customer_account,PaymentMethod.customer_account,PromotionCode.customer_account,Quote.customer_account,QuotePreviewInvoice.customer_account,QuotePreviewSubscriptionSchedule.customer_account,SetupAttempt.customer_account,Subscription.customer_account,SubscriptionSchedule.customer_account,TaxId.customer_account, andTaxId.owner.customer_accountto be required - Change type of
V2.FinancialAddressGeneratedMicrodeposits.amountsfromamounttoan object - Change type of
Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.amount,PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.amount,PaymentIntentCreateParams.payment_method_options.payto.mandate_options.amount,PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.amount,SetupIntentConfirmParams.payment_method_options.payto.mandate_options.amount,SetupIntentCreateParams.payment_method_options.payto.mandate_options.amount, andSetupIntentUpdateParams.payment_method_options.payto.mandate_options.amountfromlongIntegertoemptyable(longInteger) - Change type of
Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.amount_type,PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.amount_type,PaymentIntentCreateParams.payment_method_options.payto.mandate_options.amount_type,PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.amount_type,SetupIntentConfirmParams.payment_method_options.payto.mandate_options.amount_type,SetupIntentCreateParams.payment_method_options.payto.mandate_options.amount_type, andSetupIntentUpdateParams.payment_method_options.payto.mandate_options.amount_typefromenum('fixed'|'maximum')toemptyable(enum('fixed'|'maximum')) - Change type of
Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.end_date,PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.end_date,PaymentIntentCreateParams.payment_method_options.payto.mandate_options.end_date,PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.end_date,SetupIntentConfirmParams.payment_method_options.payto.mandate_options.end_date,SetupIntentCreateParams.payment_method_options.payto.mandate_options.end_date, andSetupIntentUpdateParams.payment_method_options.payto.mandate_options.end_datefromstringtoemptyable(string) - Change type of
Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.payment_schedule,PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.payment_schedule,PaymentIntentCreateParams.payment_method_options.payto.mandate_options.payment_schedule,PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.payment_schedule,SetupIntentConfirmParams.payment_method_options.payto.mandate_options.payment_schedule,SetupIntentCreateParams.payment_method_options.payto.mandate_options.payment_schedule, andSetupIntentUpdateParams.payment_method_options.payto.mandate_options.payment_schedulefromenumtoemptyable(enum) - Change type of
Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.payments_per_period,PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.payments_per_period,PaymentIntentCreateParams.payment_method_options.payto.mandate_options.payments_per_period,PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.payments_per_period,SetupIntentConfirmParams.payment_method_options.payto.mandate_options.payments_per_period,SetupIntentCreateParams.payment_method_options.payto.mandate_options.payments_per_period, andSetupIntentUpdateParams.payment_method_options.payto.mandate_options.payments_per_periodfromlongIntegertoemptyable(longInteger) - Change type of
Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.purpose,PaymentIntentConfirmParams.payment_method_options.payto.mandate_options.purpose,PaymentIntentCreateParams.payment_method_options.payto.mandate_options.purpose,PaymentIntentUpdateParams.payment_method_options.payto.mandate_options.purpose,SetupIntentConfirmParams.payment_method_options.payto.mandate_options.purpose,SetupIntentCreateParams.payment_method_options.payto.mandate_options.purpose, andSetupIntentUpdateParams.payment_method_options.payto.mandate_options.purposefromenumtoemptyable(enum) - Change type of
Checkout.SessionCreateParams.payment_method_options.payto.mandate_options.start_date,SetupIntentConfirmParams.payment_method_options.payto.mandate_options.start_date,SetupIntentCreateParams.payment_method_options.payto.mandate_options.start_date, andSetupIntentUpdateParams.payment_method_options.payto.mandate_options.start_datefromstringtoemptyable(string) - Change
Identity.VerificationSession.related_customer_accountto be required - Add support for
async_workflowsonPaymentIntent - Add support for
paytoonQuotePreviewInvoice.payment_settings.payment_method_options - Add support for new value
paytoon enumQuotePreviewInvoice.payment_settings.payment_method_types - Remove support for
requestedonV2.Core.Account.configuration.customer.capabilities.automatic_indirect_tax,V2.Core.Account.configuration.merchant.capabilities.ach_debit_payments,V2.Core.Account.configuration.merchant.capabilities.acss_debit_payments,V2.Core.Account.configuration.merchant.capabilities.affirm_payments,V2.Core.Account.configuration.merchant.capabilities.afterpay_clearpay_payments,V2.Core.Account.configuration.merchant.capabilities.alma_payments,V2.Core.Account.configuration.merchant.capabilities.amazon_pay_payments,V2.Core.Account.configuration.merchant.capabilities.au_becs_debit_payments,V2.Core.Account.configuration.merchant.capabilities.bacs_debit_payments,V2.Core.Account.configuration.merchant.capabilities.bancontact_payments,V2.Core.Account.configuration.merchant.capabilities.blik_payments,V2.Core.Account.configuration.merchant.capabilities.boleto_payments,V2.Core.Account.configuration.merchant.capabilities.card_payments,V2.Core.Account.configuration.merchant.capabilities.cartes_bancaires_payments,V2.Core.Account.configuration.merchant.capabilities.cashapp_payments,V2.Core.Account.configuration.merchant.capabilities.eps_payments,V2.Core.Account.configuration.merchant.capabilities.fpx_payments,V2.Core.Account.configuration.merchant.capabilities.gb_bank_transfer_payments,V2.Core.Account.configuration.merchant.capabilities.grabpay_payments,V2.Core.Account.configuration.merchant.capabilities.ideal_payments,V2.Core.Account.configuration.merchant.capabilities.jcb_payments,V2.Core.Account.configuration.merchant.capabilities.jp_bank_transfer_payments,V2.Core.Account.configuration.merchant.capabilities.kakao_pay_payments,V2.Core.Account.configuration.merchant.capabilities.klarna_payments,V2.Core.Account.configuration.merchant.capabilities.konbini_payments,V2.Core.Account.configuration.merchant.capabilities.kr_card_payments,V2.Core.Account.configuration.merchant.capabilities.link_payments,V2.Core.Account.configuration.merchant.capabilities.mobilepay_payments,V2.Core.Account.configuration.merchant.capabilities.multibanco_payments,V2.Core.Account.configuration.merchant.capabilities.mx_bank_transfer_payments,V2.Core.Account.configuration.merchant.capabilities.naver_pay_payments,V2.Core.Account.configuration.merchant.capabilities.oxxo_payments,V2.Core.Account.configuration.merchant.capabilities.p24_payments,V2.Core.Account.configuration.merchant.capabilities.pay_by_bank_payments,V2.Core.Account.configuration.merchant.capabilities.payco_payments,V2.Core.Account.configuration.merchant.capabilities.paynow_payments,V2.Core.Account.configuration.merchant.capabilities.promptpay_payments,V2.Core.Account.configuration.merchant.capabilities.revolut_pay_payments,V2.Core.Account.configuration.merchant.capabilities.samsung_pay_payments,V2.Core.Account.configuration.merchant.capabilities.sepa_bank_transfer_payments,V2.Core.Account.configuration.merchant.capabilities.sepa_debit_payments,V2.Core.Account.configuration.merchant.capabilities.stripe_balance.payouts,V2.Core.Account.configuration.merchant.capabilities.swish_payments,V2.Core.Account.configuration.merchant.capabilities.twint_payments,V2.Core.Account.configuration.merchant.capabilities.us_bank_transfer_payments,V2.Core.Account.configuration.merchant.capabilities.zip_payments,V2.Core.Account.configuration.recipient.capabilities.bank_accounts.local,V2.Core.Account.configuration.recipient.capabilities.bank_accounts.wire,V2.Core.Account.configuration.recipient.capabilities.cards,V2.Core.Account.configuration.recipient.capabilities.stripe_balance.payouts,V2.Core.Account.configuration.recipient.capabilities.stripe_balance.stripe_transfers,V2.Core.Account.configuration.storer.capabilities.financial_addresses.bank_accounts,V2.Core.Account.configuration.storer.capabilities.holds_currencies.eur,V2.Core.Account.configuration.storer.capabilities.holds_currencies.gbp,V2.Core.Account.configuration.storer.capabilities.holds_currencies.usd,V2.Core.Account.configuration.storer.capabilities.inbound_transfers.bank_accounts,V2.Core.Account.configuration.storer.capabilities.outbound_payments.bank_accounts,V2.Core.Account.configuration.storer.capabilities.outbound_payments.cards,V2.Core.Account.configuration.storer.capabilities.outbound_payments.financial_accounts,V2.Core.Account.configuration.storer.capabilities.outbound_transfers.bank_accounts, andV2.Core.Account.configuration.storer.capabilities.outbound_transfers.financial_accounts - Add support for new values
al_bank_account,am_bank_account,bn_bank_account,bw_bank_account,dz_bank_account,gy_bank_account,jm_bank_account,jo_bank_account,kw_bank_account,lk_bank_account,ma_bank_account,om_bank_account, andtz_bank_accounton enumV2.Core.Account.configuration.recipient.default_outbound_destination.type - Change type of
V2.Core.Account.identity.business_details.annual_revenue.amount,V2.Core.Account.identity.business_details.monthly_estimated_revenue.amount,V2.Core.AccountCreateParams.identity.business_details.annual_revenue.amount,V2.Core.AccountCreateParams.identity.business_details.monthly_estimated_revenue.amount,V2.Core.AccountTokenCreateParams.identity.business_details.annual_revenue.amount,V2.Core.AccountTokenCreateParams.identity.business_details.monthly_estimated_revenue.amount,V2.Core.AccountUpdateParams.identity.business_details.annual_revenue.amount,V2.Core.AccountUpdateParams.identity.business_details.monthly_estimated_revenue.amount,V2.FinancialAddressCreditSimulationCreditParams.amount,V2.MoneyManagement.Adjustment.amount,V2.MoneyManagement.InboundTransfer.amount,V2.MoneyManagement.InboundTransferCreateParams.amount,V2.MoneyManagement.OutboundPayment.amount,V2.MoneyManagement.OutboundPaymentCreateParams.amount,V2.MoneyManagement.OutboundPaymentQuote.amount,V2.MoneyManagement.OutboundPaymentQuote.estimated_fees[].amount,V2.MoneyManagement.OutboundPaymentQuoteCreateParams.amount,V2.MoneyManagement.OutboundTransfer.amount,V2.MoneyManagement.OutboundTransferCreateParams.amount,V2.MoneyManagement.ReceivedCredit.amount,V2.MoneyManagement.ReceivedDebit.amount, andV2.MoneyManagement.Transaction.amountfromamounttoan object - Add support for new values
at_stn,at_vat,be_vat,bg_vat,ca_gst_hst,cy_he,cy_vat,cz_vat,de_stn,dk_vat,ee_vat,es_vat,fi_vat,fr_rna,gr_afm,gr_vat,hr_mbs,hr_oib,hr_vat,hu_tin,hu_vat,ie_trn,ie_vat,lt_vat,lu_nif,lu_vat,lv_vat,mt_tin,mt_vat,my_itn,nl_rsin,nl_vat,nz_ird,pl_nip,pl_vat,ro_orc,ro_vat,se_vat,si_tin,si_vat,sk_dic, andsk_vaton enumsV2.Core.Account.identity.business_details.id_numbers[].type,V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type,V2.Core.AccountTokenCreateParams.identity.business_details.id_numbers[].type, andV2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type - Remove support for value
hk_mbsfrom enumsV2.Core.Account.identity.business_details.id_numbers[].type,V2.Core.AccountCreateParams.identity.business_details.id_numbers[].type,V2.Core.AccountTokenCreateParams.identity.business_details.id_numbers[].type, andV2.Core.AccountUpdateParams.identity.business_details.id_numbers[].type - Add support for new values
ar_cuil,at_stn,be_nrn,bg_ucn,bn_nric,ca_sin,ch_oasi,cl_rut,cn_pp,co_nuip,cr_ci,cy_tic,cz_rc,dk_cpr,do_cie,ec_ci,ee_ik,es_nif,fi_hetu,fr_nir,gb_nino,gr_afm,hr_oib,hu_ad,id_nik,ie_ppsn,is_kt,it_cf,jp_inc,ke_pin,li_peid,lt_ak,lu_nif,lv_pk,ng_nin,no_nin,nz_ird,pl_pesel,pt_nif,ro_cnp,se_pin,sk_dic,tr_tin,uy_dni, andza_idon enumsV2.Core.Account.identity.individual.id_numbers[].type,V2.Core.AccountCreateParams.identity.individual.id_numbers[].type,V2.Core.AccountPerson.id_numbers[].type,V2.Core.AccountPersonCreateParams.id_numbers[].type,V2.Core.AccountPersonTokenCreateParams.id_numbers[].type,V2.Core.AccountPersonUpdateParams.id_numbers[].type,V2.Core.AccountTokenCreateParams.identity.individual.id_numbers[].type, andV2.Core.AccountUpdateParams.identity.individual.id_numbers[].type - Change
V2.Core.Account.defaults.responsibilitiesto be required - Change
V2.Core.Account.defaults.responsibilities.fees_collectorto be optional - Change
V2.Core.Account.defaults.responsibilities.losses_collectorto be optional - Add support for
financial_connections_accountonV2.Core.Vault.UsBankAccountandV2.MoneyManagement.PayoutMethod.bank_account - Change type of
V2.MoneyManagement.FinancialAccount.balance.available,V2.MoneyManagement.Transaction.balance_impact.available, andV2.MoneyManagement.TransactionEntry.balance_impact.availablefromamounttoan object - Change type of
V2.MoneyManagement.FinancialAccount.balance.inbound_pending,V2.MoneyManagement.Transaction.balance_impact.inbound_pending, andV2.MoneyManagement.TransactionEntry.balance_impact.inbound_pendingfromamounttoan object - Change type of
V2.MoneyManagement.FinancialAccount.balance.outbound_pending,V2.MoneyManagement.Transaction.balance_impact.outbound_pending, andV2.MoneyManagement.TransactionEntry.balance_impact.outbound_pendingfromamounttoan object - Change type of
V2.MoneyManagement.InboundTransfer.from.debited,V2.MoneyManagement.OutboundPayment.from.debited,V2.MoneyManagement.OutboundPaymentQuote.from.debited, andV2.MoneyManagement.OutboundTransfer.from.debitedfromamounttoan object - Change type of
V2.MoneyManagement.InboundTransfer.to.credited,V2.MoneyManagement.OutboundPayment.to.credited,V2.MoneyManagement.OutboundPaymentQuote.to.credited, andV2.MoneyManagement.OutboundTransfer.to.creditedfromamounttoan object - Add support for
transferonV2.MoneyManagement.ReceivedCredit.balance_transfer - Add support for new value
transferon enumV2.MoneyManagement.ReceivedCredit.balance_transfer.type - Change
V2.Core.AccountTokenCreateParams.identityto be optional - Change type of
V2.Core.AccountListParams.applied_configurationsfromstringtoenum('customer'|'merchant'|'recipient'|'storer') - Add support for event notification
V2MoneyManagementPayoutMethodCreatedEventwith related objectV2.MoneyManagement.PayoutMethod - Add support for error type
ControlledByAlternateResourceError - Remove support for error type
RateLimitError - Add support for error code
account_token_required_for_v2_accountonQuotePreviewInvoice.last_finalization_error
- Add support for new resources