Add sendInvoice signature for Stripe invoices. (DefinitelyTyped#37223)

* Add sendInvoice signature for Stripe invoices.

* Include response and HeaderOptions in signature.

Author: marcinjendrzejewski

types/stripe/index.d.ts

@@ -9239,6 +9239,20 @@ declare namespace Stripe {
             list(data: invoices.IInvoiceListOptions, options: HeaderOptions, response?: IResponseFn<IList<invoices.IInvoice>>): IListPromise<invoices.IInvoice>;
             list(data: invoices.IInvoiceListOptions, response?: IResponseFn<IList<invoices.IInvoice>>): IListPromise<invoices.IInvoice>;
             list(response?: IResponseFn<IList<invoices.IInvoice>>): IListPromise<invoices.IInvoice>;
+
+            /**
+             * Stripe will automatically send invoices to customers according to your subscriptions settings.
+             * However, if you’d like to manually send an invoice to your customer out of the normal schedule, you can do so.
+             * When sending invoices that have already been paid, there will be no reference to the payment in the email.
+             *
+             * Requests made in test-mode result in no emails being sent, despite sending an invoice.sent event.
+             *
+             * @returns Returns the invoice object
+             *
+             * @param invoice The ID of the invoice to send
+             */
+            sendInvoice(id: string, options: HeaderOptions, response?: IResponseFn<invoices.IInvoice>): Promise<invoices.IInvoice>;
+            sendInvoice(id: string, response?: IResponseFn<invoices.IInvoice>): Promise<invoices.IInvoice>;
         }
 
         class InvoiceItems extends StripeResource {

types/stripe/stripe-tests.ts

@@ -1407,6 +1407,10 @@ stripe.invoices.retrieve("in_15fvyXEe31JkLCeQH7QbgZZb", { expand: ["subscription
   invoice.subscription;
 });
 
+stripe.invoices.sendInvoice('in_15fvyXEe31JkLCeQH7QbgZZb').then(invoice => {
+    // asynchronously called
+});
+
 //#endregion
 
 //#region Invoice Items tests