Skip to navigation
API ReferenceInvoices

Create an invoice

Create a new invoice for the organization

Authentication

AuthorizationBearer

Bearer token authentication for Mercury API.

Use your API token in the Authorization header: Authorization: Bearer TOKEN

Example: Authorization: Bearer secret-token:mercury_production_wma_24SCp4G81X3yHL4Wq8FgzuaP9ye3VKf2mgTDctXyRg5HY_yrucrem

Your Mercury API token should include the ‘secret-token:’ prefix. Tokens can be generated from your Mercury dashboard settings.

Request

This endpoint expects an object.
achDebitEnabledbooleanRequired
Whether or not the invoice can be paid via ACH debit.
ccEmailslist of stringsRequired

Emails to be CCed on invoice notifications/reminders.

creditCardEnabledbooleanRequired
Whether or not the invoice can be paid via credit card. Requires Stripe to be setup for the Mercury account.
customerIdstringRequiredformat: "uuid"
destinationAccountIdstringRequiredformat: "uuid"
dueDatedateRequired
invoiceDatedateRequired
lineItemslist of objectsRequired
The line items for the invoice
useRealAccountNumberbooleanRequired
Whether or not the invoice payment instructions will show the real account and routing number for the destination account or use virtual account numbers instead. Virtual accounts are safer and are preferred in most cases.
internalNotestring or nullOptional
Internal note for the invoice, visible by users in the organization but not visible to payers.
invoiceNumberstring or nullOptional

The payer facing invoice number/identifier.

payerMemostring or nullOptional
Memo for the payer of the invoice.
poNumberstring or nullOptional
Purchase order number for the invoice, if applicable.
sendEmailOptionenum or nullOptional
Allowed values:
servicePeriodEndDateobject or nullOptional
servicePeriodStartDateobject or nullOptional

Response

achDebitEnabledboolean
Whether or not the invoice can be paid via ach debit.
amountdouble
The total amount of the invoice line items plus taxes.
ccEmailslist of strings

Emails to be CCed on invoice notifications/reminders.

createdAtstringformat: "yyyy-mm-ddThh:MM:ssZ"
creditCardEnabledboolean
Whether or not the invoice can be paid via credit card. Requires stripe to be setup for the Mercury account.
customerIdstringformat: "uuid"
destinationAccountIdstringformat: "uuid"
dueDatedate
idstringformat: "uuid"
invoiceDatedate
invoiceNumberstring

The payer facing invoice number/identifier.

lineItemslist of objects
The line items for the invoice.
slugstring
Public slug for an invoice. Used to construct the pay page URL as well as the URL to retrieve the PDF of the invoice.
statusenum
Allowed values:
updatedAtstringformat: "yyyy-mm-ddThh:MM:ssZ"
useRealAccountNumberboolean
Whether or not the invoice payment instructions will show the real account and routing number for the destination account or use virtual account numbers instead.
canceledAtobject or nullOptional
internalNotestring or nullOptional
Internal note for the invoice, visible by users in the mercury organization but not visible to payers.
payerMemostring or nullOptional
Memo for the payer of the invoice.
poNumberstring or nullOptional
Purchase order number for the invoice if applicable.
servicePeriodEndDateobject or nullOptional
servicePeriodStartDateobject or nullOptional

Errors

400
Bad Request Error