This release changes the pinned API version to 2025-08-27.preview.

• #1888 Update generated code for beta
  • Add support for all and retrieve methods on resource InvoicePayment
  • Add support for all method on resource Mandate
  • Add support for applied on V2.Core.Account.configuration.customer, V2.Core.Account.configuration.merchant, V2.Core.Account.configuration.recipient, V2.Core.Account.configuration.storer, V2\Core\Account.update().$params.configuration.customer, V2\Core\Account.update().$params.configuration.merchant, V2\Core\Account.update().$params.configuration.recipient, and V2\Core\Account.update().$params.configuration.storer
  • Add support for new values ao_nif, az_tin, bd_etin, cr_cpj, cr_nite, do_rcn, gt_nit, kz_bin, mz_nuit, pe_ruc, pk_ntn, sa_crn, and sa_tin on enum V2.Core.Account.identity.business_details.id_numbers[].type
  • Add support for new values ao_nif, az_tin, bd_brc, bd_etin, bd_nid, cr_cpf, cr_dimex, cr_nite, do_rcn, gt_nit, kz_iin, mz_nuit, pe_dni, pk_cnic, pk_snic, and sa_tin on enums V2.Core.Account.identity.individual.id_numbers[].type and V2.Core.Person.id_numbers[].type
  • Change type of Billing.AlertTriggered.value from longInteger to decimal_string
  • Add support for display_name on V2.MoneyManagement.FinancialAccount and V2\MoneyManagement\FinancialAccount.create().$params
  • Add support for new value currency_conversion on enums V2.MoneyManagement.Transaction.category and V2.MoneyManagement.TransactionEntry.transaction_details.category
  • Add support for currency_conversion on V2.MoneyManagement.Transaction.flow and V2.MoneyManagement.TransactionEntry.transaction_details.flow
  • Add support for new value currency_conversion on enums V2.MoneyManagement.Transaction.flow.type and V2.MoneyManagement.TransactionEntry.transaction_details.flow.type
  • Add support for payments on BalanceSettings.update().$params and BalanceSettings
  • Remove support for debit_negative_balances, payouts, and settlement_timing on BalanceSettings.update().$params and BalanceSettings
  • Add support for mandate on Charge.payment_method_details.pix, PaymentAttemptRecord.payment_method_details.pix, and PaymentRecord.payment_method_details.pix
  • Add support for coupon_data on Checkout\Session.create().$params.discount
  • Add support for mandate_options on Checkout.Session.payment_method_options.pix, Checkout\Session.create().$params.payment_method_option.pix, PaymentIntent.confirm().$params.payment_method_option.pix, PaymentIntent.create().$params.payment_method_option.pix, PaymentIntent.payment_method_options.pix, and PaymentIntent.update().$params.payment_method_option.pix
  • Change type of Checkout.Session.payment_method_options.pix.setup_future_usage, Checkout\Session.create().$params.payment_method_option.pix.setup_future_usage, PaymentIntent.confirm().$params.payment_method_option.pix.setup_future_usage, PaymentIntent.create().$params.payment_method_option.pix.setup_future_usage, PaymentIntent.payment_method_options.pix.setup_future_usage, and PaymentIntent.update().$params.payment_method_option.pix.setup_future_usage from literal('none') to enum('none'|'off_session')
  • Add support for amount on Mandate.multi_use, PaymentAttemptRecord, and PaymentRecord
  • Add support for currency on Mandate.multi_use
  • Add support for pix on Mandate.payment_method_details, SetupAttempt.payment_method_details, SetupIntent.confirm().$params.payment_method_option, SetupIntent.create().$params.payment_method_option, SetupIntent.payment_method_options, and SetupIntent.update().$params.payment_method_option
  • Add support for limit on PaymentAttemptRecord.all().$params
  • Add support for amount_authorized, amount_refunded, and application on PaymentAttemptRecord and PaymentRecord
  • Add support for processor_details on PaymentAttemptRecord, PaymentRecord.report_payment().$params, and PaymentRecord
  • Remove support for payment_reference on PaymentAttemptRecord, PaymentRecord.report_payment().$params, and PaymentRecord
  • Add support for installments on PaymentAttemptRecord.payment_method_details.alma and PaymentRecord.payment_method_details.alma
  • Add support for transaction_id on PaymentAttemptRecord.payment_method_details.alma, PaymentAttemptRecord.payment_method_details.amazon_pay, PaymentAttemptRecord.payment_method_details.billie, PaymentAttemptRecord.payment_method_details.kakao_pay, PaymentAttemptRecord.payment_method_details.kr_card, PaymentAttemptRecord.payment_method_details.naver_pay, PaymentAttemptRecord.payment_method_details.payco, PaymentAttemptRecord.payment_method_details.revolut_pay, PaymentAttemptRecord.payment_method_details.samsung_pay, PaymentAttemptRecord.payment_method_details.satispay, PaymentRecord.payment_method_details.alma, PaymentRecord.payment_method_details.amazon_pay, PaymentRecord.payment_method_details.billie, PaymentRecord.payment_method_details.kakao_pay, PaymentRecord.payment_method_details.kr_card, PaymentRecord.payment_method_details.naver_pay, PaymentRecord.payment_method_details.payco, PaymentRecord.payment_method_details.revolut_pay, PaymentRecord.payment_method_details.samsung_pay, and PaymentRecord.payment_method_details.satispay
  • Add support for location and reader on PaymentAttemptRecord.payment_method_details.paynow and PaymentRecord.payment_method_details.paynow
  • Add support for latest_active_mandate on PaymentMethod
  • Change Payout.payout_method to be required
  • Add support for metadata and period on QuotePreviewSubscriptionSchedule.phases[].add_invoice_items[]
  • Add support for pix_display_qr_code on SetupIntent.next_action
  • Add support for reader_security on Terminal.Configuration, Terminal\Configuration.create().$params, and Terminal\Configuration.update().$params
  • Add support for error codes customer_session_expired and india_recurring_payment_mandate_canceled on QuotePreviewInvoice.last_finalization_error

See the changelog for more details.

• #1897 Use the right API version 2025-08-27.preview
• #1892 Update generated code for private-preview
  • Add support for attach_cadence method on resource Subscription
  • Add support for currency and external_customer_id on Billing.AlertTriggered
  • Add support for custom_pricing_unit on Billing.AlertTriggered, Billing.CreditBalanceSummary.balances[].available_balance, Billing.CreditBalanceSummary.balances[].ledger_balance, Billing.CreditBalanceTransaction.credit.amount, Billing.CreditBalanceTransaction.debit.amount, Billing.CreditGrant.amount, and Billing\CreditGrant.create().$params.amount
  • Add support for customer on Billing\Alert.all().$params
  • Change type of Billing.Alert.alert_type, Billing\Alert.all().$params.alert_type, and Billing\Alert.create().$params.alert_type from literal('usage_threshold') to enum('credit_balance_threshold'|'usage_threshold')
  • Add support for credit_balance_threshold on Billing.Alert and Billing\Alert.create().$params
  • Add support for billable_items on Billing.CreditGrant.applicability_config.scope, Billing\CreditBalanceSummary.retrieve().$params.filter.applicability_scope, and Billing\CreditGrant.create().$params.applicability_config.scope
  • Change type of Billing.CreditBalanceSummary.balances[].available_balance.type, Billing.CreditBalanceSummary.balances[].ledger_balance.type, Billing.CreditBalanceTransaction.credit.amount.type, Billing.CreditBalanceTransaction.debit.amount.type, Billing.CreditGrant.amount.type, and Billing\CreditGrant.create().$params.amount.type from literal('monetary') to enum('custom_pricing_unit'|'monetary')
  • Add support for license_fee_subscription_details and rate_card_subscription_details on InvoiceItem.parent and InvoiceLineItem.parent
  • Change type of InvoiceItem.parent.type from literal('subscription_details') to enum('license_fee_subscription_details'|'rate_card_subscription_details'|'subscription_details')
  • Add support for license_fee_details and rate_card_rate_details on InvoiceItem.pricing and InvoiceLineItem.pricing
  • Change type of InvoiceItem.pricing.type and InvoiceLineItem.pricing.type from literal('price_details') to enum('license_fee_details'|'price_details'|'rate_card_rate_details')
  • Add support for billing_cadence on Invoice.create_preview().$params, Subscription.create().$params, and Subscription
  • Add support for billing_cadence_details on Invoice.parent and QuotePreviewInvoice.parent
  • Add support for new value billing_cadence_details on enums Invoice.parent.type and QuotePreviewInvoice.parent.type
  • Add support for new values license_fee_subscription_details and rate_card_subscription_details on enum InvoiceLineItem.parent.type
  • Add support for new resources V2.Billing.BillSettingVersion, V2.Billing.BillSetting, V2.Billing.Cadence, V2.Billing.CollectionSettingVersion, V2.Billing.CollectionSetting, V2.Billing.CustomPricingUnit, V2.Billing.IntentAction, V2.Billing.Intent, V2.Billing.LicenseFeeSubscription, V2.Billing.LicenseFeeVersion, V2.Billing.LicenseFee, V2.Billing.LicensedItem, V2.Billing.MeteredItem, V2.Billing.PricingPlanComponent, V2.Billing.PricingPlanSubscription, V2.Billing.PricingPlanVersion, V2.Billing.PricingPlan, V2.Billing.Profile, V2.Billing.RateCardRate, V2.Billing.RateCardSubscription, V2.Billing.RateCardVersion, V2.Billing.RateCard, V2.Billing.ServiceAction, V2.Core.ClaimableSandbox, V2.Reporting.ReportRun, V2.Reporting.Report, and V2.Tax.AutomaticRule
  • Add support for create, deactivate, find, retrieve, and update methods on resource V2.Tax.AutomaticRule
  • Add support for create and retrieve methods on resources V2.Billing.ServiceAction and V2.Reporting.ReportRun
  • Add support for retrieve method on resources V2.Billing.LicenseFeeSubscription and V2.Reporting.Report
  • Add support for create method on resource V2.Core.ClaimableSandbox
  • Add support for all, cancel, create, retrieve, and update methods on resources V2.Billing.Cadence and V2.Billing.RateCardSubscription
  • Add support for all, create, retrieve, and update methods on resources V2.Billing.BillSetting, V2.Billing.CollectionSetting, V2.Billing.CustomPricingUnit, V2.Billing.LicenseFee, V2.Billing.LicensedItem, V2.Billing.MeteredItem, V2.Billing.PricingPlan, V2.Billing.Profile, and V2.Billing.RateCard
  • Add support for all and retrieve methods on resources V2.Billing.BillSettingVersion, V2.Billing.CollectionSettingVersion, V2.Billing.IntentAction, V2.Billing.LicenseFeeVersion, V2.Billing.PricingPlanSubscription, V2.Billing.PricingPlanVersion, and V2.Billing.RateCardVersion
  • Add support for all, create, delete, and retrieve methods on resource V2.Billing.RateCardRate
  • Add support for all, create, delete, retrieve, and update methods on resource V2.Billing.PricingPlanComponent
  • Add support for all, cancel, commit, create, release_reservation, reserve, and retrieve methods on resource V2.Billing.Intent
  • Add support for changes on V2.Event
  • Add support for thin events V2BillingCadenceBilledEvent, V2BillingCadenceCanceledEvent, V2BillingCadenceCreatedEvent, and V2BillingCadenceErroredEvent with related object V2.Billing.Cadence
  • Add support for thin events V2BillingLicenseFeeCreatedEvent and V2BillingLicenseFeeUpdatedEvent with related object V2.Billing.LicenseFee
  • Add support for thin event V2BillingLicenseFeeVersionCreatedEvent with related object V2.Billing.LicenseFeeVersion
  • Add support for thin events V2BillingLicensedItemCreatedEvent and V2BillingLicensedItemUpdatedEvent with related object V2.Billing.LicensedItem
  • Add support for thin events V2BillingMeteredItemCreatedEvent and V2BillingMeteredItemUpdatedEvent with related object V2.Billing.MeteredItem
  • Add support for thin events V2BillingPricingPlanCreatedEvent and V2BillingPricingPlanUpdatedEvent with related object V2.Billing.PricingPlan
  • Add support for thin events V2BillingPricingPlanComponentCreatedEvent and V2BillingPricingPlanComponentUpdatedEvent with related object V2.Billing.PricingPlanComponent
  • Add support for thin events V2BillingPricingPlanSubscriptionCollectionAwaitingCustomerActionEvent, V2BillingPricingPlanSubscriptionCollectionCurrentEvent, V2BillingPricingPlanSubscriptionCollectionPastDueEvent, V2BillingPricingPlanSubscriptionCollectionPausedEvent, V2BillingPricingPlanSubscriptionCollectionUnpaidEvent, V2BillingPricingPlanSubscriptionServicingActivatedEvent, V2BillingPricingPlanSubscriptionServicingCanceledEvent, and V2BillingPricingPlanSubscriptionServicingPausedEvent with related object V2.Billing.PricingPlanSubscription
  • Add support for thin event V2BillingPricingPlanVersionCreatedEvent with related object V2.Billing.PricingPlanVersion
  • Add support for thin events V2BillingRateCardCreatedEvent and V2BillingRateCardUpdatedEvent with related object V2.Billing.RateCard
  • Add support for thin event V2BillingRateCardRateCreatedEvent with related object V2.Billing.RateCardRate
  • Add support for thin events V2BillingRateCardSubscriptionActivatedEvent, V2BillingRateCardSubscriptionCanceledEvent, V2BillingRateCardSubscriptionCollectionAwaitingCustomerActionEvent, V2BillingRateCardSubscriptionCollectionCurrentEvent, V2BillingRateCardSubscriptionCollectionPastDueEvent, V2BillingRateCardSubscriptionCollectionPausedEvent, V2BillingRateCardSubscriptionCollectionUnpaidEvent, V2BillingRateCardSubscriptionServicingActivatedEvent, V2BillingRateCardSubscriptionServicingCanceledEvent, and V2BillingRateCardSubscriptionServicingPausedEvent with related object V2.Billing.RateCardSubscription
  • Add support for thin event V2BillingRateCardVersionCreatedEvent with related object V2.Billing.RateCardVersion
  • Add support for thin events V2CoreHealthApiErrorFiringEvent, V2CoreHealthApiErrorResolvedEvent, V2CoreHealthApiLatencyFiringEvent, V2CoreHealthApiLatencyResolvedEvent, V2CoreHealthAuthorizationRateDropFiringEvent, V2CoreHealthAuthorizationRateDropResolvedEvent, V2CoreHealthEventGenerationFailureResolvedEvent, V2CoreHealthFraudRateIncreasedEvent, V2CoreHealthIssuingAuthorizationRequestTimeoutFiringEvent, V2CoreHealthIssuingAuthorizationRequestTimeoutResolvedEvent, V2CoreHealthPaymentMethodErrorFiringEvent, V2CoreHealthPaymentMethodErrorResolvedEvent, V2CoreHealthTrafficVolumeDropFiringEvent, V2CoreHealthTrafficVolumeDropResolvedEvent, V2CoreHealthWebhookLatencyFiringEvent, and V2CoreHealthWebhookLatencyResolvedEvent
  • Add support for thin events V2ReportingReportRunCreatedEvent, V2ReportingReportRunFailedEvent, V2ReportingReportRunSucceededEvent, and V2ReportingReportRunUpdatedEvent with related object V2.Reporting.ReportRun
  • Add support for error type RateLimitException
  • Adds getStripeParam and setStripeParam to ApiErrorException base class. Currently, this is only used by RateLimitExceptions returned from v2 services.

See the changelog for more details.

• #1895 Add section on private preview SDKs in readme
• #1890 Update generated code. This release changes the pinned API version to 2025-08-27.basil.
  • Add support for balance_report, payout_details, and payout_reconciliation_report on AccountSession.components and AccountSession.create().$params.component
  • Add support for name on BillingPortal.Configuration, BillingPortal\Configuration.create().$params, and BillingPortal\Configuration.update().$params
  • Add support for installments on Charge.payment_method_details.alma
  • Add support for transaction_id on Charge.payment_method_details.alma, Charge.payment_method_details.amazon_pay, Charge.payment_method_details.billie, Charge.payment_method_details.kakao_pay, Charge.payment_method_details.kr_card, Charge.payment_method_details.naver_pay, Charge.payment_method_details.payco, Charge.payment_method_details.revolut_pay, Charge.payment_method_details.samsung_pay, and Charge.payment_method_details.satispay
  • Add support for location and reader on Charge.payment_method_details.paynow
  • Add support for amount_includes_iof on Checkout.Session.payment_method_options.pix, Checkout\Session.create().$params.payment_method_option.pix, PaymentIntent.confirm().$params.payment_method_option.pix, PaymentIntent.create().$params.payment_method_option.pix, PaymentIntent.payment_method_options.pix, and PaymentIntent.update().$params.payment_method_option.pix
  • Add support for new values block and resolution on enum Dispute.payment_method_details.card.case_type
  • Add support for new value terminal_android_apk on enum File.purpose
  • Add support for metadata and period on Invoice.create_preview().$params.schedule_detail.phase.add_invoice_item, Subscription.create().$params.add_invoice_item, Subscription.update().$params.add_invoice_item, SubscriptionSchedule.create().$params.phase.add_invoice_item, SubscriptionSchedule.phases[].add_invoice_items[], and SubscriptionSchedule.update().$params.phase.add_invoice_item
  • Add support for exp_month and exp_year on Issuing\Card.create().$params
  • Add support for excluded_payment_method_types on PaymentIntent.create().$params and PaymentIntent
  • Add support for payout_method on Payout.create().$params and Payout
  • Add support for mxn on Terminal.Configuration.tipping, Terminal\Configuration.create().$params.tipping, and Terminal\Configuration.update().$params.tipping
  • Add support for card on Terminal\Reader.present_payment_method().$params
  • Add support for error codes customer_session_expired and india_recurring_payment_mandate_canceled on Invoice.last_finalization_error, PaymentIntent.last_payment_error, SetupAttempt.setup_error, SetupIntent.last_setup_error, and StripeError
• #1894 Add getter for Stripe Account on BaseStripeClient
  • Add getStripeAccount method on BaseStripeClient to retrieve Stripe Account ID from a StripeClient instance.

See the changelog for more details.

• #1891 Bring back invoice payments APIs that were missing in the public preview SDKs
  • Add support for new resource InvoicePayment
  • Add support for all and retrieve methods on resource InvoicePayment

See the changelog for more details.

This release changes the pinned API version to 2025-07-30.preview.

• #1885 Update generated code for beta
  • Add support for new resources Billing.MeterUsageRow, Billing.MeterUsage, and Terminal.OnboardingLink
  • Add support for retrieve method on resource Billing.MeterUsage
  • Add support for create method on resource Terminal.OnboardingLink
  • Add support for smart_disputes on Dispute
  • Add support for new value upi on enums Invoice.payment_settings.payment_method_types, QuotePreviewInvoice.payment_settings.payment_method_types, and Subscription.payment_settings.payment_method_types
  • Add support for thin event V2CoreAccountLinkReturnedEvent
  • Add support for thin event V2MoneyManagementPayoutMethodUpdatedEvent with related object V2.MoneyManagement.PayoutMethod
  • Remove support for thin event V2CoreAccountLinkCompletedEvent
  • Remove support for thin event V2OffSessionPaymentRequiresCaptureEvent with related object V2.Payments.OffSessionPayment

See the changelog for more details.

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

• #1887 Update generated code
  • Add support for origin_context on Checkout.Session
• #1881 Ensure compatibility with POST on older versions of libcurl
  • Fixes an issue with older versions of php/libcurl where certain SDK calls that have empty POST bodies will result in a 400 Bad Request returned from the server.

See the changelog for more details.

• #1886 Pull in V2 FinancialAccount changes for June release
  • Add support for close and create methods on resource V2.MoneyManagement.FinancialAccount
  • Add support for new value storer on enum V2.Core.Account.applied_configurations
  • Add support for status_details on V2.MoneyManagement.FinancialAccount
  • Add support for thin events V2CoreAccountIncludingConfigurationStorerCapabilityStatusUpdatedEvent and V2CoreAccountIncludingConfigurationStorerUpdatedEvent with related object V2.Core.Account
  • Add support for error types AlreadyExistsException and NonZeroBalanceException

See the changelog for more details.

• #1876 Update generated code for beta
  • Change type of Quote.subscription_data.billing_mode from enum('classic'|'flexible') to QuotesResourceSubscriptionDataBillingMode
  • Add support for new value crypto on enum QuotePreviewInvoice.payment_settings.payment_method_types
  • Change type of QuotePreviewSubscriptionSchedule.billing_mode, Subscription.billing_mode, and SubscriptionSchedule.billing_mode from enum('classic'|'flexible') to SubscriptionsResourceBillingMode
  • Remove support for billing_mode_details on Subscription
  • Add support for new value xx on enums V2.Core.Account.identity.country, V2.Core.Person.additional_addresses[].country, V2.Core.Person.address.country, and V2.MoneyManagement.FinancialAccount.country
  • Add support for new value xx on enum V2.Core.Person.nationalities
  • Add support for metadata on V2.MoneyManagement.FinancialAccount
  • Remove support for description on V2.MoneyManagement.FinancialAccount
  • Add support for new value pending on enum V2.MoneyManagement.FinancialAccount.status
  • Remove support for attempts on V2.Payments.OffSessionPayment
  • Change type of V2.Payments.OffSessionPayment.transfer_data.amount from integer to nullable(integer)
  • Change type of V2.MoneyManagement.ReceivedCredit.balance_transfer.type from literal('payout_v1') to enum('outbound_payment'|'outbound_transfer'|'payout_v1')
  • Change type of V2.MoneyManagement.ReceivedCredit.balance_transfer.payout_v1 from string to nullable(string)

See the changelog for more details.

• #1880 Update generated code
  • Add support for migrate method on resource Subscription
  • Add support for collect_payment_method and confirm_payment_intent methods on resource Terminal.Reader
  • Add support for new value crypto on enums ConfirmationToken.payment_method_preview.type and PaymentMethod.type
  • Change type of Dispute.enhanced_eligibility_types from literal('visa_compelling_evidence_3') to enum('visa_compelling_evidence_3'|'visa_compliance')
  • Add support for new value terminal.reader.action_updated on enum Event.type
  • Add support for related_person on Identity.VerificationSession
  • Add support for new value crypto on enums Invoice.payment_settings.payment_method_types and Subscription.payment_settings.payment_method_types
  • Add support for crypto on PaymentMethod
  • Add support for new value buut on enum PaymentMethod.ideal.bank
  • Add support for new value BUUTNL2A on enum PaymentMethod.ideal.bic
  • Add support for billing_mode on SubscriptionSchedule and Subscription
  • Add support for new values collect_payment_method and confirm_payment_intent on enum Terminal.Reader.action.type
  • Add support for snapshot event TERMINAL_READER_ACTION_UPDATED with resource Terminal.Reader
• #1878 Update generated code
  • Add constant CURRENT_MAJOR in ApiVersion

See the changelog for more details.

• #1883 Pull in OffSessionPayment changes for the May release

See the changelog for more details.