Docs API Reference Complaint/bff/complaint/policy-create

/bff/complaint/policy-create

Creates a versioned complaint policy with cancellation/storno rules. Assign to a product or category. Multiple versions can coexist with different validity periods.

ComplaintpostBffComplaintPolicy-create

Parameters

10 body

10 total

Body · 10

productIdnumber

Apply this policy to a specific product.

categoryIdnumber

Apply this policy to all products in a category.

titlestringRequired

Policy title displayed to staff and optionally to customer.

bodystringRequired

Full policy text in HTML or plain text. Defines terms and conditions for complaints.

validFromstringRequired

Date from which this policy version is effective.

Format: date-time

validTostring

Date until which this policy is effective. Null means open-ended.

Format: date-time

allowStornoboolean

Indicator of whether free cancellation/storno is allowed under this policy.

Default: false

stornoFreeHoursnumber

Number of hours before the reservation/event during which storno is free of charge.

stornoFeePercentnumber

Storno fee as a percentage of the order price when cancelled within the fee window.

stornoFeeDeadlineHoursnumber

Number of hours before the reservation/event within which the storno fee applies. Cancellations before this window use stornoFreeHours rules.

Request

POST /bff/complaint/policy-create

post

curl -X POST "https://api.bizkithub.com/bff/complaint/policy-create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "productId": 42,
  "categoryId": 5,
  "title": "Standard return policy",
  "body": "Items may be returned within 14 days of delivery.",
  "validFrom": "2026-01-01T00:00:00.000Z",
  "validTo": "2026-12-31T23:59:59.000Z",
  "allowStorno": false,
  "stornoFreeHours": 48,
  "stornoFeePercent": 50,
  "stornoFeeDeadlineHours": 24
}'

Response

JSON payload

{
  "success": true,
  "id": 1
}

All response codes

1 status code documented

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key