diff --git a/billing.md b/billing.md index b4bc82f7fcc..66bf568cdfe 100644 --- a/billing.md +++ b/billing.md @@ -1509,13 +1509,19 @@ The invoice will be immediately charged against the user's default payment metho 'default_tax_rates' => ['txr_id'], ]); +Similarly to `invoicePrice`, you may use the `tabPrice` method to create a one-time charge for multiple items (up to 250 items per invoice) by adding them to the customer's "tab" and then invoicing the customer. For example, we may invoice a customer for five shirts and two mugs: + + $user->tabPrice('price_tshirt', 5); + $user->tabPrice('price_mug', 2); + $user->invoice(); + Alternatively, you may use the `invoiceFor` method to make a "one-off" charge against the customer's default payment method: $user->invoiceFor('One Time Fee', 500); -Although the `invoiceFor` method is available for you to use, it is recommendeded that you use the `invoicePrice` method with pre-defined prices. By doing so, you will have access to better analytics and data within your Stripe dashboard regarding your sales on a per-product basis. +Although the `invoiceFor` method is available for you to use, it is recommendeded that you use the `invoicePrice` and `tabPrice` methods with pre-defined prices. By doing so, you will have access to better analytics and data within your Stripe dashboard regarding your sales on a per-product basis. -> {note} The `invoicePrice` and `invoiceFor` methods will create a Stripe invoice which will retry failed billing attempts. If you do not want invoices to retry failed charges, you will need to close them using the Stripe API after the first failed charge. +> {note} The `invoice`, `invoicePrice`, and `invoiceFor` methods will create a Stripe invoice which will retry failed billing attempts. If you do not want invoices to retry failed charges, you will need to close them using the Stripe API after the first failed charge. ### Refunding Charges