Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

Pay an invoice


Pay an invoice

POST / v1 / invoices /:id / pay

Stripe automatically creates and then attempts to collect payment on invoices for customers on subscriptions according to your subscriptions settings. However, if you’d like to attempt payment on an invoice out of the normal collection schedule or for some other reason, you can do so.

Parameters

No parameters.

More parameters

  • forgive boolean
  • mandate string
  • off _ session boolean
  • paid _ out _ of _ band boolean
  • payment _ method string
  • source string

Returns

Returns the invoice object.

Response

Search invoices

GET / v1 / invoices / search

Search for invoices you’ve previously created using Stripe’s Search Query Language. Don’t use search in read-after-write flows where strict consistency is necessary. Under normal operating conditions, data is searchable in less than a minute. Occasionally, propagation of new or updated data can be up to an hour behind during outages. Search functionality is not available to merchants in India.

Parameters

  • query string Required The search query string. See search query language and the list of supported query fields for invoices.
  • limit integer A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
  • page string A cursor for pagination across multiple pages of results. Don’t include this parameter on the first call. Use the next_page value returned in a previous response to request subsequent results.

Returns

A dictionary with a data property that contains an array of up to limit invoices. If no objects match the query, the resulting array will be empty. See the related guide on expanding properties in lists.

Response

Send an invoice for manual payment

POST / v1 / invoices /:id / send

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.

Parameters

No parameters.

Returns

Returns the invoice object.

Response

Last verified 2026-09-24

Is this helpful?