Skip to main content
PATCH
/
v1
/
invoices
/
{id}
/
open
Open
curl --request PATCH \
  --url https://{defaultHost}/v1/invoices/{id}/open \
  --header 'Authorization: Bearer <token>'
{
  "id": "fde54421-fab3-46b3-9789-f1bdf5cac0a5",
  "object": "invoice",
  "automatic_collection": false,
  "due_date": null,
  "footer": null,
  "issue_date": 1767830400,
  "live_mode": true,
  "memo": null,
  "metadata": {},
  "notifications_enabled": true,
  "order_number": "0001",
  "status": "open",
  "portal_url": "http://app.example.com/portal_redirect/invoices/fde54421-fab3-46b3-9789-f1bdf5cac0a5",
  "notification_sent_at": 1767909709,
  "reminder_notification_sent_at": null,
  "checkout": "0ab14dbd-7ffc-4160-82d5-643de1ee2e34",
  "created_at": 1767909709,
  "updated_at": 1767909709
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Query Parameters

​
manual_payment
boolean

Whether or not to finalize this checkout with a manual payment. If true, the checkout will move directly to the processing state.

​
manual_payment_method_id
string

The manual payment method to use when finalizing this checkout. If set, this will take priority over all other parameters.

​
payment_method_id
string

The payment method to use when finalizing this checkout. If set, this will take priority over all other finalize parameters and an attempt to pay the checkout will occur immediately.

Response

200 - application/json

Success

​
id
string | null

The UUID of the specific object.

​
object
string

A string describing the object type returned.

​
automatic_collection
boolean

Whether or not the invoice should be paid automatically using one of the customer's payment methods. The specific payment method will need to passed to the /open endpoint.

​
due_date
integer | null

The date on which payment for this invoice is due. Measured in seconds since the Unix epoch.

​
footer
string | null

Additional footer text to be displayed on the invoice.

​
issue_date
integer | null

The date on which the invoice was issued. Measured in seconds since the Unix epoch.

​
live_mode
boolean

Whether or not the invoice is in live mode.

​
memo
string | null

Additional memo text to be displayed on the invoice.

​
notifications_enabled
boolean

Whether or not notifications should be sent to customers when an invoice is opened and when it reaches its due date.

​
metadata
object

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.

​
notification_sent_at
integer | null

The time at which the invoice notification was sent. Measured in seconds since the Unix epoch.

​
order_number
string | null

The order number associated with this invoice.

​
portal_url
string | null

A URL that will redirect to this invoice's correct portal page (hosted or external).

​
reminder_notification_sent_at
integer | null

The time at which the reminder notification was sent. Measured in seconds since the Unix epoch.

​
status
string

The current status of this invoice, which can be one of draft, open, paid or void.

​
checkout

Expandable – The associated checkout ID.

​
created_at
integer | null

Time at which the object was created. Measured in seconds since the Unix epoch.

​
updated_at
integer | null

Time at which the object was last updated. Measured in seconds since the Unix epoch.