Update

POST

Path parameters

invoiceIdstringRequired

Invoice ID or Invoice ForeignID

Request

This endpoint expects an object.
amountdoubleOptional

Total amount of invoice in major units. If the entered amount has more decimal places than the currency supports, trailing decimals will be truncated.

approverslist of objectsOptional

Set approvers for this invoice.

creatorEntityIdstringOptional

ID or foreign ID of entity who created this invoice. If creating a payable invoice (AP), this must be the same as the payerId. If creating a receivable invoice (AR), this must be the same as the vendorId.

creatorUserIdstringOptional

User ID or Foreign ID of entity user who created this invoice.

currencyenumOptional

Currency code for the amount. Defaults to USD.

deductionDatedatetimeOptional

Initial date when funds are scheduled to be deducted from payer’s account.

documentstringOptional

Base64 encoded image or PDF of invoice document. PNG, JPG, WEBP, and PDF are supported. 10MB max. If the invoice already has a document, this will add a new document to the invoice.

dueDatedatetimeOptional

Due date of invoice.

failureTypeenumOptional
Allowed values: SOURCE_PAYMENT_ERRORDESTINATION_PAYMENT_ERRORREJECTED_HIGH_RISKINSUFFICIENT_FUNDSPROCESSING_ERROR

If the invoice failed to be paid, indicate the failure reason. Only applicable for invoices with custom payment methods.

feesobjectOptional

If using a custom payment method, you can override the default fees for this invoice. If not provided, the default fees for the custom payment method will be used.

foreignIdstringOptional

The ID used to identify this invoice in your system. This ID must be unique within each creatorEntity in your system, e.g. two invoices with the same creatorEntity may not have the same foreign ID.

invoiceDatedatetimeOptional

Date the invoice was issued.

invoiceNumberstringOptional
lineItemslist of objectsOptional
metadatamap from strings to stringsOptional

Metadata associated with this invoice.

noteToSelfstringOptional

Note to self or memo on invoice.

payerIdstringOptional

ID or foreign ID of the payer of this invoice.

paymentDestinationIdstringOptional

ID of payment destination for this invoice. If not provided, will attempt to use the default payment destination for the vendor when creating an invoice if a default payment destination exists for the vendor.

paymentDestinationOptionsobjectOptional

Options for the payment destination. Depending on the payment destination, this may include things such as check delivery method.

paymentScheduleobjectOptional

If this is a recurring invoice, this will be the payment schedule for the invoice. If not provided, this will be a one-time invoice.

paymentSourceIdstringOptional

ID of payment source for this invoice. If not provided, will attempt to use the default payment source for the payer when creating an invoice if a default payment source exists for the payer.

serviceEndDatedatetimeOptional
serviceStartDatedatetimeOptional
settlementDatedatetimeOptional

Date of funds settlement.

statusenumOptional
vendorIdstringOptional

ID or foreign ID of the vendor of this invoice.

uploadedImagestringOptionalDeprecated

DEPRECATED. Use document field instead.

Response

This endpoint returns an object.
idstring
statusenum
paymentDestinationConfirmedboolean

True if the payment destination has been confirmed by the vendor. False if the payment destination has been set (for example, a check to an address) but has not been confirmed by the vendor.

hasDocumentsboolean

True if the invoice has documents attached.

hasSourceEmailboolean

True if the invoice was created by an incoming email.

approverslist of objects
approvalPolicylist of objects
metadatamap from strings to strings

Metadata associated with this invoice.

createdAtdatetime
updatedAtdatetime
amountdoubleOptional

Total amount of invoice in major units

currencyenumOptional

Currency code for the amount. Defaults to USD.

invoiceDatedatetimeOptional

Date the invoice was issued.

deductionDatedatetimeOptional

Initial date when funds are scheduled to be deducted from payer’s account. The actual deduction date may differ from this date, and will be reflected in the processedAt field.

nextDeductionDatedatetimeOptional

If this is a recurring invoice, this will be the next date when funds are scheduled to be deducted from payer’s account.

processedAtdatetimeOptional

Date when the invoice payment was processed.

settlementDatedatetimeOptional

Date of funds settlement.

dueDatedatetimeOptional

Due date of invoice.

invoiceNumberstringOptional
noteToSelfstringOptional
serviceStartDatedatetimeOptional
serviceEndDatedatetimeOptional
payerIdstringOptional
payerobjectOptional
paymentSourceobjectOptional
paymentSourceIdstringOptional
vendorIdstringOptional
vendorobjectOptional
paymentDestinationobjectOptional
paymentDestinationIdstringOptional
paymentDestinationOptionsobjectOptional
commentslist of objectsOptional
lineItemslist of objectsOptional
foreignIdstringOptional

The ID used to identify this invoice in your system. This ID must be unique within each creatorEntity in your system, e.g. two invoices with the same creatorEntity may not have the same foreign ID.

creatorEntityIdstringOptional

The ID of the entity who created this invoice.

creatorUserobjectOptional

Entity user who created this invoice.

failureTypeenumOptional
Allowed values: SOURCE_PAYMENT_ERRORDESTINATION_PAYMENT_ERRORREJECTED_HIGH_RISKINSUFFICIENT_FUNDSPROCESSING_ERROR

If the invoice failed to be paid, this field will be populated with the type of failure.

feesobjectOptional

Fees associated with this invoice.

paymentScheduleobjectOptional

If this is a recurring invoice, this will be the payment schedule for the invoice. If not provided, this will be a one-time invoice.