Core concepts
Invoices
In the merchant of record model, Merxian issues a numbered invoice for each paid sale and a credit note for each refund or correction.
Who issues the invoice#
| Model | Buyer invoice |
|---|---|
| Payments | You issue it, with your own tools. Merxian issues no buyer invoice. |
| Merchant of record | Merxian issues it in its own name. The lines name your product as it appears in your catalog. |
The API has no invoice endpoints. Invoices reach your integration as webhook events.
Invoice rules#
- Invoices and credit notes are numbered. Each number is used once.
- An issued invoice does not change. To correct one, Merxian issues a credit note that refers to it.
- Invoices show the VAT rate and amount, or a reverse charge note when VAT is not charged.
- Invoices are PDF documents in German, English, French, or Dutch.
Invoice events#
| Event | Meaning |
|---|---|
invoice.issued |
Merxian issued an invoice for a paid transaction. |
invoice.credited |
Merxian issued a credit note. Its amounts are negative. |
The payload has the document number, the type (INVOICE, CREDIT_NOTE, or GUTSCHRIFT for the credit note of a German issuer), the transaction_id, and the amounts in minor units.
What to build#
- Store the invoice number with your record of the sale, keyed by
transaction_id. - Store the credit note number with your record of the refund.