reseller

PUT `/v1/reseller/prices`

Set your own price for one plan.

Autentifikimi

Drgoni një çelës API si një token mbajtës. Çelësi duhet të ketë lejen reseller.manage; një çelës pa të refuzohet me 403, jo 404.

Ku shkon id i organizatës suaj

Ky endpoint pranon org_id si parametër kërkimi. Lëreni bosh dhe thirrja do të mbulojë të gjithë nëndrurin tuaj të qiramarrjes; dërgojeni atë për ta ngushtuar thirrjen në një organizatë të vetme.

ID-ja e organizatës suaj ndodhet në ekranin e çelësave API në panelin tuaj të kontrollit, pranë vetë çelësit. Është i njëjti ID në çdo thirrje që bëni.

Provoje

Zëvendësoni çdo gjë brenda kllapave këndore me vlerat tuaja dhe vendbanuesin e çelësit me një çelës nga paneli juaj.

curl -X PUT https://api.zinndigital.com/v1/reseller/prices \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "plan_id": <Uuid>, "interval": <string>, "currency": <string>, "amount_minor": <integer> }'

Jeni kyçur? Konsola e API-së në panelin tuaj plotëson ID-në tuaj reale të organizatës dhe çelësin tuaj, dhe ekzekuton kërkesën kundrejt API-së live, kështu që ju mund të shihni përgjigjen aktuale. Hapni këtë pikë fundore në konsolën e API-së

Detajet

Upserts one row of your price list, keyed on (plan, interval, currency). Editing it never re-prices a client already sold — their subscription captured the price at purchase. Requires `reseller.manage`.

Parametrat

Emri	Lloji	Kërkohet	Çfarë është kjo
`org_id (query)`	`Uuid`	Jo	Which of your organizations this applies to. Required only when you belong to more than one here — otherwise it is inferred, and an id outside your direct memberships is a 404 r…

Trupi i kërkesës

Emri	Lloji	Kërkohet	Çfarë është kjo
`plan_id`	`Uuid`	Po	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`interval`	`string`	Po	—
`currency`	`string`	Po	—
`amount_minor`	`integer`	Po	—
`is_active`	`boolean`	Jo	—

Përgjigja

Emri	Lloji	Kërkohet	Çfarë është kjo
`id`	`Uuid \| null`	Jo	Null when you have not authored this row yet.
`plan_id`	`Uuid`	Po	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`plan_code`	`string`	Po	—
`plan_name`	`string`	Po	—
`interval`	`string`	Po	—
`currency`	`string`	Po	—
`amount_minor`	`integer`	Po	What YOUR client pays, in minor units.
`is_active`	`boolean`	Po	—
`list_amount_minor`	`object`	Jo	Zinn®'s list price for the same plan.
`wholesale_amount_minor`	`object`	Jo	What the plan costs YOU after your wholesale discount.
`wholesale_discount_bps`	`integer`	Jo	—
`price_source`	`string<price_list, markup, unpriced>`	Po	Whether the price is one you set, one derived from list by your default markup, or absent because the catalogue holds no price in this currency.

Gabimet që ky pikëndalim mund të kthejë

401 · 403 · 404 · 422 · 429