BizKitHub
DocsAPI ReferenceComplaint/bff/complaint/policy-create
postComplaintAdmin BFF

/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

JSON body

Request body

application/json
productIdnumberOptional

Apply this policy to a specific product.

Example42
categoryIdnumberOptional

Apply this policy to all products in a category.

Example5
titlestringRequired

Policy title displayed to staff and optionally to customer.

ExampleStandard return policy
bodystringRequired

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

ExampleItems may be returned within 14 days of delivery.
validFromstringRequireddate-time

Date from which this policy version is effective.

Example2026-01-01T00:00:00.000Z
validTostringOptionaldate-time

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

Example2026-12-31T23:59:59.000Z
allowStornobooleanOptional

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

Default: false
stornoFreeHoursnumberOptional

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

Example48
stornoFeePercentnumberOptional

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

Example50
stornoFeeDeadlineHoursnumberOptional

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

Example24

Response schema

1 status code documented

200Success
successbooleanRequired

Indicates whether the operation completed successfully.

Default: true
idnumberRequired

Newly created policy ID.

Example1

Response example

application/json
{
  "success": true,
  "id": 1
}

Request example

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
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key