One of your own customers, by the `cus_` id the Customers API returns. Their details are copied onto the invoice. Another merchant's customer answers 422.

Make the invoice a recurring template: a draft copy is generated each cycle of `recurring_interval`. Only a `document_type` of `invoice` can recur, and never a copy the series generated: both answer 422.

A currency Wajub supports, as on `POST /payments`. Any other code answers 422.

The language of the invoice's e-mail and PDF: `fr` or `en`. Defaults to the linked customer's preferred language, else your account's language (Settings → Regional → Language), else `en`.

One of the invoice templates set up in the Dashboard, by id.

Restricts the methods the payer is offered on the invoice's page, as on `POST /payments`.

Same as `recurring_interval`, accepted for older integrations: `daily`, `weekly`, `monthly`, `quarterly` or `yearly`.

With a `payment_type` of `split` or `milestone`, the instalments the payer settles one at a time.

The customer's postal address, printed on the invoice.

The customer's company, printed under their name.

Where `POST /invoices/{id}/send` e-mails the invoice and its PDF, and where the Dashboard sends its reminders.

The name printed on the invoice. Required, even with `customer_id`: the customer can be a person or a business you only name.

The customer's phone number, international format.

Defaults to `invoice`. A `quote` or an `estimate` is not returned by the other `/invoices` routes.

On or after `invoice_date`.

Up to 500 characters.

`percentage` (default) or `fixed`.

A percentage, at most 100, or an amount in the major unit of the currency and at most its decimals, by `global_discount_type`. An amount takes off at most the lines' amount.

Apply one discount to the invoice, set by `global_discount_type` and `global_discount_value`: worked out on the lines' amount after their own discounts, and spread over the lines in proportion to it before tax, so tax is charged on what is left (a 100 % discount leaves no tax); shipping is added after it. `false` removes it.

The date printed on the invoice, `YYYY-MM-DD`.

At least one line, at most 200.

Up to 5 000 characters.

Sets `due_date` this many days from today when `due_date` is left out.

`full` (default), `split` or `milestone`.

A shipping cost, in the major unit of the currency and at most its decimals (none for XAF). Added to `total` after the discount, and never taxed.

Lets the payer pay part of the balance on the invoice's page, at least this much at a time; the balance itself can always be paid, even when less than this is left. Above zero, in the currency's unit, at most `total`, and only with a `payment_type` of `full`: otherwise `422`. Leave it out for the balance in one payment. Until partial payments open on Wajub, any minimum answers `422`.

Your own number for the document: up to 32 letters, digits, spaces and `- _ / . #`, starting with a letter or a digit. Shown instead of `invoice_number` on the invoice's page, its PDF and e-mail, the payment's description and its receipt (`display_number`); `invoice_number` is still drawn when you send it. Unique among your documents of the same `document_type`, whatever the case: a number already taken answers `422`, naming the document that has it.

`daily`, `weekly`, `monthly`, `quarterly` or `yearly`.

Up to 5 000 characters.