- #1323 Update generated code
- Add support for
allow_redisplay
on resource classstripe.ConfirmationToken.PaymentMethodPreview
and resourcestripe.PaymentMethod
- Add support for
preview_mode
on parameter classesstripe.Invoice.CreatePreviewParams
,stripe.Invoice.UpcomingLinesParams
, andstripe.Invoice.UpcomingParams
- Add support for
_cls_update
on resourcesstripe.treasury.OutboundPayment
andstripe.treasury.OutboundTransfer
- Add support for
tracking_details
on resourcesstripe.treasury.OutboundPayment
andstripe.treasury.OutboundTransfer
- Add support for
update
on resourcesstripe.treasury.OutboundPayment
andstripe.treasury.OutboundTransfer
- Add support for
treasury.outbound_payment.tracking_details_updated
on enumsstripe.Event.type
,stripe.WebhookEndpoint.CreateParams.enabled_events
, andstripe.WebhookEndpoint.ModifyParams.enabled_events
- Add support for
treasury.outbound_transfer.tracking_details_updated
on enumsstripe.Event.type
,stripe.WebhookEndpoint.CreateParams.enabled_events
, andstripe.WebhookEndpoint.ModifyParams.enabled_events
- Add support for
- #1317 Update generated code
- Add support for
paypal
on resource classstripe.Dispute.PaymentMethodDetails
- Add support for
payment_method_types
on parameter classstripe.PaymentIntent.ConfirmParams
- Add support for
ship_from_details
on parameter classstripe.tax.Calculation.CreateParams
and resourcesstripe.tax.Calculation
andstripe.tax.Transaction
- Add support for
bh
,eg
,ge
,ke
,kz
,ng
,om
on resource classstripe.tax.Registration.CountryOptions
and parameter classstripe.tax.Registration.CreateParamsCountryOptions
- Add support for
paypal
on enumstripe.Dispute.PaymentMethodDetails.type
- Add support for
shipping_address_invalid
on enumsstripe.Invoice.LastFinalizationError.code
,stripe.PaymentIntent.LastPaymentError.code
,stripe.SetupAttempt.SetupError.code
, andstripe.SetupIntent.LastSetupError.code
- Change type of
metadata
onstripe.entitlements.Feature.ModifyParams
fromDict[str, str]
toLiteral['']|Dict[str, str]
- Add support for
- #1319 Fix type change entries in Python Changelog
- #1316 Update generated code
- Add support for
amazon_pay
on resource classesstripe.Mandate.PaymentMethodDetails
andstripe.SetupAttempt.PaymentMethodDetails
- Add support for
revolut_pay
on resource classesstripe.Mandate.PaymentMethodDetails
andstripe.SetupAttempt.PaymentMethodDetails
- Add support for
setup_future_usage
on resource classesstripe.PaymentIntent.PaymentMethodOptions.AmazonPay
,stripe.PaymentIntent.PaymentMethodOptions.RevolutPay
,stripe.checkout.Session.PaymentMethodOptions.AmazonPay
, andstripe.checkout.Session.PaymentMethodOptions.RevolutPay
- Add support for
mobilepay
on parameter classesstripe.PaymentMethodConfiguration.CreateParams
andstripe.PaymentMethodConfiguration.ModifyParams
and resourcestripe.PaymentMethodConfiguration
- Add support for
ending_before
on parameter classstripe.PaymentMethodConfiguration.ListParams
- Add support for
limit
on parameter classstripe.PaymentMethodConfiguration.ListParams
- Add support for
starting_after
on parameter classstripe.PaymentMethodConfiguration.ListParams
- Change type of
feature
onstripe.entitlements.ActiveEntitlement
fromstr
toExpandableField[Feature]
- Add support for
amazon_pay
on enumsstripe.Invoice.PaymentSettings.payment_method_types
,stripe.Invoice.CreateParamsPaymentSettings.payment_method_types
,stripe.Invoice.ModifyParamsPaymentSettings.payment_method_types
,stripe.Subscription.PaymentSettings.payment_method_types
,stripe.Subscription.CreateParamsPaymentSettings.payment_method_types
, andstripe.Subscription.ModifyParamsPaymentSettings.payment_method_types
- Add support for
revolut_pay
on enumsstripe.Invoice.PaymentSettings.payment_method_types
,stripe.Invoice.CreateParamsPaymentSettings.payment_method_types
,stripe.Invoice.ModifyParamsPaymentSettings.payment_method_types
,stripe.Subscription.PaymentSettings.payment_method_types
,stripe.Subscription.CreateParamsPaymentSettings.payment_method_types
, andstripe.Subscription.ModifyParamsPaymentSettings.payment_method_types
- Remove support for inadvertently released identity verification features
email
andphone
on parameter classesstripe.identity.VerificationSession.CreateParamsOptions
andstripe.identity.VerificationSession.ModifyParamsOptions
- Add support for
- #1307 Bump aiohttp from 3.9.2 to 3.9.4
- #1305 Update generated code
- Add support for
allow_redisplay
on parameter classesstripe.ConfirmationToken.CreateParamsPaymentMethodData
,stripe.Customer.ListPaymentMethodsParams
,stripe.PaymentIntent.ConfirmParamsPaymentMethodData
,stripe.PaymentIntent.CreateParamsPaymentMethodData
,stripe.PaymentIntent.ModifyParamsPaymentMethodData
,stripe.PaymentMethod.CreateParams
,stripe.PaymentMethod.ModifyParams
,stripe.SetupIntent.ConfirmParamsPaymentMethodData
,stripe.SetupIntent.CreateParamsPaymentMethodData
, andstripe.SetupIntent.ModifyParamsPaymentMethodData
- Add support for
schedule_details
on parameter classesstripe.Invoice.UpcomingLinesParams
andstripe.Invoice.UpcomingParams
- Add support for
subscription_details
on parameter classesstripe.Invoice.UpcomingLinesParams
andstripe.Invoice.UpcomingParams
- Add support for
create_preview
on resourcestripe.Invoice
- Add support for
payment_method_data
on parameter classstripe.checkout.Session.CreateParams
- Add support for
saved_payment_method_options
on parameter classstripe.checkout.Session.CreateParams
and resourcestripe.checkout.Session
- Add support for
mobilepay
on parameter classstripe.checkout.Session.CreateParamsPaymentMethodOptions
and resource classstripe.checkout.Session.PaymentMethodOptions
- Add support for
mobilepay
on enumstripe.checkout.Session.CreateParams.payment_method_types
- Add support for
other
on enumsstripe.issuing.Authorization.CaptureParamsPurchaseDetailsFuel.unit
,stripe.issuing.Transaction.CreateForceCaptureParamsPurchaseDetailsFuel.unit
, andstripe.issuing.Transaction.CreateUnlinkedRefundParamsPurchaseDetailsFuel.unit
- Add support for
- #1306 Update
Quote.pdf()
to use the right base address i.e. files.stripe.com instead of api.stripe.com. Fixes #1303
- #1301 Update generated code
- Add support for
balances
on resource classstripe.AccountSession.Components
and parameter classstripe.AccountSession.CreateParamsComponents
- Add support for
payouts_list
on resource classstripe.AccountSession.Components
and parameter classstripe.AccountSession.CreateParamsComponents
- Add support for
capture_method
on parameter classesstripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsRevolutPay
,stripe.PaymentIntent.CreateParamsPaymentMethodOptionsRevolutPay
, andstripe.PaymentIntent.ModifyParamsPaymentMethodOptionsRevolutPay
and resource classstripe.PaymentIntent.PaymentMethodOptions.RevolutPay
- Add support for
swish
on parameter classesstripe.PaymentMethodConfiguration.CreateParams
andstripe.PaymentMethodConfiguration.ModifyParams
and resourcestripe.PaymentMethodConfiguration
- Add support for resource
stripe.entitlements.ActiveEntitlementSummary
- Remove support for
config
on parameter classstripe.forwarding.Request.CreateParams
and resourcestripe.forwarding.Request
. This field is no longer used by the Forwarding Request API. - Change type of
destination_on_behalf_of_charge_management
onstripe.AccountSession.Components.PaymentDetails.Features
andstripe.AccountSession.Components.Payments.Features
fromOptional[bool]
tobool
- Change type of
timestamp
onstripe.billing.MeterEvent.CreateParams
fromint
toNotRequired[int]
- Add support for
entitlements.active_entitlement_summary.updated
on enumsstripe.Event.type
,stripe.WebhookEndpoint.CreateParams.enabled_events
, andstripe.WebhookEndpoint.ModifyParams.enabled_events
- Add support for
- #1300 Update generated code
- Add support for
external_account_collection
on resource classstripe.AccountSession.Components.AccountOnboarding.Features
and parameter classstripe.AccountSession.CreateParamsComponentsAccountOnboardingFeatures
- Add support for
account_management
on resource classstripe.AccountSession.Components
and parameter classstripe.AccountSession.CreateParamsComponents
- Add support for
notification_banner
on resource classstripe.AccountSession.Components
and parameter classstripe.AccountSession.CreateParamsComponents
- Add support for
amazon_pay
on resource classesstripe.Charge.PaymentMethodDetails
,stripe.ConfirmationToken.PaymentMethodPreview
,stripe.PaymentIntent.PaymentMethodOptions
,stripe.Refund.DestinationDetails
,stripe.SetupIntent.PaymentMethodOptions
, andstripe.checkout.Session.PaymentMethodOptions
, parameter classesstripe.ConfirmationToken.CreateParamsPaymentMethodData
,stripe.PaymentIntent.ConfirmParamsPaymentMethodData
,stripe.PaymentIntent.ConfirmParamsPaymentMethodOptions
,stripe.PaymentIntent.CreateParamsPaymentMethodData
,stripe.PaymentIntent.CreateParamsPaymentMethodOptions
,stripe.PaymentIntent.ModifyParamsPaymentMethodData
,stripe.PaymentIntent.ModifyParamsPaymentMethodOptions
,stripe.PaymentMethod.CreateParams
,stripe.PaymentMethodConfiguration.CreateParams
,stripe.PaymentMethodConfiguration.ModifyParams
,stripe.SetupIntent.ConfirmParamsPaymentMethodData
,stripe.SetupIntent.ConfirmParamsPaymentMethodOptions
,stripe.SetupIntent.CreateParamsPaymentMethodData
,stripe.SetupIntent.CreateParamsPaymentMethodOptions
,stripe.SetupIntent.ModifyParamsPaymentMethodData
,stripe.SetupIntent.ModifyParamsPaymentMethodOptions
, andstripe.checkout.Session.CreateParamsPaymentMethodOptions
, and resourcesstripe.PaymentMethod
andstripe.PaymentMethodConfiguration
- Add support for
next_refresh_available_at
on resource classstripe.financial_connections.Account.OwnershipRefresh
- Change type of
cancel
onstripe.billing.MeterEventAdjustment
fromCancel
toOptional[Cancel]
- Change type of
identifier
onstripe.billing.MeterEventAdjustment.Cancel
fromstr
toOptional[str]
- Change type of
identifier
onstripe.billing.MeterEventAdjustment.CreateParamsCancel
fromstr
toNotRequired[str]
- Change type of
cancel
onstripe.billing.MeterEventAdjustment.CreateParams
fromMeterEventAdjustment.CreateParamsCancel
toNotRequired[MeterEventAdjustment.CreateParamsCancel]
- Change type of
type
onstripe.billing.MeterEventAdjustment.CreateParams
fromNotRequired[Literal['cancel']]
toLiteral['cancel']
- Add support for
bh_vat
on enumsstripe.checkout.Session.CustomerDetails.TaxId.type
,stripe.Customer.CreateParamsTaxIdDatum.type
,stripe.Customer.CreateTaxIdParams.type
,stripe.Invoice.CustomerTaxId.type
,stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type
,stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type
,stripe.tax.Calculation.CustomerDetails.TaxId.type
,stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type
,stripe.tax.Transaction.CustomerDetails.TaxId.type
,stripe.TaxId.type
, andstripe.TaxId.CreateParams.type
- Add support for
kz_bin
on enumsstripe.checkout.Session.CustomerDetails.TaxId.type
,stripe.Customer.CreateParamsTaxIdDatum.type
,stripe.Customer.CreateTaxIdParams.type
,stripe.Invoice.CustomerTaxId.type
,stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type
,stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type
,stripe.tax.Calculation.CustomerDetails.TaxId.type
,stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type
,stripe.tax.Transaction.CustomerDetails.TaxId.type
,stripe.TaxId.type
, andstripe.TaxId.CreateParams.type
- Add support for
ng_tin
on enumsstripe.checkout.Session.CustomerDetails.TaxId.type
,stripe.Customer.CreateParamsTaxIdDatum.type
,stripe.Customer.CreateTaxIdParams.type
,stripe.Invoice.CustomerTaxId.type
,stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type
,stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type
,stripe.tax.Calculation.CustomerDetails.TaxId.type
,stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type
,stripe.tax.Transaction.CustomerDetails.TaxId.type
,stripe.TaxId.type
, andstripe.TaxId.CreateParams.type
- Add support for
om_vat
on enumsstripe.checkout.Session.CustomerDetails.TaxId.type
,stripe.Customer.CreateParamsTaxIdDatum.type
,stripe.Customer.CreateTaxIdParams.type
,stripe.Invoice.CustomerTaxId.type
,stripe.Invoice.UpcomingParamsCustomerDetailsTaxId.type
,stripe.Invoice.UpcomingLinesParamsCustomerDetailsTaxId.type
,stripe.tax.Calculation.CustomerDetails.TaxId.type
,stripe.tax.Calculation.CreateParamsCustomerDetailsTaxId.type
,stripe.tax.Transaction.CustomerDetails.TaxId.type
,stripe.TaxId.type
, andstripe.TaxId.CreateParams.type
- Add support for
ownership
on enumsstripe.checkout.Session.PaymentMethodOptions.UsBankAccount.FinancialConnections.prefetch
,stripe.checkout.Session.CreateParamsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch
,stripe.Invoice.PaymentSettings.PaymentMethodOptions.UsBankAccount.FinancialConnections.permissions
,stripe.Invoice.PaymentSettings.PaymentMethodOptions.UsBankAccount.FinancialConnections.prefetch
,stripe.Invoice.CreateParamsPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch
,stripe.Invoice.ModifyParamsPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch
,stripe.PaymentIntent.PaymentMethodOptions.UsBankAccount.FinancialConnections.prefetch
,stripe.PaymentIntent.ConfirmParamsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch
,stripe.PaymentIntent.CreateParamsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch
,stripe.PaymentIntent.ModifyParamsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch
,stripe.SetupIntent.PaymentMethodOptions.UsBankAccount.FinancialConnections.prefetch
,stripe.SetupIntent.ConfirmParamsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch
,stripe.SetupIntent.CreateParamsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch
,stripe.SetupIntent.ModifyParamsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch
,stripe.Subscription.PaymentSettings.PaymentMethodOptions.UsBankAccount.FinancialConnections.permissions
,stripe.Subscription.PaymentSettings.PaymentMethodOptions.UsBankAccount.FinancialConnections.prefetch
,stripe.Subscription.CreateParamsPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch
, andstripe.Subscription.ModifyParamsPaymentSettingsPaymentMethodOptionsUsBankAccountFinancialConnections.prefetch
- Add support for
amazon_pay
on enumsstripe.checkout.Session.CreateParams.payment_method_types
,stripe.ConfirmationToken.PaymentMethodPreview.type
,stripe.ConfirmationToken.CreateParamsPaymentMethodData.type
,stripe.Customer.ListPaymentMethodsParams.type
,stripe.PaymentIntent.ConfirmParamsPaymentMethodData.type
,stripe.PaymentIntent.CreateParamsPaymentMethodData.type
,stripe.PaymentIntent.ModifyParamsPaymentMethodData.type
,stripe.PaymentMethod.type
,stripe.PaymentMethod.CreateParams.type
,stripe.PaymentMethod.ListParams.type
,stripe.SetupIntent.ConfirmParamsPaymentMethodData.type
,stripe.SetupIntent.CreateParamsPaymentMethodData.type
, andstripe.SetupIntent.ModifyParamsPaymentMethodData.type
- Add support for
billing_policy_remote_function_response_invalid
on enumsstripe.Invoice.LastFinalizationError.code
,stripe.PaymentIntent.LastPaymentError.code
,stripe.SetupAttempt.SetupError.code
, andstripe.SetupIntent.LastSetupError.code
- Add support for
billing_policy_remote_function_timeout
on enumsstripe.Invoice.LastFinalizationError.code
,stripe.PaymentIntent.LastPaymentError.code
,stripe.SetupAttempt.SetupError.code
, andstripe.SetupIntent.LastSetupError.code
- Add support for
billing_policy_remote_function_unexpected_status_code
on enumsstripe.Invoice.LastFinalizationError.code
,stripe.PaymentIntent.LastPaymentError.code
,stripe.SetupAttempt.SetupError.code
, andstripe.SetupIntent.LastSetupError.code
- Add support for
billing_policy_remote_function_unreachable
on enumsstripe.Invoice.LastFinalizationError.code
,stripe.PaymentIntent.LastPaymentError.code
,stripe.SetupAttempt.SetupError.code
, andstripe.SetupIntent.LastSetupError.code
- Add support for
- #1297 Use stdlib AsyncMock when available
-
- This release changes the pinned API version to
2024-04-10
. Please read the API Upgrade Guide and carefully review the API changes before upgrading.
- Remove
FinancialAccountFeaturesService.CreateParams
,FinancialAccountFeaturesService.ListParams
,FinancialAccountFeaturesService.create()
,FinancialAccountFeaturesService.list()
as Financial account features is a singleton and so should have retrieve and update methods instead of create and list methods. - Rename
features
tomarketing_features
on parameter classesstripe.Product.CreateParams
andstripe.Product.ModifyParams
and resourcestripe.Product
.
⚠️ Removal of enum values, properties and events that are no longer part of the publicly documented Stripe API- Remove
.subscription_pause
from the below as the feature to pause subscription on the portal has been deprecatedConfiguration.Features
ConfigurationService.CreateParamsFeatures
ConfigurationService.UpdateParamsFeatures
- Remove the below deprecated values for
BalanceTransaction.type
obligation_inbound
obligation_payout
obligation_payout_failure
obligation_reversal_outbound
- Remove the below deprecated events from
Event.type
,WebhookEndpoint.CreateParams.enabled_events
,WebhookEndpoint.ModifyParams.enabled_events
,WebhookEndpointService.CreateParams.enabled_events
,WebhookEndpointService.ModifyParams.enabled_events
invoiceitem.updated
order.created
recipient.created
recipient.deleted
recipient.updated
sku.created
sku.deleted
sku.updated
- Remove the deprecated value
include_and_require
forInvoice.CreateParams.pending_invoice_items_behavior
andInvoiceService.CreateParams.pending_invoice_items_behavior
- Remove the deprecated value
service_tax
forTaxRate.RetrieveParams.tax_type
TaxRate.CreateParams.tax_type
TaxRate.ModifyParams.tax_type
TaxRateService.CreateParams.tax_type
TaxRateService.UpdateParams.tax_type
InvoiceLineItem.ModifyParamsTaxAmountTaxRateData.tax_type
InvoiceLineItemService.UpdateParamsTaxAmountTaxRateData.tax_type
- Remove
request_incremental_authorization
fromPaymentIntent.ConfirmParamsPaymentMethodOptionsCardPresent
PaymentIntent.CreateParamsPaymentMethodOptionsCardPresent
PaymentIntent.ModifyParamsPaymentMethodOptionsCardPresent
PaymentIntentService.ConfirmParamsPaymentMethodOptionsCardPresent
PaymentIntentService.CreateParamsPaymentMethodOptionsCardPresent
PaymentIntentService.ModifyParamsPaymentMethodOptionsCardPresent
- Remove support for
id_bank_transfer
,multibanco
,netbanking
,pay_by_bank
, andupi
onPaymentMethodConfiguration
- Remove the deprecated value
challenge_only
fromSetupIntent.PaymentMethodOptions.Card.request_three_d_secure
- Remove deprecated value
various
forClimate.Supplier.removal_pathway
- Remove the deprecated value
obligation
forReportRun.CreateParamsParameters.reporting_category
andReportRunService.CreateParamsParameters.reporting_category
- Remove the legacy field
rendering_options
on parameter classesstripe.Invoice.CreateParams
andstripe.Invoice.ModifyParams
and resourcestripe.Invoice
. Userendering
instead.
- This release changes the pinned API version to
-
#1295 Update generated code
- Add support for
fees
,losses
,requirement_collection
&stripe_dashboard
on resource classstripe.Account.Controller
- Add support for
controller
on parameter classstripe.Account.CreateParams
- Add support for
create_feature
,delete_feature
,list_features
,retrieve_feature
on resourcestripe.Product
- Add support for resource
stripe.ProductFeature
- Add support for
event_name
on parameter classstripe.billing.MeterEventAdjustment.CreateParams
and resourcestripe.billing.MeterEventAdjustment
- Add support for
cancel
andtype
on resourcestripe.billing.MeterEventAdjustment
- Add support for resource
stripe.entitlements.ActiveEntitlement
- Add support for resource
stripe.entitlements.Feature
- Add support for
none
on enumstripe.Account.type
- Add support for
-
#1299 Fix README.md
-
#1292 Tweak changelog for python async note
-
#1288 Port async support from beta to the stable channel. To use it, add an
_async
suffix to any request-making method.- cus = stripe.Customer.create(...) + cus = await stripe.Customer.create_async(...)
See the README for detailed usage instructions. Support is provided out of the box for async requests via the HTTPX (used by default) and aiohttp libraries. For other libraries, you can also provide your own
stripe.HTTPClient
implementation. Please do not hesitate to open a Github issue if you have any feedback on this feature. -
#1284 Update generated code
- Add support for
subscription_item
on resourcestripe.Discount
- Add support for
promotion_code
on parameter classesstripe.Invoice.CreateParamsDiscount
,stripe.Invoice.ModifyParamsDiscount
,stripe.InvoiceItem.CreateParamsDiscount
,stripe.InvoiceItem.ModifyParamsDiscount
,stripe.InvoiceLineItem.ModifyParamsDiscount
,stripe.Quote.CreateParamsDiscount
, andstripe.Quote.ModifyParamsDiscount
- Add support for
discounts
on parameter classesstripe.Invoice.UpcomingLinesParamsSubscriptionItem
,stripe.Invoice.UpcomingParamsSubscriptionItem
,stripe.Quote.CreateParamsLineItem
,stripe.Quote.ModifyParamsLineItem
,stripe.Subscription.CreateParams
,stripe.Subscription.CreateParamsAddInvoiceItem
,stripe.Subscription.CreateParamsItem
,stripe.Subscription.ModifyParams
,stripe.Subscription.ModifyParamsAddInvoiceItem
,stripe.Subscription.ModifyParamsItem
,stripe.SubscriptionItem.CreateParams
,stripe.SubscriptionItem.ModifyParams
,stripe.SubscriptionSchedule.CreateParamsPhase
,stripe.SubscriptionSchedule.CreateParamsPhaseAddInvoiceItem
,stripe.SubscriptionSchedule.CreateParamsPhaseItem
,stripe.SubscriptionSchedule.ModifyParamsPhase
,stripe.SubscriptionSchedule.ModifyParamsPhaseAddInvoiceItem
, andstripe.SubscriptionSchedule.ModifyParamsPhaseItem
, resourcesstripe.Subscription
andstripe.SubscriptionItem
, and resource classesstripe.SubscriptionSchedule.Phase.AddInvoiceItem
,stripe.SubscriptionSchedule.Phase.Item
, andstripe.SubscriptionSchedule.Phase
- Add support for
zip
on parameter classesstripe.PaymentMethodConfiguration.CreateParams
andstripe.PaymentMethodConfiguration.ModifyParams
and resourcestripe.PaymentMethodConfiguration
- Add support for
offline
on resource classstripe.SetupAttempt.PaymentMethodDetails.CardPresent
- Add support for
card_present
on parameter classesstripe.SetupIntent.ConfirmParamsPaymentMethodOptions
,stripe.SetupIntent.CreateParamsPaymentMethodOptions
, andstripe.SetupIntent.ModifyParamsPaymentMethodOptions
and resource classstripe.SetupIntent.PaymentMethodOptions
- Add support for
email
on resourcestripe.identity.VerificationReport
, parameter classesstripe.identity.VerificationSession.CreateParamsOptions
andstripe.identity.VerificationSession.ModifyParamsOptions
, and resource classesstripe.identity.VerificationSession.Options
andstripe.identity.VerificationSession.VerifiedOutputs
- Add support for
phone
on resourcestripe.identity.VerificationReport
, parameter classesstripe.identity.VerificationSession.CreateParamsOptions
andstripe.identity.VerificationSession.ModifyParamsOptions
, and resource classesstripe.identity.VerificationSession.Options
andstripe.identity.VerificationSession.VerifiedOutputs
- Add support for
verification_flow
on resourcesstripe.identity.VerificationReport
andstripe.identity.VerificationSession
and parameter classstripe.identity.VerificationSession.CreateParams
- Add support for
provided_details
on parameter classesstripe.identity.VerificationSession.CreateParams
andstripe.identity.VerificationSession.ModifyParams
and resourcestripe.identity.VerificationSession
- Add support for
allowed_merchant_countries
on parameter classesstripe.issuing.Card.CreateParamsSpendingControls
,stripe.issuing.Card.ModifyParamsSpendingControls
,stripe.issuing.Cardholder.CreateParamsSpendingControls
, andstripe.issuing.Cardholder.ModifyParamsSpendingControls
and resource classesstripe.issuing.Card.SpendingControls
andstripe.issuing.Cardholder.SpendingControls
- Add support for
blocked_merchant_countries
on parameter classesstripe.issuing.Card.CreateParamsSpendingControls
,stripe.issuing.Card.ModifyParamsSpendingControls
,stripe.issuing.Cardholder.CreateParamsSpendingControls
, andstripe.issuing.Cardholder.ModifyParamsSpendingControls
and resource classesstripe.issuing.Card.SpendingControls
andstripe.issuing.Cardholder.SpendingControls
- Change type of
reference
onstripe.checkout.Session.CreateParamsPaymentMethodOptionsSwish
fromLiteral['']|str
tostr
- Add support for
verification_flow
on enumsstripe.identity.VerificationReport.type
andstripe.identity.VerificationSession.type
- Add support for
email_unverified_other
on enumstripe.identity.VerificationSession.LastError.code
- Add support for
email_verification_declined
on enumstripe.identity.VerificationSession.LastError.code
- Add support for
phone_unverified_other
on enumstripe.identity.VerificationSession.LastError.code
- Add support for
phone_verification_declined
on enumstripe.identity.VerificationSession.LastError.code
- Add support for
mobile_phone_reader
on enumsstripe.terminal.Reader.device_type
andstripe.terminal.Reader.ListParams.device_type
- Change type of
type
onstripe.identity.VerificationSession.CreateParams
fromLiteral['document', 'id_number']
toNotRequired[Literal['document', 'id_number']]
- Change type of
discounts
onstripe.Invoice
andstripe.InvoiceLineItem
fromOptional[List[ExpandableField[Discount]]]
toList[ExpandableField[Discount]]
- Change type of
data
onstripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode.QrCode
fromOptional[str]
tostr
- Change type of
image_url_png
onstripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode.QrCode
fromOptional[str]
tostr
- Change type of
image_url_svg
onstripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode.QrCode
fromOptional[str]
tostr
- Change type of
hosted_instructions_url
onstripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode
fromOptional[str]
tostr
- Change type of
mobile_auth_url
onstripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode
fromOptional[str]
tostr
- Change type of
qr_code
onstripe.PaymentIntent.NextAction.SwishHandleRedirectOrDisplayQrCode
fromOptional[QrCode]
toQrCode
- Add support for
-
#1289 Bump aiohttp from 3.9.0 to 3.9.2
- #1276 Update generated code
- Add support for new resources
Billing.MeterEventAdjustment
,Billing.MeterEvent
, andBilling.Meter
- Add support for
create
,deactivate
,list
,modify
,reactivate
, andretrieve
methods on resourceMeter
- Add support for
create
method on resourcesMeterEventAdjustment
andMeterEvent
- Add support for
amazon_pay_payments
onAccount.Capabilities
,Account.CreateParamsCapabilities
,Account.UpdateParamsCapabilities
,AccountService.CreateParamsCapabilities
, andAccountService.UpdateParamsCapabilities
- Add support for new value
verification_failed_representative_authority
on enumsAccount.FutureRequirements.Error.code
,Account.Requirements.Errors.code
,BankAccount.FutureRequirements.Error.code
,BankAccount.Requirements.Errors.code
,Capability.FutureRequirements.Error.code
,Capability.Requirements.Errors.code
,Person.FutureRequirements.Error.code
,Person.Requirements.Errors.code
, - Add support for
destination_on_behalf_of_charge_management
onAccountSession.Components.PaymentDetails.Features
,AccountSession.Components.Payments.Features
,AccountSession.CreateParamsComponentsPaymentDetailsFeatures
,AccountSession.CreateParamsComponentsPaymentsFeatures
,AccountSessionService.CreateParamsComponentsPaymentDetailsFeatures
andAccountSessionService.CreateParamsComponentsPaymentsFeatures
- Add support for
meter
onPlan.CreateParams
,Plan
,PlanService.CreateParams
,Price.Recurring
,Price.CreateParamsRecurring
,Price.ListParamsRecurring
,PriceService.CreateParamsRecurring
, andPriceService.ListParamsRecurring
- Add support for
mandate
onCharge.PaymentMethodDetails.USBankAccount
,Treasury.InboundTransfer.OriginPaymentMethodDetails.USBankAccount
,Treasury.OutboundPayment.DestinationPaymentMethodDetails.USBankAccount
, andTreasury.OutboundTransfer.DestinationPaymentMethodDetails.USBankAccount
- Add support for
second_line
onIssuing.Card.CreateParams
- Add support for new resources
- #1278 Types: remove unnecessary quotes
- #1279 Update README.md
- #1273 Update generated code
- Add support for new resources
ConfirmationToken
andForwarding.Request
- Add support for
retrieve
method on resourceConfirmationToken
- Add support for
create
,list
, andretrieve
methods on resourceRequest
- Add support for
mobilepay_payments
onAccount.Capabilities
,Account.CreateParamsCapabilities
, andAccount.UpdateParamsCapabilities
- Add support for new values
forwarding_api_inactive
,forwarding_api_invalid_parameter
,forwarding_api_upstream_connection_error
, andforwarding_api_upstream_connection_timeout
on enumsInvoice.LastFinalizationError.code
,PaymentIntent.LastPaymentError.code
,SetupAttempt.SetupError.code
,SetupIntent.LastSetupError.code
, andStripeError.code
- Add support for
payment_reference
onCharge.PaymentMethodDetails.UsBankAccount
- Add support for
payout
onTreasury.ReceivedDebit.LinkedFlows
- Add support for
name
onConfigurationService.CreateParams
,ConfigurationService.UpdateParams
, andConfiguration
for terminal - Add support for
confirmation_token
onPaymentIntentService.ConfirmParams
,PaymentIntentService.CreateParams
,SetupIntentService.ConfirmParams
, andSetupIntentService.CreateParams
- Add support for new value
mobilepay
on enumsCustomer.ListPaymentMethodsParams.type
,PaymentMethod.CreateParams.type
, andPaymentMethod.ListParams.type
- Add support for
mobilepay
onCharge.PaymentMethodDetails
,PaymentIntent.PaymentMethodOptions
,PaymentIntentService.ConfirmParamsPaymentMethodData
,PaymentIntentService.ConfirmParamsPaymentMethodOptions
,PaymentIntentService.CreateParamsPaymentMethodData
,PaymentIntentService.CreateParamsPaymentMethodOptions
,PaymentIntentService.UpdateParamsPaymentMethodData
,PaymentIntentService.UpdateParamsPaymentMethodOptions
,PaymentMethod.CreateParams
,PaymentMethod
,SetupIntentService.ConfirmParamsPaymentMethodData
,SetupIntentService.CreateParamsPaymentMethodData
, andSetupIntentService.UpdateParamsPaymentMethodData
- Add support for new value
mobilepay
on enumsPaymentIntentService.ConfirmParamsPaymentMethodData.type
,PaymentIntentService.CreateParamsPaymentMethodData.type
,PaymentIntentService.UpdateParamsPaymentMethodData.type
,SetupIntentService.ConfirmParamsPaymentMethodData.type
,SetupIntentService.CreateParamsPaymentMethodData.type
, andSetupIntentService.UpdateParamsPaymentMethodData.type
- Add support for new value
mobilepay
on enumPaymentMethod.type
- Add support for new resources
- #1269 Update generated code
- Add support for
personalization_design
on parameter classesCardService.CreateParams
,CardService.ListParams
,CardService.UpdateParams
,stripe.issuing.Card.CreateParams
,stripe.issuing.Card.ListParams
, andstripe.issuing.Card.ModifyParams
and resourcestripe.issuing.Card
- Add support for
sepa_debit
on parameter classesSubscriptionService.CreateParamsPaymentSettingsPaymentMethodOptions
,SubscriptionService.UpdateParamsPaymentSettingsPaymentMethodOptions
,stripe.Subscription.CreateParamsPaymentSettingsPaymentMethodOptions
, andstripe.Subscription.ModifyParamsPaymentSettingsPaymentMethodOptions
and resource classstripe.Subscription.PaymentSettings.PaymentMethodOptions
- Add support for resource
stripe.issuing.PersonalizationDesign
- Add support for resource
stripe.issuing.PhysicalBundle
- Change type from
float
toLiteral['']|float
ofapplication_fee_percent
on fieldsstripe.Subscription.CreateParams
,stripe.Subscription.ModifyParams
,SubscriptionService.UpdateParams
, andSubscriptionService.CreateParams
- Add support for
- #1267 Update generated code
- Add support for
documents
onAccountSession.Components
- Add support for
request_three_d_secure
onCheckout.Session.PaymentMethodOptionsCard
andCheckout.Session.CreateParams.PaymentMethodOptionsCard
- Add support for
created
onCreditNote.ListParams
- Add support for
sepa_debit
onInvoice.PaymentSettings.PaymentMethodOptions
,InvoiceCreateParams.PaymentSettings.PaymentMethodOptions
, andInvoiceUpdateParams.PaymentSettings.PaymentMethodOptions
- Add support for
- #1268 Update README.md
- #1255 Update generated code
- Change
identity.VerificationReport.type
to be required - Change type of
identity.VerificationSession.type
fromOptional[Literal["document", "id_number"]]
toLiteral["document", "id_number"]
- Add support for
number
onInvoice.CreateParams
andInvoice.ModifyParams
- Add support for
enable_customer_cancellation
onterminal.Reader.Action.ProcessPaymentIntent.process_config
,Terminal.Reader.Action.ProcessSetupIntent.process_config
,Terminal.Reader.ProcessPaymentIntentParams.process_config
, andTerminal.Reader.ProcessSetupIntentParams.process_config
- Add support for
refund_payment_config
onTerminal.Reader.Action.refund_payment
andTerminal.Reader.RefundPaymentParams
- Add support for
payment_method
onToken.CreateParams.bank_account
- Add
list_refunds
andretrieve_refund
methods on resourceCharge
.
- Change
- #1260 Update README to use add_beta_version
- #1250 Fix type of ErrorObject.code
- #1241 Update generated code
- Add
InvoiceLineItem.modify
method.
- Add
- #1244 Add TaxIds API
- Add support for
create
,retrieve
,delete
, andlist
methods on resourceTaxId
- The
instance_url
function on resourceTaxId
now returns the top-level/v1/tax_ids/{id}
path instead of the/v1/customers/{customer}/tax_ids/{id}
path.
- Add support for
- #1243 Remove http client base
- #1242 Testing: unify http client mock
- #1230 Update generated code
- Add support for
networks
onCard
,PaymentMethod.CreateParamsCard
,PaymentMethod.ModifyParamsCard
, andToken.CreateParamsCard
- Add support for new value
no_voec
on enumsCheckout.Session.CustomerDetails.TaxId.type
,Invoice.CustomerTaxId.type
,Tax.Calculation.CustomerDetails.TaxId.type
,Tax.Transaction.CustomerDetails.TaxId.type
, andTaxId.type
- Add support for new value
no_voec
on enumsCustomer.CreateParams.tax_id_data[].type
,Invoice.UpcomingLinesParams.customer_details.tax_ids[].type
,Invoice.UpcomingParams.customer_details.tax_ids[].type
, andTax.Calculation.CreateParams.customer_details.tax_ids[].type
- Add support for new value
financial_connections.account.refreshed_ownership
on enumEvent.type
- Add support for
display_brand
onPaymentMethod.card
- Add support for new value
financial_connections.account.refreshed_ownership
on enumsWebhookEndpoint.CreateParams.enabled_events[]
andWebhookEndpoint.UpdateParams.enabled_events[]
- Add support for
- #1237 Remove broken child methods
- Bugfix: remove support for
CreditNoteLineItem.list
,CustomerCashBalanceTransaction.list
, andCustomerCashBalanceTransaction.retrieve
. These methods were included in the library unintentionally and never functioned.
- Bugfix: remove support for
- #1232 Improve types in _http_client.py
- #1225 Update generated code
- Add support for
invoices
onAccount.Settings
- Add support for new value
velobank
on various enumsPaymentMethodDetails.P24.bank
- Add support for
setup_future_usage
onPaymentMethodOptions.Blik
- Add support for
require_cvc_recollection
onPaymentMethodOptions.Card
- Add support for
account_tax_ids
on variousInvoiceSettings
request parameters
- Add support for
- #1223 Move StripeClient usage collection onto StripeService
- #1220 Measure StripeClient usage
- #1213 Update generated code
- Add support for
swish
payment method throughout the API - Add support for
relationship
on parameter classesAccount.CreateParamsIndividual
andToken.CreateParamsAccountIndividual
- Add support for
jurisdiction_level
on resourceTaxRate
- Change type from
str
toLiteral["offline", "online"]
ofstatus
on fieldterminal.Reader
- Add support for
-
#1206 stripe-python v8 release This release introduces
StripeClient
and a service-based call pattern. This new interface allows you to easily call Stripe APIs and has several benefits over the existing resource-based pattern:- No global config: you can simultaneously use multiple clients with different configuration options (such as API keys)
- No static methods for easier mocking
For full migration instructions, please refer to the v8 migration guide.
"
⚠️ " symbol highlights breaking changes⚠️ Request options likeapi_key
,stripe_account
,stripe_version
, andidempotency_key
can no longer be passed in positionally on resource methods. Please pass these in as keyword arguments.
BEFORE
stripe.Customer.create( "sk_test_123", # api key "KG5LxwFBepaKHyUD", # idempotency key "2022-11-15", # stripe version "acct_123", # stripe account )
AFTER
stripe.Customer.create( api_key="sk_test_123", idempotency_key="KG5LxwFBepaKHyUD", stripe_version="2022-11-15", stripe_account="acct_123", )
⚠️ Methods that turn a response stream (Quote.pdf
) now returns a single value of typeStripeResponseStream
instead of a tuple containing(StripeResponseStream, api_key)
.⚠️ Removed public access toAPIRequestor
.APIRequestor
's main use is internal, and we don't have a good understanding of its external use cases. We had to make several breaking changes to its interface as part of this update, so rather than leaving it public we made it private. If you have a use case forAPIRequestor
, please open up a Github issue describing it. We'd rather you rely on something specifically designed for your use case than having to reach into the library's internals.
⚠️ Removeapi_version
fromFile.create
parameters. Please usestripe_version
instead.⚠️ Removeutil.read_special_variable()
utility method (importing directly fromstripe.util
is deprecated as of v7.8.0)⚠️ RemoveStripeError.construct_error_object()
. This method was intended for internal stripe-python use only.⚠️ RemoveListObject.empty_list()
. This method was intended for internal stripe-python use only.⚠️ RemoveSearchResultObject.empty_search_result()
. This method was intended for internal stripe-python use only.⚠️ RemoveStripeObject.ReprJSONEncoder
. This class was intended for internal stripe-python use only.⚠️ RemoveStripeObject.api_base
. This property was defunct and returnedNone
.
- #1199 Update generated code
- Add support for
annual_revenue
andestimated_worker_count
onAccount.business_profile
,Account.CreateParams.business_profile
, andAccount.UpdateParams.business_profile
- Add support for new value
registered_charity
on enumsAccount.CreateParams.company.structure
,Account.UpdateParams.company.structure
, andToken.CreateParams.account.company.structure
- Add support for
collection_options
onAccountLink.CreateParams
- Add support for
liability
onCheckout.Session.automatic_tax
,PaymentLink.automatic_tax
,PaymentLink.CreateParams.automatic_tax
,PaymentLink.UpdateParams.automatic_tax
,Quote.automatic_tax
,Quote.CreateParams.automatic_tax
,Quote.UpdateParams.automatic_tax
,SubscriptionSchedule.default_settings.automatic_tax
,SubscriptionSchedule.phases[].automatic_tax
,SubscriptionSchedule.CreateParams.default_settings.automatic_tax
,SubscriptionSchedule.CreateParams.phases[].automatic_tax
,SubscriptionSchedule.UpdateParams.default_settings.automatic_tax
,SubscriptionSchedule.UpdateParams.phases[].automatic_tax
, andcheckout.Session.CreateParams.automatic_tax
- Add support for
issuer
onCheckout.Session.invoice_creation.invoice_data
,PaymentLink.invoice_creation.invoice_data
,PaymentLink.CreateParams.invoice_creation.invoice_data
,PaymentLink.UpdateParams.invoice_creation.invoice_data
,Quote.invoice_settings
,Quote.CreateParams.invoice_settings
,Quote.UpdateParams.invoice_settings
,SubscriptionSchedule.default_settings.invoice_settings
,SubscriptionSchedule.phases[].invoice_settings
,SubscriptionSchedule.CreateParams.default_settings.invoice_settings
,SubscriptionSchedule.CreateParams.phases[].invoice_settings
,SubscriptionSchedule.UpdateParams.default_settings.invoice_settings
,SubscriptionSchedule.UpdateParams.phases[].invoice_settings
, andcheckout.Session.CreateParams.invoice_creation.invoice_data
- Add support for
invoice_settings
onPaymentLink.subscription_data
,PaymentLink.CreateParams.subscription_data
,PaymentLink.UpdateParams.subscription_data
, andcheckout.Session.CreateParams.subscription_data
- Add support for new value
challenge
on enumsInvoice.CreateParams.payment_settings.payment_method_options.card.request_three_d_secure
,Invoice.UpdateParams.payment_settings.payment_method_options.card.request_three_d_secure
,Subscription.CreateParams.payment_settings.payment_method_options.card.request_three_d_secure
, andSubscription.UpdateParams.payment_settings.payment_method_options.card.request_three_d_secure
- Add support for
promotion_code
onInvoice.UpcomingLinesParams.discounts[]
,Invoice.UpcomingLinesParams.invoice_items[].discounts[]
,Invoice.UpcomingParams.discounts[]
, andInvoice.UpcomingParams.invoice_items[].discounts[]
- Add support for
account_type
onPaymentMethod.UpdateParams.us_bank_account
- Add support for
- #1193 Update generated code
- Add support for providing details about
BankAccount
,Card
, andCardToken
onAccount.CreateExternalAccountParams.external_account
andAccount.CreateParams.external_account
- Add support for new value
nn
on enumsCharge.PaymentMethodDetails.Ideal.bank
,PaymentIntent.ConfirmParamsPaymentMethodDataIdeal.bank
,PaymentIntent.CreateParamsPaymenMethodDataIdeal.bank
,PaymentIntent.UpdateParamsPaymentMethodDataIdeal.bank
,PaymentMethod.Ideal.bank
,PaymentMethod.CreateParamsIdeal.bank
,SetupAttempt.PaymentMethodDetails.Ideal.bank
,SetupIntent.ConfirmParamsPaymenMethodDataIdeal.bank
,SetupIntent.CreateParamsPaymenMethodDataIdeal.bank
, andSetupIntent.UpdateParamsPaymenMethodDataIdeal.bank
- Add support for new value
NNBANL2G
on enumsCharge.PaymentMethodDetails.Ideal.bic
,PaymentMethod.Ideal.bic
, andSetupAttempt.PaymentMethodDetails.Ideal.bic
- Change
CustomerSession.Components.buy_button
andCustomerSession.Components.pricing_table
to be required - Add support for
issuer
onInvoice.CreateParams
,Invoice.UpcomingLinesParams
,Invoice.UpcomingParams
,Invoice.UpdateParams
, andInvoice
- Add support for
liability
onInvoice.automatic_tax
,Invoice.CreateParams.automatic_tax
,Invoice.UpcomingLinesParams.automatic_tax
,Invoice.UpcomingParams.automatic_tax
,Invoice.UpdateParams.automatic_tax
,Subscription.automatic_tax
,Subscription.CreateParams.automatic_tax
, andSubscription.UpdateParams.automatic_tax
- Add support for
on_behalf_of
onInvoice.UpcomingLinesParams
andInvoice.UpcomingParams
- Add support for
pin
onissuing.Card.CreateParams
- Add support for
revocation_reason
onMandate.PaymentMethodDetails.bacs_debit
- Add support for
customer_balance
onPaymentMethodConfiguration.CreateParams
,PaymentMethodConfiguration.UpdateParams
, andPaymentMethodConfiguration
- Add support for
invoice_settings
onSubscription.CreateParams
andSubscription.UpdateParams
- Add support for providing details about
- #1188 Update generated code
- Add support for new resource
CustomerSession
- Add support for
create
method on resourceCustomerSession
- Remove support for values
obligation_inbound
,obligation_payout_failure
,obligation_payout
, andobligation_reversal_outbound
from enumBalanceTransaction.type
- Add support for new values
eps
andp24
on 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_types[]
- Remove support for value
obligation
from enumReporting.ReportRunCreateParams.parameters.reporting_category
- Add support for
billing_cycle_anchor_config
onSubscriptionCreateParams
andSubscription
- Add support for new resource
- #1186 Update generated code
- Add support for
retrieve
on resourcetax.Registration
- Change type from
Optional[PaymentDetails]
toPaymentDetails
ofpayment_details
on fieldAccountSession.Components
- Change type from
Optional[Payments]
toPayments
ofpayments
on fieldAccountSession.Components
- Change type from
Optional[Payouts]
toPayouts
ofpayouts
on fieldAccountSession.Components
- Change type from
Optional[Features]
toFeatures
offeatures
on fieldsAccountSession.Components.PaymentDetails
,AccountSession.Components.Payments
, andAccountSession.Components.Payouts
- Change type from
Optional[InvoiceSettings]
toInvoiceSettings
ofinvoice_settings
on fieldSubscriptionSchedule.DefaultSettings
- Add support for
-
#1176 Update generated code
- Add support for new resource
FinancialConnections.Transaction
- Add support for
list
andretrieve
methods on resourceTransaction
- Add support for
subscribe
andunsubscribe
methods on resourceFinancialConnections.Account
- Add support for
features
onAccountSessionCreateParams.components.payouts
- Add support for
edit_payout_schedule
,instant_payouts
, andstandard_payouts
onAccountSession.components.payouts.features
- Change type of
Checkout.Session.payment_method_options.us_bank_account.financial_connections.prefetch[]
,Checkout.SessionCreateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]
,Invoice.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]
,InvoiceCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]
,InvoiceUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]
,PaymentIntent.payment_method_options.us_bank_account.financial_connections.prefetch[]
,PaymentIntentConfirmParams.payment_method_options.us_bank_account.financial_connections.prefetch[]
,PaymentIntentCreateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]
,PaymentIntentUpdateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]
,SetupIntent.payment_method_options.us_bank_account.financial_connections.prefetch[]
,SetupIntentConfirmParams.payment_method_options.us_bank_account.financial_connections.prefetch[]
,SetupIntentCreateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]
,SetupIntentUpdateParams.payment_method_options.us_bank_account.financial_connections.prefetch[]
,Subscription.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]
,SubscriptionCreateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]
, andSubscriptionUpdateParams.payment_settings.payment_method_options.us_bank_account.financial_connections.prefetch[]
fromliteral('balances')
toenum('balances'|'transactions')
- Add support for new value
financial_connections.account.refreshed_transactions
on enumEvent.type
- Add support for new value
transactions
on enumFinancialConnections.AccountRefreshParams.features[]
- Add support for
subscriptions
andtransaction_refresh
onFinancialConnections.Account
- Add support for
next_refresh_available_at
onFinancialConnections.Account.balance_refresh
- Add support for new value
transactions
on enumsFinancialConnections.Session.prefetch[]
andFinancialConnections.SessionCreateParams.prefetch[]
- Add support for new value
unknown
on enumsIssuing.Authorization.verification_data.authentication_exemption.type
andIssuing.AuthorizationCreateParams.testHelpers.verification_data.authentication_exemption.type
- Add support for new value
challenge
on enumsPaymentIntent.payment_method_options.card.request_three_d_secure
,PaymentIntentConfirmParams.payment_method_options.card.request_three_d_secure
,PaymentIntentCreateParams.payment_method_options.card.request_three_d_secure
,PaymentIntentUpdateParams.payment_method_options.card.request_three_d_secure
,SetupIntent.payment_method_options.card.request_three_d_secure
,SetupIntentConfirmParams.payment_method_options.card.request_three_d_secure
,SetupIntentCreateParams.payment_method_options.card.request_three_d_secure
, andSetupIntentUpdateParams.payment_method_options.card.request_three_d_secure
- Add support for
revolut_pay
onPaymentMethodConfigurationCreateParams
,PaymentMethodConfigurationUpdateParams
, andPaymentMethodConfiguration
- Change type of
Quote.invoice_settings
fromInvoiceSettingQuoteSetting | null
toInvoiceSettingQuoteSetting
- Add support for
destination_details
onRefund
- Add support for new value
financial_connections.account.refreshed_transactions
on enumsWebhookEndpointCreateParams.enabled_events[]
andWebhookEndpointUpdateParams.enabled_events[]
- Add support for new resource
-
#1185 Update generated code
-
#1184 Remove api_base from RequestOptions type
-
#1178 Support accessing reserved word resource properties via attribute
-
#1161 Update generated code
- Add support for
payment_method_reuse_agreement
on resource classesPaymentLink.ConsentCollection
andcheckout.Session.ConsentCollection
and parameter classesPaymentLink.CreateParamsConsentCollection
andcheckout.Session.CreateParamsConsentCollection
- Add support for
after_submit
on parameter classesPaymentLink.CreateParamsCustomText
,PaymentLink.ModifyParamsCustomText
, andcheckout.Session.CreateParamsCustomText
and resource classesPaymentLink.CustomText
andcheckout.Session.CustomText
- Add support for
created
on parameter classradar.EarlyFraudWarning.ListParams
- Add support for
-
#1146 Track usage of deprecated
save
- Reports uses of the deprecated
.save
inX-Stripe-Client-Telemetry
. (You can disable telemetry viastripe.enable_telemetry = false
, see the README.)
- Reports uses of the deprecated
-
#1101 Mark defunct and internal methods as deprecated
-
#1169 Add more types to _http_client.py
- #1168 Do not raise a DeprecationWarning in
stripe.app_info
- #1159 Fix getattr to raise AttributeError rather than returning None. This fixes a regression in 7.8.0 that caused
stripe.checkout
/stripe.issuing
etc. to returnNone
. - #1157 Add missing explicit reexport for
OAuth
,Webhook
,WebhookSignature
- #1155 Update generated code
- Add support for
payment_details
,payments
, andpayouts
onAccountSession.components
andCreateParams.components
- Add support for
features
onAccountSession.components.account_onboarding
andCreateParams.components.account_onboarding
- Add support for new values
customer_tax_location_invalid
andfinancial_connections_no_successful_transaction_refresh
on enumsInvoice.last_finalization_error.code
,PaymentIntent.last_payment_error.code
,SetupAttempt.setup_error.code
,SetupIntent.last_setup_error.code
, andStripeError.code
- Add support for new values
payment_network_reserve_hold
andpayment_network_reserve_release
on enumBalanceTransaction.type
- Change
Climate.Product.metric_tons_available
to be required - Remove support for value
various
from enumClimate.Supplier.removal_pathway
- Remove support for values
challenge_only
andchallenge
from enumPaymentIntent.payment_method_options.card.request_three_d_secure
- Add support for
inactive_message
andrestrictions
onCreateParams
,ModifyParams
, andPaymentLink
- Add support for
transfer_group
onPaymentLink.payment_intent_data
,CreateParams.payment_intent_data
, andModifyParams.payment_intent_data
- Add support for
trial_settings
onPaymentLink.subscription_data
,CreateParams.subscription_data
, andModifyParams.subscription_data
- Add support for
- #1153 Move exports for more modules
stripe.app_info
,stripe.http_client
,stripe.oauth
,stripe.util
,stripe.version
,stripe.webhook
, modules are deprecated. All types are available directly fromstripe
module now. Before:After:from stripe.util import convert_to_stripe_object # or stripe.util.convert_to_stripe_object
from stripe import convert_to_stripe_object # or stripe.convert_to_stripe_object
stripe.api_version
,stripe.multipart_data_generator
,stripe.request_metrics
are deprecated and will be fully removed in the future.
- #1142 Move resource type exports to stripe.___
stripe.error
,stripe.stripe_object
,stripe.api_requestor
,stripe.stripe_response
,stripe.request_options
,stripe.api_resources.*
,stripe.api_resources.abstract.*
modules are deprecated. All types are available directly fromstripe
module now. Before:After:from stripe.error import APIError # or stripe.error.APIError
from stripe import APIError # or stripe.APIError
- #1147 Update generated code
- Add support for new resources
Climate.Order
,Climate.Product
, andClimate.Supplier
- Add support for
cancel
,create
,list
,modify
, andretrieve
methods on resourceOrder
- Add support for
list
andretrieve
methods on resourcesProduct
andSupplier
- Add support for new value
financial_connections_account_inactive
on enumsInvoice.LastFinalizationError.code
,PaymentIntent.LastPaymentError.code
,SetupAttempt.SetupError.code
, andSetupIntent.LastSetupError.code
- Add support for new values
climate_order_purchase
andclimate_order_refund
on enumBalanceTransaction.type
- Add support for
created
onCheckout.Session.ListParams
- Add support for
validate_location
onCustomer.CreateParamsTax
andCustomer.ModifyParamsTax
- Add support for new values
climate.order.canceled
,climate.order.created
,climate.order.delayed
,climate.order.delivered
,climate.order.product_substituted
,climate.product.created
, andclimate.product.pricing_updated
on enumEvent.type
- Add support for new value
challenge
on enumsPaymentIntent. PaymentMethodOptions.Card.request_three_d_secure
andSetupIntent. PaymentMethodOptions.Card.request_three_d_secure
- Add support for new values
climate_order_purchase
andclimate_order_refund
on enumReporting.ReportRun. CreateParamsParameters.reporting_category
- Add support for new values
climate.order.canceled
,climate.order.created
,climate.order.delayed
,climate.order.delivered
,climate.order.product_substituted
,climate.product.created
, andclimate.product.pricing_updated
on enumsWebhookEndpoint.CreateParams.enabled_events[]
andWebhookEndpoint.ModifyParams.enabled_events[]
- Add support for new resources
- #1145 Refactor integration test
- #1138 Update generated code
- Add support for
electronic_commerce_indicator
on resource classesCharge.PaymentMethodDetails.Card.ThreeDSecure
andSetupAttempt.PaymentMethodDetails.Card.ThreeDSecure
- Add support for
exemption_indicator
on resource classCharge.PaymentMethodDetails.Card.ThreeDSecure
- Add support for
transaction_id
on resource classesCharge.PaymentMethodDetails.Card.ThreeDSecure
,SetupAttempt.PaymentMethodDetails.Card.ThreeDSecure
,issuing.Authorization.NetworkData
, andissuing.Transaction.NetworkData
- Add support for
offline
on resource classCharge.PaymentMethodDetails.CardPresent
- Add support for
transferred_to_balance
on resourceCustomerCashBalanceTransaction
- Add support for
three_d_secure
on parameter classesPaymentIntent.ConfirmParamsPaymentMethodOptionsCard
,PaymentIntent.CreateParamsPaymentMethodOptionsCard
,PaymentIntent.ModifyParamsPaymentMethodOptionsCard
,SetupIntent.ConfirmParamsPaymentMethodOptionsCard
,SetupIntent.CreateParamsPaymentMethodOptionsCard
, andSetupIntent.ModifyParamsPaymentMethodOptionsCard
- Add support for
system_trace_audit_number
on resource classissuing.Authorization.NetworkData
- Add support for
network_risk_score
on resource classesissuing.Authorization.PendingRequest
andissuing.Authorization.RequestHistory
- Add support for
requested_at
on resource classissuing.Authorization.RequestHistory
- Add support for
authorization_code
on resource classissuing.Transaction.NetworkData
- Add support for
- #1127 Update generated code
- Add support for
bacs_debit_payments
onAccount.CreateParamsSettings
- Add support for
service_user_number
onAccount.Settings.BacsDebitPayments
- Add support for
capture_before
onCharge.PaymentMethodDetails.Card.capture_before
- Add support for
Paypal
onCheckout.Session.PaymentMethodOptions
- Add support for
tax_amounts
onCreditNote.CreateParamsLine
,CreditNote.PreviewParamsLine
, andCreditNote.PreviewLinesParamsLine
- Add support for
network_data
onIssuing.Transaction
- Add support for
status
onCheckout.Session.ListParams
- Add support for
- #1135 Add initial tests for exports and run them in mypy and pyright
- #1130 Mention types in README.md
- #1134 Run pyright via tox
- #1131 Upgrade black dependency
- #1132 Fix unnecessary casts from pyright 1.1.336
- #1126 Suppress type errors from latest pyright
- #1125 Add support for Python 3.11/3.12
- #1123 Move to python3 venv and update vscode settings
- #1119 Update generated code
- Add support for new value
terminal_reader_hardware_fault
on enumsInvoice.last_finalization_error.code
,PaymentIntent.last_payment_error.code
,SetupAttempt.setup_error.code
,SetupIntent.last_setup_error.code
, andStripeError.code
- Add support for
metadata
onQuote.subscription_data
,QuoteCreateParams.subscription_data
, andQuoteUpdateParams.subscription_data
- Add support for new value
- #1121 [types] Remove
None
from optional param types
- #1112 Update generated code
- Add support for new resource
Tax.Registration
- Add support for
create
,list
, andmodify
methods on resourceRegistration
- Add support for new resource
- #1115 Types: Add types for
ErrorObject
. - #1116 Types: Use @staticmethod overloads instead of @classmethod to fix MyPy compatibility.
- #1104 Include
py.typed
and enable type annotations for the package- This PR includes
py.typed
and enables inline type annotations for stripe-python package. Inline type annotations will now take precedence over Typeshed for users who use a type checker or IDE. - See a detailed guide on the Github Wiki.
- This PR includes
- #1103 Inner resource classes
- Behavior change: nested json objects will now deserialize into instances of specific classes that subclass
StripeObject
, instead of into genericStripeObject
instances. ⚠️ Behavior change:PromotionCode.restrictions.currency_options
will now deserialize intodict
and notStripeObject
.
- Behavior change: nested json objects will now deserialize into instances of specific classes that subclass
- #1090 Update generated code
- Add support for new value
balance_invalid_parameter
on enumsInvoice.LastFinalizationError
,PaymentIntent.LastPaymentError
,SetupAttempt.SetupError
, andSetupIntent.LastSetupError
- Add support for new value
- #1096 Add @util.deprecated decorator and deprecate
save
. - #1091 APIRequestor: don't mutate incoming multipart headers
- This release changes the pinned API version to
2023-10-16
. Please read the API Upgrade Guide and carefully review the API changes before upgradingstripe-python
. - #1085 Update generated code
- Updated pinned API version
- #1065 Update generated code
- Add support for new resource
Issuing.Token
- Add support for
list
,modify
, andretrieve
methods on resourceToken
- Add support for new resource
-
#1056 Update generated code
-
#1055 Partially type resource methods (no **params)
-
#1057 Add optional types to non-required fields
-
#1054 Types: add deleted field
- #1052 Update generated code
- Add support for new resource
PaymentMethodConfiguration
- Add support for
create
,list
,modify
, andretrieve
methods on resourcePaymentMethodConfiguration
- Add support for new resource
- #1047 Update generated code
- Add support for
capture
,create
,expire
,increment
, andreverse
test helper methods on resourceIssuing.Authorization
- Add support for
create_force_capture
,create_unlinked_refund
, andrefund
test helper methods on resourceIssuing.Transaction
- Add support for
- #1049 Types: datetimes to ints, add enum support
- #1030 Explicitly define CRUDL methods in each resource
- #1050 Generate explicit nested resource class methods
- #1033 Update generated code
- Add support for new resource
PaymentMethodDomain
- Add support for
create
,list
,modify
,retrieve
, andvalidate
methods on resourcePaymentMethodDomain
- Add support for new resource
- #1044 Types: ExpandableField
- #1043 Types: ListObject
- #1024 Update generated code
- Add support for new resource
AccountSession
- Add support for
create
method on resourceAccountSession
- Add support for new resource
- #1032 Types for CRUDL methods on parents
-
#1001 #1008 Remove support for Python 2.
- The last version of stripe-python that supports Python 2 is 5.5.0. The Python Software Foundation (PSF) community announced the end of support of Python 2 on 01 January 2020. To continue to get new features and security updates, please make sure to update your Python runtime to Python 3.6+.
-
#987
⚠️ ⚠️ Pin to the latest API version⚠️ ⚠️ In this release, Stripe API Version
2023-08-16
(the latest at time of release) will be sent by default on all requests. The previous default was to use your Stripe account's default API version.To successfully upgrade to stripe-python v6, you must either
-
(Recommended) Upgrade your integration to be compatible with API Version
2023-08-16
.Please read the API Changelog carefully for each API Version from
2023-08-16
back to your Stripe account's default API version. Determine if you are using any of the APIs that have changed in a breaking way, and adjust your integration accordingly. Carefully test your changes with Stripe Test Mode before deploying them to production.You can read the v6 migration guide for more detailed instructions.
-
(Alternative option) Specify a version other than
2023-08-16
when initializingstripe-python
.If you were previously initializing stripe-python without an explicit API Version, you can postpone modifying your integration by specifying a version equal to your Stripe account's default API version. For example:
import stripe stripe.api_key = "sk_test_..." + stripe.api_version = '2020-08-27'
If you were already initializing stripe-python with an explicit API Version, upgrading to v6 will not affect your integration.
Read the v6 migration guide for more details.
Going forward, each major release of this library will be pinned by default to the latest Stripe API Version at the time of release.
That is, instead of upgrading stripe-python and separately upgrading your Stripe API Version through the Stripe Dashboard, whenever you upgrade major versions of stripe-python, you should also upgrade your integration to be compatible with the latest Stripe API version.
-
-
#1013
⚠️ Removed @test_helper decorator- This is technically breaking but unlikely to affect most users.
-
#1015
⚠️ Assert types of pagination responses- Pagination will raise an exception if the API response is not of the correct type. This should never happen in production use but may break tests that use mock data.
- #990 Update generated code
- Add support for new resource
Tax.Settings
- Add support for
modify
andretrieve
methods on resourceSettings
- Add support for new resource
- #951 Update generated code
- Remove support for
create
method on resourceTax.Transaction
- This is not a breaking change, as this method was deprecated before the Tax Transactions API was released in favor of the
create_from_calculation
method.
- This is not a breaking change, as this method was deprecated before the Tax Transactions API was released in favor of the
- Remove support for
- #947 Update generated code
- Add support for new resources
Tax.CalculationLineItem
,Tax.Calculation
,Tax.TransactionLineItem
, andTax.Transaction
- Add support for
create
andlist_line_items
methods on resourceCalculation
- Add support for
create_from_calculation
,create_reversal
,create
,list_line_items
, andretrieve
methods on resourceTransaction
- Add support for new resources
- #924 API Updates
- Add support for
refund_payment
method on resourceTerminal.Reader
- Add support for
- #923 Bugfix: revert "Pass params into logger.{info,debug}"
- #920 API Updates
- Add support for
resume
method on resourceSubscription
- Add support for
- #913 Pass params into logger.{info,debug}
Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the Stripe products, read more at https://stripe.com/docs/upgrades#2022-11-15.
"
-
#895 Next major release changes
-
#889 API Updates
-
#888 Do not run Coveralls if secret token is not available
-
#875 hide misleading ssl security warning in python>=2.7.9
- Dropped support for Python version 3.4 and 3.5 (#881). We now support Python 2.7 or 3.6+.
- Fixed mistyped names for two OAuth exceptions:
UnsupportedGrantTypError
->UnsupportedGrantTypeError
andUnsupportedResponseTypError
->UnsupportedResponseTypeError
(#872).
- Deprecate
save
method on resources (#887). Usemodify
instead.# Before customer = stripe.Customer.retrieve("cus_123") customer.email = "[email protected]" customer.save() # After stripe.Customer.modify("cus_123", email="[email protected]")
- Removed
Orders
resource (#882). - Removed
SKU
resource (#883).
- #877 API Updates
- Add
upcoming_lines
method to theInvoice
resource.
- Add
- #873 Add abstract methods for SearchableAPIResource
- #867 API Updates
- Update links in documentation to be absolute.
- #861 API Updates
- Add support for new resource
CustomerCashBalanceTransaction
- Add support for new resource
- #860 Add a support section to the readme
- #717 Fix test TestCharge.test_is_saveable().
- #855 Fix issue where auto_paging_iter failed on nested list objects.
- #850 Fix incorrect handling of additional request parameters
- Fixes issue where using special parameter like
api_key
,idempotency_key
,stripe_version
,stripe_account
,headers
can cause aReceived unknown parameter error
.
- Fixes issue where using special parameter like
Breaking changes that arose during code generation of the library that we postponed for the next major version. For changes to the SDK, read more detailed description at https://github.com/stripe/stripe-python/wiki/Migration-guide-for-v4. For changes to the Stripe products, read more at https://stripe.com/docs/upgrades#2022-08-01.
"
- #847 API Updates
- #845 Next major release changes
- #836 API Updates. Add Price.create tests.
- #835 API Updates. Use auto-generation for credit_note and invoice methods.
- Removed deprecated
AlipayAccount
,BitcoinReceiver
,BitcoinTransaction
,IssuerFraudRecord
,Recipient
,RecipientTransfer
, andThreeDSecure
classes. - Removed deprecated
Charge.update_dispute
andCharge.close_dispute
methods that were using legacy REST API endpoint. Prefer Dispute.modify and Dispute.close - Removed deprecated
Card.details
method andCardDetails
resource. The REST API endpoint is not longer supported. - Removed the deprecated
Source.source_transactions
method. PreferSubscriptionItem.list_source_transactions
- Removed the deprecated
SubscriptionItem.usage_record_summaries
method. PreferSubscriptionItem.list_usage_record_summaries
- Removed the deprecated
Charge.refund
method. Prefer Refund.create
- To be consistent with other resource methods,
ApplicationFee.refund
returns an instance ofApplicationFee
and doesn't mutate the instance ofApplicationFee
. - To be consistent with other resource methods, the
Customer.delete_discount
no longer resets thediscount
property toNone
and returns the deleted discount instead. If you were relying on this behavior, reset the discount property manually: - The
LineItem
resource now inherits fromStripeObject
as it has no methods of it's own. - To be consistent with other resource methods, the
Subscription.delete_discount
returns an instance of deleted discount and doesn't mutate the instance ofSubscription
. - Update the CA certificate bundle.
- Request sending logic unified across standard and custom methods (#832)
- #831 API Updates
- Add support for
deliver_card
,fail_card
,return_card
, andship_card
test helper methods on resourceIssuing.Card
- Switch from using
instance_url
to computing method path in place for custom methods. - Switch from using explicit class methods for test helpers instead of using meta-programming.
- Add support for
- #824 API Updates
- Add support for
fund_cash_balance
test helper method on resourceCustomer
- Add support for
- #823 Trigger workflows on beta branches
- #818 fix: Update cash balance methods to no longer require nested ID.
- #812 API Updates
- Add support for new resource
Apps.Secret
- Add support for new resource
- #810 API Updates
- Add support for new resources
Treasury.CreditReversal
,Treasury.DebitReversal
,Treasury.FinancialAccountFeatures
,Treasury.FinancialAccount
,Treasury.FlowDetails
,Treasury.InboundTransfer
,Treasury.OutboundPayment
,Treasury.OutboundTransfer
,Treasury.ReceivedCredit
,Treasury.ReceivedDebit
,Treasury.TransactionEntry
, andTreasury.Transaction
- Add support for
retrieve_payment_method
method on resourceCustomer
- Add support for
list_owners
andlist
methods on resourceFinancialConnections.Account
- Add support for new resources
- #719 Set daemon attribute instead of using setDaemon method that was deprecated in Python 3.10
- #767 Bump vendored six to 1.16.0
- #806 Start testing on pypy-3.8
- #811 Add sanitize_id method
- #809 Release of major version v3.0.0. The migration guide contains more information.
(
⚠️ = breaking changes):⚠️ Replace the legacyOrder
API with the newOrder
API.- New methods:
cancel
,list_line_items
,reopen
, andsubmit
- Removed methods:
pay
andreturn_order
- Removed resources:
OrderItem
andOrderReturn
- New methods:
⚠️ Renamefinancial_connections.account.refresh
tofinancial_connections.refresh_account
- Add support for
amount_discount
,amount_tax
, andproduct
onLineItem
- #808 API Updates
- Add support for new resources
FinancialConnections.AccountOwner
,FinancialConnections.AccountOwnership
,FinancialConnections.Account
, andFinancialConnections.Session
- Add support for new resources
- #805 API Updates
- Add support for new resource
CashBalance
- Add support for new resource
- #796 API Updates
- Add support for
expire
test helper method on resourceRefund
- Add support for
- #792 #794 #795 API Updates
- Add support for new resources
FundingInstructions
andTerminal.Configuration
- Add support for new resources
- #791 API Updates
- Add support for
increment_authorization
method on resourcePaymentIntent
- Add support for
- #788 API Updates
- Add support for
apply_customer_balance
method on resourcePaymentIntent
- Add support for
- #785 API Updates
- Add support for
cancel_action
,process_payment_intent
,process_setup_intent
, andset_reader_display
methods on resourceTerminal.Reader
- Add support for
- #783 API Updates
- Add support for Search API
- Add support for
search
method on resourcesCharge
,Customer
,Invoice
,PaymentIntent
,Price
,Product
, andSubscription
- Add support for
- Add support for Search API
- #784 Pin click dependency to 8.0.4 to avoid breakage in black
- #773 Add infrastructure for test-helper methods
- #782 Revert Orders to use qualified name for upload_api_base
- #781 API Updates
- Add support for
cancel
method on resourceRefund
- Add support for
- #777 Add support for SearchResult.
- #774 API Updates
- Add support for new resource
TestHelpers.TestClock
- Add support for new resource
- #771 API Updates
- Add support for
verify_microdeposits
method on resourcesPaymentIntent
andSetupIntent
- Add support for
- #757 Update class custom methods to save list object parameters.
- #756 Introduce custom listing methods on objects.
- #754 Clarify metadata deletion message.
- #748 API Updates
- Add support for new resource
ShippingRate
- Add support for new resource
- #745 API Updates
- Add support for
expire
method on resourceCheckout.Session
- Add support for
- #738 API Updates
- Add support for
list_payment_methods
method on resourceCustomer
- Add support for
- #736 Stop sending raw exception message as part of Stripe user agent.
- #728 API Updates
- Add support for
list_computed_upfront_line_items
method on resourceQuote
- Add support for
- #722 API Updates
- Add support for new
TaxCode
API.
- Add support for new
- #720 Add support for Identity VerificationSession and VerificationReport APIs
- #713 Add support for the Billing Portal Configuration API
- #704 Fix CA bundle path issue
- #698 Fix issue where StripeObjects in lists would not be converted to dicts
- #699 Start testing Python 3.9
- #691 Include the examples in the built sources
- #684 Add support for the Payout Reverse API
- #681 Add support for the
SetupAttempt
resource and List API - 2.52.0 and 2.53.0 were empty releases that contained no additional changes.
- #676 Add support for the Issuing Dispute Submit API
- #669 Add support for the
PromotionCode
resource and APIs
- #665 Support stripe.File.create(stripe_version='...')
- #655 Add support for the
LineItem
resource and APIs
- #652 Add support for the
Price
resource and APIs
- #651 Add support for
billing_portal
namespace andSession
resource and APIs
- #648 Add support for Express links in
authorize_url
forOAuth
- #646 Allow overriding API key in OAuth methods
- #644 Add support for listing Checkout
Session
- #636 Fix uploading files with Unicode names (Python 2.7)
- #635 Update Python API docs inline link
- #631 Update
proxy.py
- #630 Add support for
CreditNote
preview
- #627 Add list_usage_record_summaries and list_source_transactions
- #625 Add support for
Mandate
- #621 Implement support for stripe-should-retry and retry-after headers
- #620 Check that
error
is a dict before trying to use it to create aStripeError
- #614 Use
OrderedDict
to maintain key order in API requests and responses
- #612 Use
ListObject
properties as default values in request methods
- #610 Add support for header parameters in
ListObject
request methods
- #607 Add
SubscriptionItem.create_usage_record
method
- #604 Remove subscription schedule revisions
- This is technically a breaking change. We've chosen to release it as a minor vesion bump because the associated API is unused.
- #601 Add support for passing full objects instead of IDs to custom methods
- #603 Bump vendored six to latest version
- #599 Fix
del
statement to not raiseKeyError
- #595 Listing
BalanceTransaction
objects now uses/v1/balance_transactions
instead of/v1/balance/history
- #592 Fix argument name conflict
- #590 Add support for the
SetupIntent
resource and APIs
- #587 Enable request latency telemetry by default
- #589 Fix support for
CustomerBalanceTransaction
- #564 Add support for
CustomerBalanceTransaction
resource and APIs
- #583 Remove Poetry and reinstate
setup.py
Version 2.29.2 was non-functional due to a bugged version.py
file. This release is identical to 2.29.2 save for the version number.
- #561 Replace pipenv with poetry
- #578 Verify signatures before deserializing events
- #575 Add support for
radar.early_fraud_warning
resource
- #574 Fix a few more code quality issues
- #572 Fix a few code quality issues
- #566 Add support for the
Capability
resource and APIs
- #554 Add support for the
TaxRate
resource and APIs
- #555 Add support for the
TaxId
resource and APIs
- #551 Add support for the
CreditNote
resource and APIs
- #550 Fix encoding of nested parameters in multipart requests
- #543 Add
delete
class method on deletable API resources - #547 Add class methods for all custom API requests (e.g.
Charge.capture
)
- #537 Add support for the
PaymentMethod
resource and APIs - #540 Add support for retrieving a Checkout
Session
- #542 Add support for deleting a Terminal
Location
andReader
- #541 Add
stripe.util.convert_to_dict
method for convertingStripeObject
instances to regulardict
s
- #532 Add support for subscription schedules
- #530 Fix client telemetry implementation
- #534 Fix session initialization for multi-threaded environments
- #531 Make
RequestsClient
thread-safe
- #526 Reuse the default HTTP client by default
- #524 Rename
CheckoutSession
toSession
and move it under thecheckout
namespace. This is a breaking change, but we've reached out to affected merchants and all new merchants would use the new approach.
- #525 Properly serialize
individual
onAccount
objects
- #518 Add configurable telemetry to gather information on client-side request latency
- #510 Add support for Checkout sessions
- #507 Add support for account links
- #503 Add support for providing custom CA certificate bundle
- #500 Add support for
Review
for Radar
- #489 Add support for
ValueList
andValueListItem
for Radar
- #495 Make
StripeResponse
a new-style class
- #483 Add new API endpoints for the
Invoice
resource.
- #491 Bump minimum requests version to 2.20.0 (for CVE-2018-18074)
- #481 Correct behavior of
stripe.max_network_retries
if it's reset after initial use
- #478 Add support for Stripe Terminal
- #477 Rename
FileUpload
toFile
- #470 Add support for automatic network retries
- #469 Add support for reporting resources
- #467 Add support for usage record summaries
- #463 Remove unsupported Bitcoin endpoints (this is technically a breaking change, but we're releasing as a minor version because none of these APIs were usable anyway)
- #456 Add support for Sigma scheduled query run objects
- #455 Add support for Stripe Issuing
- #452 Add
InvoiceLineItem
class
- #450 Internal improvements to
ApiResource.class_url
- #448 Avoid duplicate dependency on
requests
with Python 2.7
- #445 Fix
setup.py
Major version release. List of backwards incompatible changes to watch out for:
- The minimum Python versions are now 2.7 / 3.4. If you're using Python 2.6 or 3.3, consider upgrading to a more recent version.
- Stripe exception classes should now be accessed via
stripe.error
rather than juststripe
- Some older deprecated methods have been removed
- Trying to detach an unattached source will now raise a
stripe.error.InvalidRequestError
exception instead of aNotImplementedError
exception
For more information, check out the migration guide for v2
Pull requests included in this release:
- #385 Drop support for Python 2.6 and 3.3
- #384 Use py.test for tests
- #399 Remove deprecated code
- #402 Remove
util.json
and usejson
module directly everywhere - #403 Update setup.py and test flow
- #410 Use pipenv
- #415 Change exception when detaching unattached sources from
NotImplementedError
tostripe.error.InvalidRequestError
- #441 Better (hopefully) fix for serialization of empty
ListObject
s
- #439 Fix serialization of empty
ListObject
s
- #436 Add support for payment intents
- #437 Add support for
partner_id
instripe.set_app_info()
- #365 Add
__repr__
methods toStripeError
exception classes
- #430 Handle the case where request ID is
None
when formatting errors
- #422 Add
user_mesage
toStripeError
for a way in Python 3 to avoid the "Request req_...:" string normally appended to error messages
- #425 Add support for issuer fraud records
- #421 Add support for flexible billing and usage records
- #401 Drop conditional dependencies that incorrectly led to an added
simplejson
dependency in Python 3+ after switching to universal wheel
- #396 Add support for topups
- #394 Make
last_response
available after callingsave()
- #389 Register unsaved attributes on assignment regardless of new value
- #371 Add accessor
last_response
onStripeObject
for accessing request ID and other metadata
- #382 Add new
IdempotencyError
type
- #378 Log encoded version of parameters instead of raw POST data
- (Accidental no-op release. See 1.75.3.)
- #372 Add only changed values to
_unsaved_values
inStripeObject
- #375 Use a custom JSON encoder to handle
datetime
objects when serializingStripeObject
s
- #369 Make custom actions on various resources (e.g.
Account.reject
) more consistent with other APIs
- #368 Remove API that allowed the creation of new disputes (this was an erroneous addition; it never worked because the API would not allow it)
- #364 Switch to vendored version of the
six
package for compatibility between Python 2 and 3
- #361 Support for exchange rates APIs
- #362 Fix balance transaction and invoice item conversion into
StripeObject
s
- #360 Fix
BytesWarning
being issued on logging in Python 3
- #359 Support for listing source transactions
- #356 Support uploading files with
StringIO
in addition to a file on disk
- #351 Break resource.py module into separate ones for each type of resource
- Classes are still into resource.py for backwards compatibility
- #353 Fix unpickling
StripeObject
in Python 3
- #350 Add static methods to manipulate resources from parent
Account
gains methods for external accounts and login links (e.g..create_account
,create_login_link
)ApplicationFee
gains methods for refundsCustomer
gains methods for sourcesTransfer
gains methods for reversals
- #349 Rename source
delete
todetach
(and deprecate the former)
- Support length reads on list objects
- Handle
bytearray
andbytes
(in addition to string) inWebhook.construct_event
- Add support for passing a
stripe_version
argument to all API requests
- Error when an invalid type (i.e. non-string) passed as an API method argument
- Fix serialization of
items
on Relay order creation and order return
- Add support for
InvalidClientError
OAuth error
- Change serialization of subscription items on update to encoded as an integer-indexed map
pay
on invoice can now take parameter
- Expose
code
onInvalidRequestError
- Add support for ephemeral keys
- Refactor OAuth implementation to have dedicated classes for errors
- Re-use connections with Pycurl
- Fix the pycurl client
- Add
api_key
parameter to webhook'sconstruct_event
- Add support for account login links
- Remove Requests constraint from 1.55.1 now that they've patched (as of 2.14.2)
- Constrain Requests to < 2.13.0 if on setuptools < 18.0.0
- Support for checking webhook signatures
- Add
stripe.set_app_info
for use by plugin creators
- Add support for payouts and recipient transfers
- No-op release: peg test suite to a specific API version
- Support OAuth operations (getting a token and deauthorizing)
- Support for detaching sources from customers
- Accept
session
argument forRequestsClient
- Fix encoding of parameters when fetching upcoming invoices
- Add
Account.modify_external_account
to modify an account in one API call - Add
Customer.modify_source
to modify a source in one API call
- Allow sources to be updated
- Use internal session for Requests for connection pooling
- request logging goes to stderr now
- Logs properly handle unicode
- Format is now the same between logging logs, and console logs
- Add request logging and some mechanisms to enable it when debugging
- Add support for verifying sources
- Add retrieve method for 3-D Secure resources
- Implement copy and deepcopy on StripeObject to fix these operations
- Add
Source
model for generic payment sources
- Return subscription model instance on subscription create/modify
- Add configurable timeout for Requests HTTP library
- Add support for subscription items
- Add proxy support for pycurl, Requests, urlfetch, and urllib2 libraries
- Add support for Apple Pay domains
- Add
ThreeDSecure
model for 3-D secure payments
- Add
update
class method to resources that can be updated
- Add support for returning Relay orders
- Add support for Alipay accounts
- Add support for the new
/v1/subscriptions
endpointstripe.Subscription.retrieve
stripe.Subscription.update
stripe.Subscription.create
stripe.Subscription.list
- Fix bug where file uploads could not be properly listed
- Fix bug where request parameters were not passed between pages with
auto_paging_iter
- Update CA cert bundle for compatibility with OpenSSL versions below 1.0.1
- Fix uploading of binary files in Python 3
- Add
reject
onAccount
to support the new API feature
- Add
CountrySpec
model for looking up country payment information
- Update bundled CA certs
- Add support for deleting Relay products and SKUs
- Add an automatic paginating iterator to lists available via
auto_paging_iter
- List objects are now iterable
- Error messages set to
None
are now handled properly - The
all
method on list objects has been deprecated in favor oflist
- Calls to
instance_url
are now side effect free
- Official Python 3.4 & 3.5 compatibility
- Add configurable HTTP client
- Add ability to delete attributes
- Products, SKUs, Orders resources
- Add support for new 429 rate limit response
- Added refund listing, creation and retrieval
- Fix error handling for Python 2.6
- Managed accounts can now be deleted
- Added dispute listing and retrieval
- Include response headers in exceptions
- Fix saving
additional_owners
on managed accounts
- Fix saving manage accounts
- Pass
stripe_account
to Balance.retrieve
- Added methods for updating and saving arrays of objects
- Added Bitcoin Receiver update and delete methods
- Remove support for top-level bitcoin transactions
- Adding bitcoin receiver and transaction objects
- Adding support for file uploads resource
- Remove redundant manual SSL blacklist preflight check
- Application Fee refunds now a list instead of array
- Add metadata for disputes and refunds
- Remove official support for Python 2.5
- Support for canceling transfers
- Support cards for recipients.
- Disable loading the ssl module on the Google App Engine dev server.
- Use DER encoded certificate for checksumming
- Don't rely on SNI support in integration tests
- Update bundled ca-certificates
- Add certificate blacklist for CVE-2014-0160 mitigation
- Fix syntax errors in setup.py metadata
- Added license and other metadata in setup.py
- Fix
__repr__
in Python 3 - Support pickling of responses
- Added support for multiple subscriptions per customer
- Added extensive unit tests
- Extended functional test coverage
- Refactored code into modules and out of stripe/init.py
- Abstracted http library selection and use from the
APIRequestor
intostripe.http_client
- Refactored
StripeObject
to inherit fromdict
and avoid direct access of__dict__
. - PEP8ified the codebase and enforced with a test.
- Proper encoding of timezone aware datetimes
- The
to_dict
andvalues
methods on resources no longer recursively convert objects to plaindict
s. All resources now inherit fromdict
but are functionally different in that you cannot set a value to an empty string and cannot delete items. - The
previous_metadata
attribute on resources is now protected. - Timezone aware
datetime
objects passed to the API will now be encoded in a way that does not depend on the local system time. If you are passing timezone-aware datetimes to our API and your server time is not already in UTC, this will change the value passed to our API.
- Add stripe.ApplicationFee resource
- Removed incorrect test.
- Add support for metadata.
- Fix issue with support for closing disputes.
- Add support for closing disputes.
- Add stripe.Balance and stripe.BalanceTransaction resources
- Add support for unsetting attributes by setting to None. Setting properties to a blank string is now an error.
- Add support for multiple cards API
- Remove 'id' from the list of permanent attributes
- Support for Python 3 (github issue #32)
- Allow transfers to be creatable
- Add new stripe.Recipient resource
- Add 'id' to the list of permanent attributes
- Add support for passing options when retrieving Stripe objects; e.g., stripe.Charge.retrieve("foo", params={"expand":["customer"]})
- Add support for setting a Stripe API version override
- Update requests version check to work with requests 1.x.x (github issue #24)
- Add support for updating charge disputes
- Add support for creating invoices
- Add support for new invoice lines return format
- Add support for new List objects
- Add update and pay methods for Invoice resource
- Add new stripe.Account resource
- Remove uncaptured_charge tests (this has been deprecated from the API).
- Fix a bug that would cause nested objects to be mis-rendered in str and repr methods (github issues #17, #18)
- Prefer App Engine's urlfetch over requests, as that's the only thing that will work in App Engine's environment. Previously, if requests was available in the App Engine environment, we would attempt to use it.
- Add new delete_discount method to stripe.Customer
- Add new stripe.Transfer resource
- Switch from using HTTP Basic auth to Bearer auth. (Note: Stripe will support Basic auth for the indefinite future, but recommends Bearer auth when possible going forward)
- Numerous test suite improvements
- Parameters with value None are no longer included in API requests