import requests
url = "https://api.paywise.de/mahnservice/v1/invoices/"
payload = {
"amount": "<string>",
"debtor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"due_date": "2023-12-25",
"invoice_number": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: '<string>',
debtor: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
due_date: '2023-12-25',
invoice_number: '<string>'
})
};
fetch('https://api.paywise.de/mahnservice/v1/invoices/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.paywise.de/mahnservice/v1/invoices/")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": \"<string>\",\n \"debtor\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"due_date\": \"2023-12-25\",\n \"invoice_number\": \"<string>\"\n}")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.paywise.de/mahnservice/v1/invoices/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"amount\": \"<string>\",\n \"debtor\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"due_date\": \"2023-12-25\",\n \"invoice_number\": \"<string>\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
curl --request POST \
--url https://api.paywise.de/mahnservice/v1/invoices/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": "<string>",
"debtor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"due_date": "2023-12-25",
"invoice_number": "<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": "active",
"has_document": false,
"id": "71000000-0000-4000-8000-000000000001",
"invoice_number": "INV-2026-1042",
"overpaid": false,
"paid_amount": "0.00",
"updated": "2026-09-03T09:00:00Z",
"your_reference": "CUSTOMER-1042"
}Submit an invoice
Idempotent on invoice_number (per company + access mode). A repeat submission returns 200 with the EXISTING invoice and does NOT apply any changed fields; a genuinely new invoice returns 201. To correct a submitted invoice, PATCH it while it is still held — do not invent a second invoice_number for it. The invoice PDF is attached separately (POST …/documents/); release waits until a supplied document reaches ready. 409 (codes: invoice_cancelled, invoice_written_off, invoice_archived) when the number belongs to an invoice that was cancelled, written off or archived: such a row takes no correction any more — submit the corrected invoice under a new invoice number.
import requests
url = "https://api.paywise.de/mahnservice/v1/invoices/"
payload = {
"amount": "<string>",
"debtor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"due_date": "2023-12-25",
"invoice_number": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
amount: '<string>',
debtor: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
due_date: '2023-12-25',
invoice_number: '<string>'
})
};
fetch('https://api.paywise.de/mahnservice/v1/invoices/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.paywise.de/mahnservice/v1/invoices/")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"amount\": \"<string>\",\n \"debtor\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"due_date\": \"2023-12-25\",\n \"invoice_number\": \"<string>\"\n}")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.paywise.de/mahnservice/v1/invoices/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"amount\": \"<string>\",\n \"debtor\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"due_date\": \"2023-12-25\",\n \"invoice_number\": \"<string>\"\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
curl --request POST \
--url https://api.paywise.de/mahnservice/v1/invoices/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"amount": "<string>",
"debtor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"due_date": "2023-12-25",
"invoice_number": "<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": "active",
"has_document": false,
"id": "71000000-0000-4000-8000-000000000001",
"invoice_number": "INV-2026-1042",
"overpaid": false,
"paid_amount": "0.00",
"updated": "2026-09-03T09:00:00Z",
"your_reference": "CUSTOMER-1042"
}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.
Response
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 