import requests
url = "https://api.paywise.de/mahnservice/v1/invoices/{uuid}/release/"
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}/release/', 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}/release/")
.header("Authorization", "Bearer <token>")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.paywise.de/mahnservice/v1/invoices/{uuid}/release/");
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}/release/ \
--header 'Authorization: Bearer <token>'{
"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"
}Release a held invoice for dunning
Creates the dunning process for a held invoice (the second step of the two-step submission). The process starts ACTIVE when the company’s Mahnlauf is activated, PENDING until then, and is parked PAUSED under a company- or debtor-level pause. Releasing an already-released invoice is a no-op returning the current state. When the invoice is already covered by a debt-collection case, the process is created directly in dunning_state “inkasso” (200). 409 (codes: invoice_archived, invoice_settled, no_default_dunning_flow, not_api_invoice, document_not_ready) when ingestion/scanning is incomplete, the invoice is archived/settled, no default dunning flow is configured, or the invoice belongs to a bookkeeping integration.
import requests
url = "https://api.paywise.de/mahnservice/v1/invoices/{uuid}/release/"
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}/release/', 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}/release/")
.header("Authorization", "Bearer <token>")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.paywise.de/mahnservice/v1/invoices/{uuid}/release/");
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}/release/ \
--header 'Authorization: Bearer <token>'{
"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
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 