Skip to content

Commit a9caab1

Browse files
authored
[9.x] Improve wording for subscriptions with multiple products (laravel#8091)
* Update billing.md * Update billing.md
1 parent e49a672 commit a9caab1

File tree

1 file changed

+12
-12
lines changed

1 file changed

+12
-12
lines changed

billing.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@
3131
- [Checking Subscription Status](#checking-subscription-status)
3232
- [Changing Prices](#changing-prices)
3333
- [Subscription Quantity](#subscription-quantity)
34-
- [Multiprice Subscriptions](#multiprice-subscriptions)
34+
- [Subscriptions With Multiple Products](#subscriptions-with-multiple-products)
3535
- [Metered Billing](#metered-billing)
3636
- [Subscription Taxes](#subscription-taxes)
3737
- [Subscription Anchor Date](#subscription-anchor-date)
@@ -955,19 +955,19 @@ The `noProrate` method may be used to update the subscription's quantity without
955955

956956
For more information on subscription quantities, consult the [Stripe documentation](https://stripe.com/docs/subscriptions/quantities).
957957

958-
<a name="multiprice-subscription-quantities"></a>
959-
#### Multiprice Subscription Quantities
958+
<a name="quantities-for-subscription-with-multiple-products"></a>
959+
#### Quantities For Subscriptions With Multiple Products
960960

961-
If your subscription is a [multiprice subscription](#multiprice-subscriptions), you should pass the name of the price whose quantity you wish to increment or decrement as the second argument to the increment / decrement methods:
961+
If your subscription is a [subscription with multiple products](#subscriptions-with-multiple-products), you should pass the ID of the price whose quantity you wish to increment or decrement as the second argument to the increment / decrement methods:
962962

963963
$user->subscription('default')->incrementQuantity(1, 'price_chat');
964964

965-
<a name="multiprice-subscriptions"></a>
966-
### Multiprice Subscriptions
965+
<a name="subscriptions-with-multiple-products"></a>
966+
### Subscriptions With Multiple Products
967967

968-
[Multiprice subscriptions](https://stripe.com/docs/billing/subscriptions/multiple-products) allow you to assign multiple billing prices to a single subscription. For example, imagine you are building a customer service "helpdesk" application that has a base subscription price of $10 per month but offers a live chat add-on price for an additional $15 per month. Multiprice subscription information is stored in Cashier's `subscription_items` database table.
968+
[Subscription with multiple products](https://stripe.com/docs/billing/subscriptions/multiple-products) allow you to assign multiple billing products to a single subscription. For example, imagine you are building a customer service "helpdesk" application that has a base subscription price of $10 per month but offers a live chat add-on product for an additional $15 per month. Information for subscriptions with multiple products is stored in Cashier's `subscription_items` database table.
969969

970-
You may specify multiple prices for a given subscription by passing an array of prices as the second argument to the `newSubscription` method:
970+
You may specify multiple products for a given subscription by passing an array of prices as the second argument to the `newSubscription` method:
971971

972972
use Illuminate\Http\Request;
973973

@@ -1013,7 +1013,7 @@ You may remove prices from subscriptions using the `removePrice` method:
10131013
<a name="swapping-prices"></a>
10141014
#### Swapping Prices
10151015

1016-
You may also change the prices attached to a multiprice subscription. For example, imagine a customer has a `price_basic` subscription with a `price_chat` add-on price and you want to upgrade the customer from the `price_basic` to the `price_pro` price:
1016+
You may also change the prices attached to a subscription with multiple products. For example, imagine a customer has a `price_basic` subscription with a `price_chat` add-on product and you want to upgrade the customer from the `price_basic` to the `price_pro` price:
10171017

10181018
use App\Models\User;
10191019

@@ -1043,7 +1043,7 @@ If you want to swap a single price on a subscription, you may do so using the `s
10431043
<a name="proration"></a>
10441044
#### Proration
10451045

1046-
By default, Stripe will prorate charges when adding or removing prices from a multiprice subscription. If you would like to make a price adjustment without proration, you should chain the `noProrate` method onto your price operation:
1046+
By default, Stripe will prorate charges when adding or removing prices from a subscription with multiple products. If you would like to make a price adjustment without proration, you should chain the `noProrate` method onto your price operation:
10471047

10481048
$user->subscription('default')->noProrate()->removePrice('price_chat');
10491049

@@ -1182,7 +1182,7 @@ To specify the tax rates a user pays on a subscription, you should implement the
11821182

11831183
The `taxRates` method enables you to apply a tax rate on a customer-by-customer basis, which may be helpful for a user base that spans multiple countries and tax rates.
11841184

1185-
If you're offering multiprice subscriptions, you may define different tax rates for each price by implementing a `priceTaxRates` method on your billable model:
1185+
If you're offering subscriptions with multiple products, you may define different tax rates for each price by implementing a `priceTaxRates` method on your billable model:
11861186

11871187
/**
11881188
* The tax rates that should apply to the customer's subscriptions.
@@ -1205,7 +1205,7 @@ When changing the hard-coded tax rate IDs returned by the `taxRates` method, the
12051205

12061206
$user->subscription('default')->syncTaxRates();
12071207

1208-
This will also sync any multiprice subscription item tax rates. If your application is offering multiprice subscriptions, you should ensure that your billable model implements the `priceTaxRates` method [discussed above](#subscription-taxes).
1208+
This will also sync any item tax rates for a subscription with multiple products. If your application is offering subscriptions with multiple products, you should ensure that your billable model implements the `priceTaxRates` method [discussed above](#subscription-taxes).
12091209

12101210
<a name="tax-exemption"></a>
12111211
#### Tax Exemption

0 commit comments

Comments
 (0)