reseller

PUT `/v1/reseller/prices`

Set your own price for one plan.

Autentifikacija

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

Gdje dolazi ID vaše organizacije

Ova krajnja točka uzima org_id kao parametar upita. Izostavite ga i poziv obuhvaćett cijelo stablo vašeg najma; pošaljite ga kako biste suzili poziv na jednu organizaciju.

ID vaše organizacije nalazi se na zaslonu API ključeva u vašoj nadzornoj ploči, pored samog ključa. To je isti ID u svakom pozivu koji uputite.

Isprobajte

Zamijenite sve unutar šiljastih zagrada svojim vlastitim vrijednostima, a rezervirano mjesto za ključ s ključem iz vaše nadzorne ploče.

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 nadzornoj ploči automatski unosi stvarni ID vaše organizacije i vaš vlastiti ključ te šalje zahtjev prema aktivnom API-ju kako biste mogli vidjeti stvarni odgovor. Otvori ovu krajnju točku u API konzoli

Pojedinosti

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	Što je to
`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…

Tijelo zahtjeva

Naziv	Vrsta	Obavezno	Što je to
`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	Što je to
`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.

Pogreške koje ova krajnja točka može vratiti

401 · 403 · 404 · 422 · 429