reseller

PUT `/v1/reseller/prices`

Set your own price for one plan.

Autentifikacija

Pošaljite API ključ kao bearer token. Ključ mora imati dozvolu reseller.manage; ključ bez nje se odbija sa 403, a ne sa 404.

Gde ide ID vaše organizacije

Ova krajnja tačka prihvata org_id kao parametar upita. Izostavite ga i poziv obuhvata celokupno stablo vašeg zakupca; pošaljite ga da biste suzili poziv na jednu organizaciju.

ID vaše organizacije nalazi se na ekranu sa API ključevima u vašoj kontrolnoj tabli, pored samog ključa. To je isti ID u svakom pozivu koji uputite.

Isprobajte

Zamenite bilo šta u uglastim zagradama sopstvenim vrednostima, a ključni placeholder sa ključem sa vaše kontrolne table.

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

Prijavljeni ste? API konzola na vašoj kontrolnoj tabli automatski popunjava ID vaše stvarne organizacije i vaš sopstveni ključ, i izvršava zahtev nad API-jem uživo tako da možete videti stvarni odgovor. Otvorite ovu krajnju tačku u API konzoli

Detalji

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`.

Parametri

Naziv	Vrsta	Obavezno	Šta je ovo
`org_id (query)`	`Uuid`	Ne	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…

Telo zahteva

Naziv	Vrsta	Obavezno	Šta je ovo
`plan_id`	`Uuid`	Da	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`interval`	`string`	Da	—
`currency`	`string`	Da	—
`amount_minor`	`integer`	Da	—
`is_active`	`boolean`	Ne	—

Odgovor

Naziv	Vrsta	Obavezno	Šta je ovo
`id`	`Uuid \| null`	Ne	Null when you have not authored this row yet.
`plan_id`	`Uuid`	Da	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`plan_code`	`string`	Da	—
`plan_name`	`string`	Da	—
`interval`	`string`	Da	—
`currency`	`string`	Da	—
`amount_minor`	`integer`	Da	What YOUR client pays, in minor units.
`is_active`	`boolean`	Da	—
`list_amount_minor`	`object`	Ne	Zinn®'s list price for the same plan.
`wholesale_amount_minor`	`object`	Ne	What the plan costs YOU after your wholesale discount.
`wholesale_discount_bps`	`integer`	Ne	—
`price_source`	`string<price_list, markup, unpriced>`	Da	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.

Greške koje ovaj krajnji tačka može da vrati

401 · 403 · 404 · 422 · 429