import requests
url = "https://api.paywise.de/mahnservice/v1/invoices/{uuid}/"
payload = {
"amount": "<string>",
"currency": "EUR",
"debtor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"document_date": "2023-12-25",
"due_date": "2023-12-25",
"invoice_number": "<string>",
"your_reference": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: '<string>',
currency: 'EUR',
debtor: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
document_date: '2023-12-25',
due_date: '2023-12-25',
invoice_number: '<string>',
your_reference: '<string>'
})
};
fetch('https://api.paywise.de/mahnservice/v1/invoices/{uuid}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.patch("https://api.paywise.de/mahnservice/v1/invoices/{uuid}/")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": \"<string>\",\n \"currency\": \"EUR\",\n \"debtor\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"document_date\": \"2023-12-25\",\n \"due_date\": \"2023-12-25\",\n \"invoice_number\": \"<string>\",\n \"your_reference\": \"<string>\"\n}")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.paywise.de/mahnservice/v1/invoices/{uuid}/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"amount\": \"<string>\",\n \"currency\": \"EUR\",\n \"debtor\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"document_date\": \"2023-12-25\",\n \"due_date\": \"2023-12-25\",\n \"invoice_number\": \"<string>\",\n \"your_reference\": \"<string>\"\n}", false);
var response = await client.PatchAsync(request);
Console.WriteLine("{0}", response.Content);
curl --request PATCH \
--url https://api.paywise.de/mahnservice/v1/invoices/{uuid}/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": "<string>",
"currency": "EUR",
"debtor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"document_date": "2023-12-25",
"due_date": "2023-12-25",
"invoice_number": "<string>",
"your_reference": "<string>"
}
'{
"access_mode": "production",
"amount": "250.00",
"archived": false,
"balance": "250.00",
"created": "2026-09-02T08:00:00Z",
"currency": "EUR",
"debtor": "72000000-0000-4000-8000-000000000001",
"document": null,
"document_date": "2026-08-18",
"due_date": "2026-09-01",
"dunning_state": "held",
"has_document": false,
"id": "71000000-0000-4000-8000-000000000001",
"invoice_number": "INV-2026-1042",
"overpaid": false,
"paid_amount": "0.00",
"updated": "2026-09-02T08:00:00Z",
"your_reference": "CUSTOMER-1042"
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}Correct a held invoice
Corrects a still-held invoice (submitted, not yet released). Submit is idempotent and ignores changed fields, so this is the only way to fix a typo without inventing a second invoice_number for a number that belongs to the client’s own accounting system. Partial: only the fields present in the body change. Writable are invoice_number, amount, currency, due_date, document_date, your_reference and debtor; company and access_mode come from the token and are never writable, and the lifecycle fields (dunning_state, archived, has_document, balance) change only through their own endpoints. Renaming invoice_number moves the idempotency key with it, so a later submit of the OLD number creates a new invoice. A corrected due_date re-derives the open/overdue status. The invoice PDF is replaced through POST …/documents/, which is held-only for the same reason. 409 (codes: already_released — nothing is correctable once dunning has started, cancel it and submit a corrected invoice instead; invoice_archived; invoice_paid / invoice_cancelled / invoice_written_off; duplicate_invoice_number; not_api_invoice).
import requests
url = "https://api.paywise.de/mahnservice/v1/invoices/{uuid}/"
payload = {
"amount": "<string>",
"currency": "EUR",
"debtor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"document_date": "2023-12-25",
"due_date": "2023-12-25",
"invoice_number": "<string>",
"your_reference": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: '<string>',
currency: 'EUR',
debtor: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
document_date: '2023-12-25',
due_date: '2023-12-25',
invoice_number: '<string>',
your_reference: '<string>'
})
};
fetch('https://api.paywise.de/mahnservice/v1/invoices/{uuid}/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.patch("https://api.paywise.de/mahnservice/v1/invoices/{uuid}/")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": \"<string>\",\n \"currency\": \"EUR\",\n \"debtor\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"document_date\": \"2023-12-25\",\n \"due_date\": \"2023-12-25\",\n \"invoice_number\": \"<string>\",\n \"your_reference\": \"<string>\"\n}")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.paywise.de/mahnservice/v1/invoices/{uuid}/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"amount\": \"<string>\",\n \"currency\": \"EUR\",\n \"debtor\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"document_date\": \"2023-12-25\",\n \"due_date\": \"2023-12-25\",\n \"invoice_number\": \"<string>\",\n \"your_reference\": \"<string>\"\n}", false);
var response = await client.PatchAsync(request);
Console.WriteLine("{0}", response.Content);
curl --request PATCH \
--url https://api.paywise.de/mahnservice/v1/invoices/{uuid}/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": "<string>",
"currency": "EUR",
"debtor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"document_date": "2023-12-25",
"due_date": "2023-12-25",
"invoice_number": "<string>",
"your_reference": "<string>"
}
'{
"access_mode": "production",
"amount": "250.00",
"archived": false,
"balance": "250.00",
"created": "2026-09-02T08:00:00Z",
"currency": "EUR",
"debtor": "72000000-0000-4000-8000-000000000001",
"document": null,
"document_date": "2026-08-18",
"due_date": "2026-09-01",
"dunning_state": "held",
"has_document": false,
"id": "71000000-0000-4000-8000-000000000001",
"invoice_number": "INV-2026-1042",
"overpaid": false,
"paid_amount": "0.00",
"updated": "2026-09-02T08:00:00Z",
"your_reference": "CUSTOMER-1042"
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}Authorizations
Body
A Mahnservice invoice. Created held: no dunning process exists until
POST /invoices/{uuid}/release/ creates one. The debtor is referenced
by UUID and must belong to the same company. Company and environment come
from the token, never the payload. Submitting is idempotent on the
invoice number.
ISO 4217 currency code for the invoice amount and reported balance (EUR, USD, GBP or CHF). Input is normalized to uppercase. Omit to keep the current currency; once payments have been reported the currency is fixed (409 payments_reported).
EUR, USD, GBP, CHF Your invoice number. POST with the same number within the same company and access mode returns the existing API invoice without applying changed fields. PATCH can rename a held invoice and moves this key; a conflicting number returns 409 duplicate_invoice_number. The previous number can then create a new invoice.
1 - 100Response
A Mahnservice invoice. Created held: no dunning process exists until
POST /invoices/{uuid}/release/ creates one. The debtor is referenced
by UUID and must belong to the same company. Company and environment come
from the token, never the payload. Submitting is idempotent on the
invoice number.
Remaining invoice amount in the invoice currency: amount minus reported payments, with a minimum of zero. Paid, cancelled and written-off invoices report zero. Dunning fees are not included; partial payments do not reduce the amount used in dunning notices.
^-?\d{0,12}(?:\.\d{0,2})?$Current dunning process state. held means an API invoice awaits release; an invoice settled while held reports paid, cancelled, or written_off. Null means a bookkeeping invoice has never been enrolled.
held, pending, active, paused, completed, paid, cancelled, written_off, inkasso 