Sign in

v1

latestOpenAPI 3.0.42026-07-2286621993.2 KB
invoices

Fully update invoice

Fully updates an invoice, by ID. In the JSON request body, include a complete invoice object. This call does not support partial updates. <blockquote><strong>Notes:</strong><ul><li>API caller can change/modify recipient only 2 times in 72 hours.</li></ul></blockquote>.

put/v2/invoicing/invoices/{invoice_id}

Path parameters

invoice_idstring required

The ID of the draft invoice to delete.

Query parameters

send_to_recipientboolean

Indicates whether to send the invoice update notification to the recipient.

send_to_invoicerboolean

Indicates whether to send the invoice update notification to the merchant.

Request body

idstring

The ID of the invoice.

parent_idstring

The parent ID to an invoice that defines the group invoice to which the invoice is related.

status'DRAFT' | 'SENT' | 'SCHEDULED' | 'PAID' | 'MARKED_AS_PAID' | 'CANCELLED' | 'REFUNDED' | 'PARTIALLY_PAID' | 'PARTIALLY_REFUNDED' | 'MARKED_AS_REFUNDED' | 'UNPAID' | 'PAYMENT_PENDING' | 'AUTO_CANCELLED' | 'PAID_EXTERNAL' | 'REFUNDED_EXTERNAL' | 'SHARED'

The status of the invoice.

additional_recipientsEmailAddress[]

An array of one or more CC: emails to which notifications are sent. If you omit this parameter, a notification is sent to all CC: email addresses that are part of the invoice.<blockquote><strong>Note:</strong> Valid values are email addresses in the additional_recipients value associated with the invoice.</blockquote>

Response

A successful request returns the HTTP 200 OK status code. A JSON response body that shows invoice details is returned if you set <code>prefer=return=representation</code>.

idstring

The ID of the invoice.

parent_idstring

The parent ID to an invoice that defines the group invoice to which the invoice is related.

status'DRAFT' | 'SENT' | 'SCHEDULED' | 'PAID' | 'MARKED_AS_PAID' | 'CANCELLED' | 'REFUNDED' | 'PARTIALLY_PAID' | 'PARTIALLY_REFUNDED' | 'MARKED_AS_REFUNDED' | 'UNPAID' | 'PAYMENT_PENDING' | 'AUTO_CANCELLED' | 'PAID_EXTERNAL' | 'REFUNDED_EXTERNAL' | 'SHARED'

The status of the invoice.

additional_recipientsEmailAddress[]

An array of one or more CC: emails to which notifications are sent. If you omit this parameter, a notification is sent to all CC: email addresses that are part of the invoice.<blockquote><strong>Note:</strong> Valid values are email addresses in the additional_recipients value associated with the invoice.</blockquote>