Documentation Index
Fetch the complete documentation index at: https://docs.foodsave.kz/llms.txt
Use this file to discover all available pages before exploring further.
Commission API
Base path: /api/v1/admin/commissions
Overview
Manage global and partner-specific commission rates.
Commission changes affect order economics immediately and should be coordinated with finance and partner ops.
Global rate
Partner override
Python
curl --request GET \
--url https://api.foodsave.kz/api/v1/admin/commissions/global \
-H 'Authorization: Bearer $ADMIN_TOKEN'
curl --request PUT \
--url https://api.foodsave.kz/api/v1/admin/commissions/partners/p-1 \
-H 'Authorization: Bearer $ADMIN_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"ratePercent":10.0}'
import os
import requests
response = requests.get(
'https://api.foodsave.kz/api/v1/admin/commissions/global',
headers={'Authorization': f"Bearer {os.environ['ADMIN_TOKEN']}"}
)
print(response.json())
GET /api/v1/admin/commissions/global
{ "ratePercent": 12.5, "override": false }
PUT /api/v1/admin/commissions/global
{ "ratePercent": 13.0, "override": true }
GET /api/v1/admin/commissions/partners/{id}
{ "ratePercent": 10.0, "override": true }
PUT /api/v1/admin/commissions/partners/{id}
{ "ratePercent": 10.0, "override": true }
DELETE /api/v1/admin/commissions/partners/{id}
Commission deletes revert the partner back to the global rate immediately.