From 8c3b75964ddc8f6d4d6023ba7440ce2fdc1db9ec Mon Sep 17 00:00:00 2001 From: Stripe OpenAPI <105521251+stripe-openapi[bot]@users.noreply.github.com> Date: Tue, 26 Nov 2024 15:12:54 +0000 Subject: [PATCH 1/3] Update generated code for v1380 --- OPENAPI_VERSION | 2 +- lib/Billing/CreditGrant.php | 2 +- lib/Billing/Meter.php | 2 +- lib/Billing/MeterEvent.php | 3 +-- lib/Service/Billing/MeterService.php | 6 ++++-- 5 files changed, 8 insertions(+), 7 deletions(-) diff --git a/OPENAPI_VERSION b/OPENAPI_VERSION index 038066775..8486b1411 100644 --- a/OPENAPI_VERSION +++ b/OPENAPI_VERSION @@ -1 +1 @@ -v1370 \ No newline at end of file +v1380 \ No newline at end of file diff --git a/lib/Billing/CreditGrant.php b/lib/Billing/CreditGrant.php index fcafea33b..bcc274467 100644 --- a/lib/Billing/CreditGrant.php +++ b/lib/Billing/CreditGrant.php @@ -16,7 +16,7 @@ * @property string $category The category of this credit grant. This is for tracking purposes and isn't displayed to the customer. * @property int $created Time at which the object was created. Measured in seconds since the Unix epoch. * @property string|\Stripe\Customer $customer ID of the customer receiving the billing credits. - * @property null|int $effective_at The time when the billing credits become effective—when they're eligible for use. + * @property null|int $effective_at The time when the billing credits become effective-when they're eligible for use. * @property null|int $expires_at The time when the billing credits expire. If not present, the billing credits don't expire. * @property bool $livemode Has the value true if the object exists in live mode or the value false if the object exists in test mode. * @property \Stripe\StripeObject $metadata Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. diff --git a/lib/Billing/Meter.php b/lib/Billing/Meter.php index 7cee9d347..1e0080a93 100644 --- a/lib/Billing/Meter.php +++ b/lib/Billing/Meter.php @@ -5,7 +5,7 @@ namespace Stripe\Billing; /** - * A billing meter is a resource that allows you to track usage of a particular event. For example, you might create a billing meter to track the number of API calls made by a particular user. You can then attach the billing meter to a price and attach the price to a subscription to charge the user for the number of API calls they make. + * Meters specify how to aggregate meter events over a billing period. Meter events represent the actions that customers take in your system. Meters attach to prices and form the basis of the bill. * * Related guide: Usage based billing * diff --git a/lib/Billing/MeterEvent.php b/lib/Billing/MeterEvent.php index 8d93eb93e..d0ff22c15 100644 --- a/lib/Billing/MeterEvent.php +++ b/lib/Billing/MeterEvent.php @@ -5,8 +5,7 @@ namespace Stripe\Billing; /** - * A billing meter event represents a customer's usage of a product. Meter events are used to bill a customer based on their usage. - * Meter events are associated with billing meters, which define the shape of the event's payload and how those events are aggregated for billing. + * Meter events represent actions that customers take in your system. You can use meter events to bill a customer based on their usage. Meter events are associated with billing meters, which define both the contents of the event’s payload and how to aggregate those events. * * @property string $object String representing the object's type. Objects of the same type share the same value. * @property int $created Time at which the object was created. Measured in seconds since the Unix epoch. diff --git a/lib/Service/Billing/MeterService.php b/lib/Service/Billing/MeterService.php index 2375a5d43..7defce8cc 100644 --- a/lib/Service/Billing/MeterService.php +++ b/lib/Service/Billing/MeterService.php @@ -57,7 +57,8 @@ public function create($params = null, $opts = null) } /** - * Deactivates a billing meter. + * When a meter is deactivated, no more meter events will be accepted for this + * meter. You can’t attach a deactivated meter to a price. * * @param string $id * @param null|array $params @@ -73,7 +74,8 @@ public function deactivate($id, $params = null, $opts = null) } /** - * Reactivates a billing meter. + * When a meter is reactivated, events for this meter can be accepted and you can + * attach the meter to a price. * * @param string $id * @param null|array $params From 36b4c33b62a6d9e6546040a6c93b3968757edd71 Mon Sep 17 00:00:00 2001 From: Stripe OpenAPI <105521251+stripe-openapi[bot]@users.noreply.github.com> Date: Wed, 4 Dec 2024 17:34:55 +0000 Subject: [PATCH 2/3] Update generated code for v1382 --- OPENAPI_VERSION | 2 +- lib/Checkout/Session.php | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/OPENAPI_VERSION b/OPENAPI_VERSION index 8486b1411..ace8cd10c 100644 --- a/OPENAPI_VERSION +++ b/OPENAPI_VERSION @@ -1 +1 @@ -v1380 \ No newline at end of file +v1382 \ No newline at end of file diff --git a/lib/Checkout/Session.php b/lib/Checkout/Session.php index b7d7d64bc..ad7085512 100644 --- a/lib/Checkout/Session.php +++ b/lib/Checkout/Session.php @@ -31,7 +31,7 @@ * @property null|string $billing_address_collection Describes whether Checkout should collect the customer's billing address. Defaults to auto. * @property null|string $cancel_url If set, Checkout displays a back button and customers will be directed to this URL if they decide to cancel payment and return to your website. * @property null|string $client_reference_id A unique string to reference the Checkout Session. This can be a customer ID, a cart ID, or similar, and can be used to reconcile the Session with your internal systems. - * @property null|string $client_secret The client secret of the Session. Use this with initCustomCheckout on your front end. + * @property null|string $client_secret The client secret of the Session. Use this with initCheckout on your front end. * @property null|\Stripe\StripeObject $collected_information Information about the customer collected within the Checkout Session. * @property null|\Stripe\StripeObject $consent Results of consent_collection for this session. * @property null|\Stripe\StripeObject $consent_collection When set, provides configuration for the Checkout Session to gather active consent from customers. From a13215b6e4eabd9aebc78b91a6cfd0465985f788 Mon Sep 17 00:00:00 2001 From: Stripe OpenAPI <105521251+stripe-openapi[bot]@users.noreply.github.com> Date: Thu, 5 Dec 2024 03:54:19 +0000 Subject: [PATCH 3/3] Update generated code for v1383 --- OPENAPI_VERSION | 2 +- lib/BalanceTransaction.php | 4 +++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/OPENAPI_VERSION b/OPENAPI_VERSION index ace8cd10c..4263345a2 100644 --- a/OPENAPI_VERSION +++ b/OPENAPI_VERSION @@ -1 +1 @@ -v1382 \ No newline at end of file +v1383 \ No newline at end of file diff --git a/lib/BalanceTransaction.php b/lib/BalanceTransaction.php index 5691d9573..b83ef7675 100644 --- a/lib/BalanceTransaction.php +++ b/lib/BalanceTransaction.php @@ -24,7 +24,7 @@ * @property string $reporting_category Learn more about how reporting categories can help you understand balance transactions from an accounting perspective. * @property null|string|\Stripe\ApplicationFee|\Stripe\ApplicationFeeRefund|\Stripe\Charge|\Stripe\ConnectCollectionTransfer|\Stripe\CustomerCashBalanceTransaction|\Stripe\Dispute|\Stripe\Issuing\Authorization|\Stripe\Issuing\Dispute|\Stripe\Issuing\Transaction|\Stripe\Payout|\Stripe\Refund|\Stripe\ReserveTransaction|\Stripe\TaxDeductedAtSource|\Stripe\Topup|\Stripe\Transfer|\Stripe\TransferReversal $source This transaction relates to the Stripe object. * @property string $status The transaction's net funds status in the Stripe balance, which are either available or pending. - * @property string $type Transaction type: adjustment, advance, advance_funding, anticipation_repayment, application_fee, application_fee_refund, charge, climate_order_purchase, climate_order_refund, connect_collection_transfer, contribution, 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, refund, refund_failure, reserve_transaction, reserved_funds, stripe_fee, stripe_fx_fee, tax_fee, topup, topup_reversal, transfer, transfer_cancel, transfer_failure, or transfer_refund. Learn more about balance transaction types and what they represent. To classify transactions for accounting purposes, consider reporting_category instead. + * @property string $type Transaction type: adjustment, advance, advance_funding, anticipation_repayment, application_fee, application_fee_refund, charge, climate_order_purchase, climate_order_refund, connect_collection_transfer, contribution, 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, stripe_fee, stripe_fx_fee, tax_fee, topup, topup_reversal, transfer, transfer_cancel, transfer_failure, or transfer_refund. Learn more about balance transaction types and what they represent. To classify transactions for accounting purposes, consider reporting_category instead. */ class BalanceTransaction extends ApiResource { @@ -57,6 +57,8 @@ class BalanceTransaction extends ApiResource const TYPE_PAYOUT = 'payout'; const TYPE_PAYOUT_CANCEL = 'payout_cancel'; const TYPE_PAYOUT_FAILURE = 'payout_failure'; + const TYPE_PAYOUT_MINIMUM_BALANCE_HOLD = 'payout_minimum_balance_hold'; + const TYPE_PAYOUT_MINIMUM_BALANCE_RELEASE = 'payout_minimum_balance_release'; const TYPE_REFUND = 'refund'; const TYPE_REFUND_FAILURE = 'refund_failure'; const TYPE_RESERVED_FUNDS = 'reserved_funds';