import requests
url = "https://api.paywise.de/v1/claims/"
payload = {
"debtor": "5352c781-9ed1-45cc-bd15-9ec342435ae2",
"your_reference": "order-12-A-245-2022",
"document_reference": "RE-202200045",
"subject_matter": "Warenlieferung Playstation 7",
"occurence_date": "2022-09-01",
"document_date": "2022-09-01",
"due_date": "2022-09-19",
"reminder_date": "2022-09-24",
"delay_date": "2022-09-24",
"total_claim_amount": {
"value": "1202.50",
"currency": "EUR"
},
"main_claim_amount": {
"value": "1200.00",
"currency": "EUR"
},
"starting_approach": "extrajudicial",
"claim_disputed": False,
"obligation_fulfilled": True
}
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({
debtor: '5352c781-9ed1-45cc-bd15-9ec342435ae2',
your_reference: 'order-12-A-245-2022',
document_reference: 'RE-202200045',
subject_matter: 'Warenlieferung Playstation 7',
occurence_date: '2022-09-01',
document_date: '2022-09-01',
due_date: '2022-09-19',
reminder_date: '2022-09-24',
delay_date: '2022-09-24',
total_claim_amount: {value: '1202.50', currency: 'EUR'},
main_claim_amount: {value: '1200.00', currency: 'EUR'},
starting_approach: 'extrajudicial',
claim_disputed: false,
obligation_fulfilled: true
})
};
fetch('https://api.paywise.de/v1/claims/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.paywise.de/v1/claims/")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"debtor\": \"5352c781-9ed1-45cc-bd15-9ec342435ae2\",\n \"your_reference\": \"order-12-A-245-2022\",\n \"document_reference\": \"RE-202200045\",\n \"subject_matter\": \"Warenlieferung Playstation 7\",\n \"occurence_date\": \"2022-09-01\",\n \"document_date\": \"2022-09-01\",\n \"due_date\": \"2022-09-19\",\n \"reminder_date\": \"2022-09-24\",\n \"delay_date\": \"2022-09-24\",\n \"total_claim_amount\": {\n \"value\": \"1202.50\",\n \"currency\": \"EUR\"\n },\n \"main_claim_amount\": {\n \"value\": \"1200.00\",\n \"currency\": \"EUR\"\n },\n \"starting_approach\": \"extrajudicial\",\n \"claim_disputed\": false,\n \"obligation_fulfilled\": true\n}")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.paywise.de/v1/claims/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"debtor\": \"5352c781-9ed1-45cc-bd15-9ec342435ae2\",\n \"your_reference\": \"order-12-A-245-2022\",\n \"document_reference\": \"RE-202200045\",\n \"subject_matter\": \"Warenlieferung Playstation 7\",\n \"occurence_date\": \"2022-09-01\",\n \"document_date\": \"2022-09-01\",\n \"due_date\": \"2022-09-19\",\n \"reminder_date\": \"2022-09-24\",\n \"delay_date\": \"2022-09-24\",\n \"total_claim_amount\": {\n \"value\": \"1202.50\",\n \"currency\": \"EUR\"\n },\n \"main_claim_amount\": {\n \"value\": \"1200.00\",\n \"currency\": \"EUR\"\n },\n \"starting_approach\": \"extrajudicial\",\n \"claim_disputed\": false,\n \"obligation_fulfilled\": true\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
curl --request POST \
--url https://api.paywise.de/v1/claims/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"debtor": "5352c781-9ed1-45cc-bd15-9ec342435ae2",
"your_reference": "order-12-A-245-2022",
"document_reference": "RE-202200045",
"subject_matter": "Warenlieferung Playstation 7",
"occurence_date": "2022-09-01",
"document_date": "2022-09-01",
"due_date": "2022-09-19",
"reminder_date": "2022-09-24",
"delay_date": "2022-09-24",
"total_claim_amount": {
"value": "1202.50",
"currency": "EUR"
},
"main_claim_amount": {
"value": "1200.00",
"currency": "EUR"
},
"starting_approach": "extrajudicial",
"claim_disputed": false,
"obligation_fulfilled": true
}
'{
"href": "<string>",
"submission_state": "created",
"rejection_reason": "<string>",
"rejected_at": "2023-11-07T05:31:56Z",
"rejection_notified_to": [
"[email protected]"
],
"debtor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mandate": {
"href": "<string>",
"id": "<string>",
"reference_number": "<string>"
},
"your_reference": "<string>",
"subject_matter": "<string>",
"occurence_date": "2023-12-25",
"document_reference": "<string>",
"document_date": "2023-12-25",
"due_date": "2023-12-25",
"reminder_date": "2023-12-25",
"delay_date": "2023-12-25",
"total_claim_amount": {
"value": "<string>",
"currency": "EUR"
},
"main_claim_amount": {
"value": "<string>",
"currency": "EUR"
},
"starting_approach": "extrajudicial",
"claim_disputed": true,
"obligation_fulfilled": true,
"documents": [
{
"mime_type": "<string>",
"filename": "<string>",
"id": "<string>"
}
],
"created": "2023-11-07T05:31:56Z",
"updated": "2023-11-07T05:31:56Z",
"id": "<string>",
"items": [
{
"description": "<string>",
"quantity": 123,
"amount": {
"value": "<string>",
"currency": "EUR"
},
"unit": "<string>"
}
],
"additional_charges_amount": {
"value": "<string>",
"currency": "EUR"
},
"additional_charges": [
{
"type": "reminder_fee",
"your_reference": "<string>",
"subject_matter": "<string>",
"occurence_date": "2023-12-25",
"document_date": "2023-12-25",
"due_date": "2023-12-25",
"amount": {
"value": "<string>",
"currency": "EUR"
},
"id": "<string>",
"metadata": [
{
"type": "comment",
"value": "<string>"
}
],
"events": [
{
"type": "invoice",
"title": "<string>",
"occurence": "2023-11-07T05:31:56Z",
"your_reference": "<string>",
"description": "<string>",
"location": "<string>"
}
]
}
],
"payments": [
{
"href": "<string>",
"amount": {
"value": "<string>",
"currency": "EUR"
},
"value_date": "2023-12-25",
"created": "2023-11-07T05:31:56Z",
"your_reference": "<string>",
"metadata": [
{
"type": "comment",
"value": "<string>"
}
]
}
],
"metadata": [
{
"type": "comment",
"value": "<string>"
}
],
"events": [
{
"type": "claim",
"title": "<string>",
"occurence": "2023-11-07T05:31:56Z",
"your_reference": "<string>",
"description": "<string>",
"location": "<string>"
}
]
}Create a claim
DRF ViewSet mixin that logs every API request with structured fields for Loki-based monitoring and usage analytics.
Add as the first parent class in ViewSet inheritance so finalize_response() runs after view logic completes.
import requests
url = "https://api.paywise.de/v1/claims/"
payload = {
"debtor": "5352c781-9ed1-45cc-bd15-9ec342435ae2",
"your_reference": "order-12-A-245-2022",
"document_reference": "RE-202200045",
"subject_matter": "Warenlieferung Playstation 7",
"occurence_date": "2022-09-01",
"document_date": "2022-09-01",
"due_date": "2022-09-19",
"reminder_date": "2022-09-24",
"delay_date": "2022-09-24",
"total_claim_amount": {
"value": "1202.50",
"currency": "EUR"
},
"main_claim_amount": {
"value": "1200.00",
"currency": "EUR"
},
"starting_approach": "extrajudicial",
"claim_disputed": False,
"obligation_fulfilled": True
}
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({
debtor: '5352c781-9ed1-45cc-bd15-9ec342435ae2',
your_reference: 'order-12-A-245-2022',
document_reference: 'RE-202200045',
subject_matter: 'Warenlieferung Playstation 7',
occurence_date: '2022-09-01',
document_date: '2022-09-01',
due_date: '2022-09-19',
reminder_date: '2022-09-24',
delay_date: '2022-09-24',
total_claim_amount: {value: '1202.50', currency: 'EUR'},
main_claim_amount: {value: '1200.00', currency: 'EUR'},
starting_approach: 'extrajudicial',
claim_disputed: false,
obligation_fulfilled: true
})
};
fetch('https://api.paywise.de/v1/claims/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.post("https://api.paywise.de/v1/claims/")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"debtor\": \"5352c781-9ed1-45cc-bd15-9ec342435ae2\",\n \"your_reference\": \"order-12-A-245-2022\",\n \"document_reference\": \"RE-202200045\",\n \"subject_matter\": \"Warenlieferung Playstation 7\",\n \"occurence_date\": \"2022-09-01\",\n \"document_date\": \"2022-09-01\",\n \"due_date\": \"2022-09-19\",\n \"reminder_date\": \"2022-09-24\",\n \"delay_date\": \"2022-09-24\",\n \"total_claim_amount\": {\n \"value\": \"1202.50\",\n \"currency\": \"EUR\"\n },\n \"main_claim_amount\": {\n \"value\": \"1200.00\",\n \"currency\": \"EUR\"\n },\n \"starting_approach\": \"extrajudicial\",\n \"claim_disputed\": false,\n \"obligation_fulfilled\": true\n}")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.paywise.de/v1/claims/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"debtor\": \"5352c781-9ed1-45cc-bd15-9ec342435ae2\",\n \"your_reference\": \"order-12-A-245-2022\",\n \"document_reference\": \"RE-202200045\",\n \"subject_matter\": \"Warenlieferung Playstation 7\",\n \"occurence_date\": \"2022-09-01\",\n \"document_date\": \"2022-09-01\",\n \"due_date\": \"2022-09-19\",\n \"reminder_date\": \"2022-09-24\",\n \"delay_date\": \"2022-09-24\",\n \"total_claim_amount\": {\n \"value\": \"1202.50\",\n \"currency\": \"EUR\"\n },\n \"main_claim_amount\": {\n \"value\": \"1200.00\",\n \"currency\": \"EUR\"\n },\n \"starting_approach\": \"extrajudicial\",\n \"claim_disputed\": false,\n \"obligation_fulfilled\": true\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
curl --request POST \
--url https://api.paywise.de/v1/claims/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"debtor": "5352c781-9ed1-45cc-bd15-9ec342435ae2",
"your_reference": "order-12-A-245-2022",
"document_reference": "RE-202200045",
"subject_matter": "Warenlieferung Playstation 7",
"occurence_date": "2022-09-01",
"document_date": "2022-09-01",
"due_date": "2022-09-19",
"reminder_date": "2022-09-24",
"delay_date": "2022-09-24",
"total_claim_amount": {
"value": "1202.50",
"currency": "EUR"
},
"main_claim_amount": {
"value": "1200.00",
"currency": "EUR"
},
"starting_approach": "extrajudicial",
"claim_disputed": false,
"obligation_fulfilled": true
}
'{
"href": "<string>",
"submission_state": "created",
"rejection_reason": "<string>",
"rejected_at": "2023-11-07T05:31:56Z",
"rejection_notified_to": [
"[email protected]"
],
"debtor": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mandate": {
"href": "<string>",
"id": "<string>",
"reference_number": "<string>"
},
"your_reference": "<string>",
"subject_matter": "<string>",
"occurence_date": "2023-12-25",
"document_reference": "<string>",
"document_date": "2023-12-25",
"due_date": "2023-12-25",
"reminder_date": "2023-12-25",
"delay_date": "2023-12-25",
"total_claim_amount": {
"value": "<string>",
"currency": "EUR"
},
"main_claim_amount": {
"value": "<string>",
"currency": "EUR"
},
"starting_approach": "extrajudicial",
"claim_disputed": true,
"obligation_fulfilled": true,
"documents": [
{
"mime_type": "<string>",
"filename": "<string>",
"id": "<string>"
}
],
"created": "2023-11-07T05:31:56Z",
"updated": "2023-11-07T05:31:56Z",
"id": "<string>",
"items": [
{
"description": "<string>",
"quantity": 123,
"amount": {
"value": "<string>",
"currency": "EUR"
},
"unit": "<string>"
}
],
"additional_charges_amount": {
"value": "<string>",
"currency": "EUR"
},
"additional_charges": [
{
"type": "reminder_fee",
"your_reference": "<string>",
"subject_matter": "<string>",
"occurence_date": "2023-12-25",
"document_date": "2023-12-25",
"due_date": "2023-12-25",
"amount": {
"value": "<string>",
"currency": "EUR"
},
"id": "<string>",
"metadata": [
{
"type": "comment",
"value": "<string>"
}
],
"events": [
{
"type": "invoice",
"title": "<string>",
"occurence": "2023-11-07T05:31:56Z",
"your_reference": "<string>",
"description": "<string>",
"location": "<string>"
}
]
}
],
"payments": [
{
"href": "<string>",
"amount": {
"value": "<string>",
"currency": "EUR"
},
"value_date": "2023-12-25",
"created": "2023-11-07T05:31:56Z",
"your_reference": "<string>",
"metadata": [
{
"type": "comment",
"value": "<string>"
}
]
}
],
"metadata": [
{
"type": "comment",
"value": "<string>"
}
],
"events": [
{
"type": "claim",
"title": "<string>",
"occurence": "2023-11-07T05:31:56Z",
"your_reference": "<string>",
"description": "<string>",
"location": "<string>"
}
]
}Authorizations
Body
Our starting approach to collect the claim: extrajudicial ("außergerichtlich") or judicial ("gerichtliches Mahnverfahren").
extrajudicial- Zunächst außergerichtlich startenjudicial- Gleich Mahnbescheid beantragenenforcement- Direkt vollstrecken
extrajudicial, judicial, enforcement Response
The current state of the claim submission. Possible values: created (claim saved in the system; does NOT constitute acceptance by paywise), released (released for processing by paywise), under_review (claim is being reviewed by our team), client_response_pending (waiting for your response), accepted (claim accepted and being processed), rejected (claim was rejected), cancelled (claim was cancelled by the client).
created- Createdreleased- Released for processingunder_review- Under reviewclient_response_pending- Pending client responseaccepted- Acceptedrejected- Rejectedcancelled- Cancelled by client
created, released, under_review, client_response_pending, accepted, rejected, cancelled Our starting approach to collect the claim: extrajudicial ("außergerichtlich") or judicial ("gerichtliches Mahnverfahren").
extrajudicial- Zunächst außergerichtlich startenjudicial- Gleich Mahnbescheid beantragenenforcement- Direkt vollstrecken
extrajudicial, judicial, enforcement 