You can use the vouchers object to model vouchers.

Vouchers and discounts

It is worth considering the general difference between vouchers and discounts.

Discounts

Generally, discounts reduce the amount to be paid on the invoice. Tax is applied to the full invoice amount and the discount is taken off afterward.

For example, if the invoice is for €10.00 + €2.30 VAT, a €5.00 discount would mean there is €5.00 + €2.30 left to pay.

Detail	Amount	Tax	Total
Charge	10.00	2.30	12.30
Discount			-5.00
Total			7.30

Note that tax is calculated on the full amount, so in the example above, tax of 2.30 is due to the tax authority.

See Discounts.

Vouchers

This also covers gift cards and coupons that may be treated differently.

A key consideration is whether tax was paid when purchasing the voucher.

For example, a €5.00 voucher might cost €6.15 including tax.

In this case, VAT was already paid on that amount so the amount must come off the net invoice amount.

Applying the voucher to an invoice for €10.00 results in €5.00 + €1.15 VAT:

	Amount	Tax	Total
Charge	10.00	2.30	12.30
Voucher	-5.00	-1.15	-6.15
Total	5.00	1.15	6.15

Modeling vouchers

You use the fields outlined in the following table to model vouchers.

Field	Description
`voucher_type`	Specify `cash-equivalent` to ensure that the value is deducted from the total.
`voucher_amount`	The total value of the voucher.
`voucher_description`	A description.
`voucher_applied_amount`	A voucher amount that was applied. It may not have been fully applied if its amount was higher than the total transaction amount.
`voucher_remaining_amount`	A voucher amount that was not applied. The voucher may have not been fully applied if its amount was higher than the total transaction amount.

See Voucher Object Fields.

For example:

{
		"voucher_type":"cash-equivalent"
		"voucher_code":"ABC_1234"
		"voucher_description":"Example 1"
		"voucher_amount":50
		"voucher_applied_amount":1
		"voucher_remaining_amount":0
	}
]