Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion CODEGEN_VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
d59a1f4bdea3032b8e282d40badc032cb021fc60
6012b623b1c09ad54d466947da04511a042ee45a
2 changes: 1 addition & 1 deletion OPENAPI_VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
v2277
v2324
2 changes: 1 addition & 1 deletion stripe/_api_version.py
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# -*- coding: utf-8 -*-
# File generated from our OpenAPI spec
class _ApiVersion:
CURRENT = "2026-05-27.dahlia"
CURRENT = "2026-06-24.dahlia"
CURRENT_MAJOR = "dahlia"
11 changes: 6 additions & 5 deletions stripe/_balance_transaction.py
Original file line number Diff line number Diff line change
Expand Up @@ -195,6 +195,7 @@ class FeeDetail(StripeObject):
"stripe_fee",
"stripe_fx_fee",
"tax_fee",
"tax_fund",
"topup",
"topup_reversal",
"transfer",
Expand All @@ -203,17 +204,17 @@ class FeeDetail(StripeObject):
"transfer_refund",
]
"""
Transaction type: `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `climate_order_purchase`, `climate_order_refund`, `connect_collection_transfer`, `contribution`, `inbound_transfer`, `inbound_transfer_reversal`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `obligation_outbound`, `obligation_reversal_inbound`, `payment`, `payment_failure_refund`, `payment_network_reserve_hold`, `payment_network_reserve_release`, `payment_refund`, `payment_reversal`, `payment_unreconciled`, `payout`, `payout_cancel`, `payout_failure`, `payout_minimum_balance_hold`, `payout_minimum_balance_release`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `reserve_hold`, `reserve_release`, `stripe_fee`, `stripe_fx_fee`, `stripe_balance_payment_debit`, `stripe_balance_payment_debit_reversal`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, `transfer_refund`, or `fee_credit_funding`. Learn more about [balance transaction types and what they represent](https://stripe.com/docs/reports/balance-transaction-types). To classify transactions for accounting purposes, consider `reporting_category` instead.
Transaction type: `tax_fund`, `adjustment`, `advance`, `advance_funding`, `anticipation_repayment`, `application_fee`, `application_fee_refund`, `charge`, `climate_order_purchase`, `climate_order_refund`, `connect_collection_transfer`, `contribution`, `inbound_transfer`, `inbound_transfer_reversal`, `issuing_authorization_hold`, `issuing_authorization_release`, `issuing_dispute`, `issuing_transaction`, `obligation_outbound`, `obligation_reversal_inbound`, `payment`, `payment_failure_refund`, `payment_network_reserve_hold`, `payment_network_reserve_release`, `payment_refund`, `payment_reversal`, `payment_unreconciled`, `payout`, `payout_cancel`, `payout_failure`, `payout_minimum_balance_hold`, `payout_minimum_balance_release`, `refund`, `refund_failure`, `reserve_transaction`, `reserved_funds`, `reserve_hold`, `reserve_release`, `stripe_fee`, `stripe_fx_fee`, `stripe_balance_payment_debit`, `stripe_balance_payment_debit_reversal`, `tax_fee`, `topup`, `topup_reversal`, `transfer`, `transfer_cancel`, `transfer_failure`, `transfer_refund`, or `fee_credit_funding`. Learn more about [balance transaction types and what they represent](https://stripe.com/docs/reports/balance-transaction-types). To classify transactions for accounting purposes, consider `reporting_category` instead.
"""

@classmethod
def list(
cls, **params: Unpack["BalanceTransactionListParams"]
) -> ListObject["BalanceTransaction"]:
"""
Returns a list of transactions that have contributed to the Stripe account balance (e.g., charges, transfers, and so forth). The transactions are returned in sorted order, with the most recent transactions appearing first.
Returns a list of transactions that have contributed to the Stripe account balance (for example, charges, transfers, and so on). The transactions return in sorted order, with the most recent transactions appearing first.

Note that this endpoint was previously called “Balance history” and used the path /v1/balance/history.
The previous name of this endpoint was “Balance history,” and it used the path /v1/balance/history.
"""
result = cls._static_request(
"get",
Expand All @@ -233,9 +234,9 @@ async def list_async(
cls, **params: Unpack["BalanceTransactionListParams"]
) -> ListObject["BalanceTransaction"]:
"""
Returns a list of transactions that have contributed to the Stripe account balance (e.g., charges, transfers, and so forth). The transactions are returned in sorted order, with the most recent transactions appearing first.
Returns a list of transactions that have contributed to the Stripe account balance (for example, charges, transfers, and so on). The transactions return in sorted order, with the most recent transactions appearing first.

Note that this endpoint was previously called “Balance history” and used the path /v1/balance/history.
The previous name of this endpoint was “Balance history,” and it used the path /v1/balance/history.
"""
result = await cls._static_request_async(
"get",
Expand Down
8 changes: 4 additions & 4 deletions stripe/_balance_transaction_service.py
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,9 @@ def list(
options: Optional["RequestOptions"] = None,
) -> "ListObject[BalanceTransaction]":
"""
Returns a list of transactions that have contributed to the Stripe account balance (e.g., charges, transfers, and so forth). The transactions are returned in sorted order, with the most recent transactions appearing first.
Returns a list of transactions that have contributed to the Stripe account balance (for example, charges, transfers, and so on). The transactions return in sorted order, with the most recent transactions appearing first.

Note that this endpoint was previously called “Balance history” and used the path /v1/balance/history.
The previous name of this endpoint was “Balance history,” and it used the path /v1/balance/history.
"""
return cast(
"ListObject[BalanceTransaction]",
Expand All @@ -45,9 +45,9 @@ async def list_async(
options: Optional["RequestOptions"] = None,
) -> "ListObject[BalanceTransaction]":
"""
Returns a list of transactions that have contributed to the Stripe account balance (e.g., charges, transfers, and so forth). The transactions are returned in sorted order, with the most recent transactions appearing first.
Returns a list of transactions that have contributed to the Stripe account balance (for example, charges, transfers, and so on). The transactions return in sorted order, with the most recent transactions appearing first.

Note that this endpoint was previously called “Balance history” and used the path /v1/balance/history.
The previous name of this endpoint was “Balance history,” and it used the path /v1/balance/history.
"""
return cast(
"ListObject[BalanceTransaction]",
Expand Down
20 changes: 18 additions & 2 deletions stripe/_charge.py
Original file line number Diff line number Diff line change
Expand Up @@ -457,6 +457,10 @@ class Billie(StripeObject):
"""

class Bizum(StripeObject):
buyer_id: Optional[str]
"""
A unique identifier for the buyer as determined by the local payment processor.
"""
transaction_id: Optional[str]
"""
The Bizum transaction ID associated with this payment.
Expand Down Expand Up @@ -902,6 +906,10 @@ class ShippingAddress(StripeObject):
"""
Populated if this transaction used 3D Secure authentication.
"""
transaction_link_id: Optional[str]
"""
Transaction Link ID (TLID) is a unique identifier for a transaction. This is used by some card networks, such as Mastercard, for transaction linking, in addition to Network Transaction IDs. This value will be present if it is returned by the financial network in the authorization response, and null otherwise.
"""
wallet: Optional[Wallet]
"""
If this Card is part of a card wallet, this contains the details of the card wallet.
Expand Down Expand Up @@ -1118,13 +1126,17 @@ class Crypto(StripeObject):
The wallet address of the customer.
"""
network: Optional[
Literal["base", "ethereum", "polygon", "solana", "tempo"]
Literal[
"base", "ethereum", "polygon", "solana", "sui", "tempo"
]
]
"""
The blockchain network that the transaction was sent on.
"""
token_currency: Optional[
Literal["phantom_cash", "usdc", "usdg", "usdp", "usdt"]
Literal[
"phantom_cash", "usdc", "usdg", "usdp", "usdsui", "usdt"
]
]
"""
The token currency that the transaction was sent with.
Expand Down Expand Up @@ -1793,6 +1805,10 @@ class Pix(StripeObject):
"""
Unique transaction id generated by BCB
"""
fingerprint: Optional[str]
"""
Uniquely identifies this particular Pix account. You can use this attribute to check whether two Pix accounts are the same.
"""
mandate: Optional[str]
"""
ID of the multi use Mandate generated by the PaymentIntent
Expand Down
15 changes: 12 additions & 3 deletions stripe/_confirmation_token.py
Original file line number Diff line number Diff line change
Expand Up @@ -219,10 +219,16 @@ class Address(StripeObject):
_inner_class_types = {"address": Address}

class Bizum(StripeObject):
pass
buyer_id: Optional[str]
"""
A unique identifier for the buyer as determined by the local payment processor.
"""

class Blik(StripeObject):
pass
buyer_id: Optional[str]
"""
A unique and immutable identifier assigned by BLIK to every buyer.
"""

class Boleto(StripeObject):
tax_id: str
Expand Down Expand Up @@ -1278,7 +1284,10 @@ class Payto(StripeObject):
"""

class Pix(StripeObject):
pass
fingerprint: Optional[str]
"""
Uniquely identifies this particular Pix account. You can use this attribute to check whether two Pix accounts are the same.
"""

class Promptpay(StripeObject):
pass
Expand Down
4 changes: 4 additions & 0 deletions stripe/_credit_note.py
Original file line number Diff line number Diff line change
Expand Up @@ -388,6 +388,8 @@ def create(

You may issue multiple credit notes for an invoice. Each credit note may increment the invoice's pre_payment_credit_notes_amount,
post_payment_credit_notes_amount, or both, depending on the invoice's amount_remaining at the time of credit note creation.

For invoices that also have refunds created through the [Refund API](https://docs.stripe.com/docs/api/refunds), the credit note API subtracts those refund amounts from the maximum creditable amount. This prevents the combined credit notes and refunds from exceeding the invoice amount. If you use both, ensure the combined total does not exceed the invoice's paid amount.
"""
return cast(
"CreditNote",
Expand Down Expand Up @@ -416,6 +418,8 @@ async def create_async(

You may issue multiple credit notes for an invoice. Each credit note may increment the invoice's pre_payment_credit_notes_amount,
post_payment_credit_notes_amount, or both, depending on the invoice's amount_remaining at the time of credit note creation.

For invoices that also have refunds created through the [Refund API](https://docs.stripe.com/docs/api/refunds), the credit note API subtracts those refund amounts from the maximum creditable amount. This prevents the combined credit notes and refunds from exceeding the invoice amount. If you use both, ensure the combined total does not exceed the invoice's paid amount.
"""
return cast(
"CreditNote",
Expand Down
4 changes: 4 additions & 0 deletions stripe/_credit_note_service.py
Original file line number Diff line number Diff line change
Expand Up @@ -119,6 +119,8 @@ def create(

You may issue multiple credit notes for an invoice. Each credit note may increment the invoice's pre_payment_credit_notes_amount,
post_payment_credit_notes_amount, or both, depending on the invoice's amount_remaining at the time of credit note creation.

For invoices that also have refunds created through the [Refund API](https://docs.stripe.com/docs/api/refunds), the credit note API subtracts those refund amounts from the maximum creditable amount. This prevents the combined credit notes and refunds from exceeding the invoice amount. If you use both, ensure the combined total does not exceed the invoice's paid amount.
"""
return cast(
"CreditNote",
Expand Down Expand Up @@ -150,6 +152,8 @@ async def create_async(

You may issue multiple credit notes for an invoice. Each credit note may increment the invoice's pre_payment_credit_notes_amount,
post_payment_credit_notes_amount, or both, depending on the invoice's amount_remaining at the time of credit note creation.

For invoices that also have refunds created through the [Refund API](https://docs.stripe.com/docs/api/refunds), the credit note API subtracts those refund amounts from the maximum creditable amount. This prevents the combined credit notes and refunds from exceeding the invoice amount. If you use both, ensure the combined total does not exceed the invoice's paid amount.
"""
return cast(
"CreditNote",
Expand Down
24 changes: 23 additions & 1 deletion stripe/_dispute.py
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,12 @@ class Dispute(

class Evidence(StripeObject):
class EnhancedEvidence(StripeObject):
class MastercardCompliance(StripeObject):
fee_acknowledged: bool
"""
A field acknowledging the fee incurred when countering a Mastercard compliance dispute. If this field is set to true, evidence can be submitted for the compliance dispute.
"""

class VisaCompellingEvidence3(StripeObject):
class DisputedTransaction(StripeObject):
class ShippingAddress(StripeObject):
Expand Down Expand Up @@ -179,9 +185,11 @@ class VisaCompliance(StripeObject):
A field acknowledging the fee incurred when countering a Visa compliance dispute. If this field is set to true, evidence can be submitted for the compliance dispute. Stripe collects a 500 USD (or local equivalent) amount to cover the network costs associated with resolving compliance disputes. Stripe refunds the 500 USD network fee if you win the dispute.
"""

mastercard_compliance: Optional[MastercardCompliance]
visa_compelling_evidence_3: Optional[VisaCompellingEvidence3]
visa_compliance: Optional[VisaCompliance]
_inner_class_types = {
"mastercard_compliance": MastercardCompliance,
"visa_compelling_evidence_3": VisaCompellingEvidence3,
"visa_compliance": VisaCompliance,
}
Expand Down Expand Up @@ -299,6 +307,14 @@ class VisaCompliance(StripeObject):

class EvidenceDetails(StripeObject):
class EnhancedEligibility(StripeObject):
class MastercardCompliance(StripeObject):
status: Literal[
"fee_acknowledged", "requires_fee_acknowledgement"
]
"""
Mastercard compliance eligibility status.
"""

class VisaCompellingEvidence3(StripeObject):
required_actions: List[
Literal[
Expand Down Expand Up @@ -327,9 +343,11 @@ class VisaCompliance(StripeObject):
Visa compliance eligibility status.
"""

mastercard_compliance: Optional[MastercardCompliance]
visa_compelling_evidence_3: Optional[VisaCompellingEvidence3]
visa_compliance: Optional[VisaCompliance]
_inner_class_types = {
"mastercard_compliance": MastercardCompliance,
"visa_compelling_evidence_3": VisaCompellingEvidence3,
"visa_compliance": VisaCompliance,
}
Expand Down Expand Up @@ -432,7 +450,11 @@ class Paypal(StripeObject):
Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
"""
enhanced_eligibility_types: List[
Literal["visa_compelling_evidence_3", "visa_compliance"]
Literal[
"mastercard_compliance",
"visa_compelling_evidence_3",
"visa_compliance",
]
]
"""
List of eligibility types that are included in `enhanced_evidence`.
Expand Down
12 changes: 6 additions & 6 deletions stripe/_event.py
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,13 @@ class Request(StripeObject):
"balance.available",
"balance_settings.updated",
"billing.alert.triggered",
"billing.credit_balance_transaction.created",
"billing.credit_grant.created",
"billing.credit_grant.updated",
"billing.meter.created",
"billing.meter.deactivated",
"billing.meter.reactivated",
"billing.meter.updated",
"billing_portal.configuration.created",
"billing_portal.configuration.updated",
"billing_portal.session.created",
Expand Down Expand Up @@ -347,12 +353,6 @@ class Request(StripeObject):
"treasury.received_credit.failed",
"treasury.received_credit.succeeded",
"treasury.received_debit.created",
"billing.credit_balance_transaction.created",
"billing.credit_grant.updated",
"billing.meter.created",
"billing.meter.deactivated",
"billing.meter.reactivated",
"billing.meter.updated",
]
"""
Description of the event (for example, `invoice.created` or `charge.refunded`).
Expand Down
6 changes: 6 additions & 0 deletions stripe/_invoice.py
Original file line number Diff line number Diff line change
Expand Up @@ -427,6 +427,7 @@ class LastFinalizationError(StripeObject):
"alipay_upgrade_required",
"amount_too_large",
"amount_too_small",
"anomalous_money_movement_request",
"api_key_expired",
"application_fees_not_allowed",
"approval_required",
Expand Down Expand Up @@ -466,6 +467,10 @@ class LastFinalizationError(StripeObject):
"debit_not_authorized",
"email_invalid",
"expired_card",
"failed_tax_calculation",
"financial_account_balance_does_not_support_currency",
"financial_account_capability_not_enabled",
"financial_account_capability_restricted",
"financial_connections_account_inactive",
"financial_connections_account_pending_account_numbers",
"financial_connections_account_unavailable_account_numbers",
Expand Down Expand Up @@ -1016,6 +1021,7 @@ class Filters(StripeObject):
"pix",
"promptpay",
"revolut_pay",
"satispay",
"sepa_credit_transfer",
"sepa_debit",
"sofort",
Expand Down
Loading
Loading