Docs API Reference Tariff/bff/tariff/set-billing

postTariffAdmin BFF

/bff/tariff/set-billing

Updates the negotiated monthly price (CZK), the paid-until date, and the admin note on an organisation tariff assignment. Validates Enterprise rules (minimum 10 000 CZK). Allowed for internal admin OR the vendor of the target organisation.

TariffpostBffTariffSet-billing

Parameters

JSON body

Request body

application/json

organisationSlugstringRequired

Slug of the target organisation.

Examplemy-shop

customPriceCzknumber | nullOptional

Negotiated monthly price in WHOLE CZK. Omit to leave unchanged. Pass null to clear the override and fall back to catalogue minus discount. REQUIRED (and ≥ minCustomPriceCzk) for tariffs flagged requiresCustomPrice (Enterprise).

One of 2:

Variant 1

number

Variant 2

null

paidUntilstring | nullOptional

Subscription expiry as ISO date. Omit to leave unchanged. Pass null to clear. After this date the tariff is treated as expired and must be renewed.

One of 2:

Variant 1

string

Variant 2

null

notestringOptional

Admin note attached to the assignment.

Response schema

1 status code documented

200Success

successbooleanRequired

organisationIdnumberRequired

Organisation ID.

tariffIdnumberRequired

Assigned tariff ID.

tariffCodestringRequired

Assigned tariff code.

customPriceCzknumber | nullRequired

Current custom price in CZK, or null.

One of 2:

Variant 1

number

Variant 2

null

paidUntilstring | nullRequired

Paid-until date as ISO string, or null.

One of 2:

Variant 1

string

Variant 2

null

requiresCustomPricebooleanRequired

Whether the tariff requires a custom price.

minCustomPriceCzknumberRequired

Minimum allowed custom price in CZK.

Response example

application/json

{
  "success": false,
  "organisationId": 0,
  "tariffId": 0,
  "tariffCode": "example_tariffCode",
  "requiresCustomPrice": false,
  "minCustomPriceCzk": 0
}

Request example

POST /bff/tariff/set-billing

post

curl -X POST "https://api.bizkithub.com/bff/tariff/set-billing" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "organisationSlug": "my-shop",
  "note": "example_note"
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key