reseller

PUT `/v1/reseller/prices`

Set your own price for one plan.

Uwierzytelnianie

Wyślij klucz API jako token bearer. Klucz musi posiadać uprawnienie reseller.manage; klucz bez niego jest odrzucany z kodem 403, a nie 404.

Miejsce na identyfikator organizacji

Ten punkt końcowy przyjmuje org_id jako parametr zapytania. Pomiń go, a wywołanie obejmie całe drzewo dzierżawy; prześlij go, aby ograniczyć wywołanie do jednej organizacji.

Identyfikator Twojej organizacji znajduje się na ekranie kluczy API w Twoim panelu, obok samego klucza. Jest to ten sam identyfikator w każdym wywołaniu, które wykonujesz.

Wypróbuj

Zastąp wszystko w nawiasach ostrych własnymi wartościami, a zastępczy znacznik klucza kluczem ze swojego pulpitu nawigacyjnego.

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

Zalogowany? Konsola API w Twoim panelu uzupełnia rzeczywiste identyfikator organizacji oraz Twój własny klucz i wykonuje żądanie względem aktywnego API, dzięki czemu możesz zobaczyć rzeczywistą odpowiedź. Otwórz ten punkt końcowy w konsoli API

Szczegóły

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

Parametry

Nazwa	Typ	Wymagane	Co to jest
`org_id (query)`	`Uuid`	Nie	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…

Treść żądania

Nazwa	Typ	Wymagane	Co to jest
`plan_id`	`Uuid`	Tak	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`interval`	`string`	Tak	—
`currency`	`string`	Tak	—
`amount_minor`	`integer`	Tak	—
`is_active`	`boolean`	Nie	—

Odpowiedź

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

Błędy, które ten punkt końcowy może zwrócić

401 · 403 · 404 · 422 · 429