import requests
url = "https://api.paywise.de/mahnservice/v1/invoices/{uuid}/write-off/"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.paywise.de/mahnservice/v1/invoices/{uuid}/write-off/', 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/{uuid}/write-off/")
.header("Authorization", "Bearer <token>")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.paywise.de/mahnservice/v1/invoices/{uuid}/write-off/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
curl --request POST \
--url https://api.paywise.de/mahnservice/v1/invoices/{uuid}/write-off/ \
--header 'Authorization: Bearer <token>'{
"access_mode": "production",
"amount": "250.00",
"archived": false,
"balance": "0.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": "written_off",
"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"
}{
"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>"
}
]
}Write off an invoice (Ausbuchung)
Marks the claim written off and stops its dunning process. Idempotent; 409 (codes: invoice_paid, invoice_cancelled, invoice_in_inkasso — the invoice was handed to debt collection, contact support to retract it; not_api_invoice) when the invoice is already settled otherwise, at debt collection, or belongs to a bookkeeping integration.
import requests
url = "https://api.paywise.de/mahnservice/v1/invoices/{uuid}/write-off/"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.paywise.de/mahnservice/v1/invoices/{uuid}/write-off/', 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/{uuid}/write-off/")
.header("Authorization", "Bearer <token>")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.paywise.de/mahnservice/v1/invoices/{uuid}/write-off/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
curl --request POST \
--url https://api.paywise.de/mahnservice/v1/invoices/{uuid}/write-off/ \
--header 'Authorization: Bearer <token>'{
"access_mode": "production",
"amount": "250.00",
"archived": false,
"balance": "0.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": "written_off",
"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"
}{
"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
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 