BizKitHub
DocsAPI ReferenceTariff/bff/tariff/change
postTariffAdmin BFF

/bff/tariff/change

One-call tariff change for white-label partners (vendor of the target organisation) and internal admins: plan, negotiated price and paid-until are validated together and written in one changeTariff transaction (audited: ORG_TARIFF_CHG system log + activity). Enterprise without a price ≥ minimum is rejected up front. Discount and salesperson stay internal-admin only (/bff/admin/organisation-tariff-change).

TariffpostBffTariffChange

Parameters

JSON body

Request body

application/json
organisationSlugstringRequired

Slug of the target organisation.

Examplewabo-trade-s-r-o
tariffIdnumberRequired

Tariff to assign. May equal the current one to edit price / paid-until only.

Example3
customPriceCzkstring | integer | nullOptional
One of 2:
Variant 1
string | integer

Negotiated monthly price in whole CZK. Required (≥ minCustomPriceCzk) for plans with requiresCustomPrice (Enterprise). Omit to keep; null clears it (catalogue price).

One of 2:
Variant 1
stringinteger
Default: 0
Variant 2
integer

Negotiated monthly price in whole CZK. Required (≥ minCustomPriceCzk) for plans with requiresCustomPrice (Enterprise). Omit to keep; null clears it (catalogue price).

Range: 0–∞
Variant 2
null
paidUntilstring | nullOptional
One of 2:
Variant 1
string

Paid-until / renewal date (ISO). Null clears it. Omit to keep.

Example2027-01-31
Variant 2
null
notestring | nullOptional
One of 2:
Variant 1
string

Note attached to the assignment.

Length: 0–2000
Variant 2
null

Response schema

1 status code documented

200Success
successbooleanRequired
changedbooleanRequired

False when nothing differed from the current state.

tariffSwitchedbooleanRequired

True when the plan itself changed.

tariffCodestringRequired
customPriceCzknumber | nullRequired
One of 2:
Variant 1
number
Variant 2
null
paidUntilstring | nullRequired
One of 2:
Variant 1
string
Variant 2
null

Response example

application/json
{
  "success": false,
  "changed": false,
  "tariffSwitched": false,
  "tariffCode": "example_tariffCode"
}

Request example

POST /bff/tariff/change

post
curl -X POST "https://api.bizkithub.com/bff/tariff/change" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "organisationSlug": "wabo-trade-s-r-o",
  "tariffId": 3
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key