reseller

PATCH `/v1/reseller/currencies`

Choose the currencies, the default, and what you sell in.

ავტორიზაცია

API გასაღები გაგზავნეთ როგორც მატარებელი ტოკენი (bearer token). გასაღებს უნდა ჰქონდეს reseller.manage ნებართვა; ამის გარეშე გასაღები უარყოფილი იქნება 403 და არა 404 სტატუსით.

სwhere your organisation id goes-ის ადგილი

ეს ენდპოინტი იყენებს პარამეტრად org_id. მისი გამოტოვების შემთხვევაში ზარი ფარავს თქვენი იჯარის მთელ ქვეხეს, ხოლო გაგზავნისას ზარი შეიზღუდება მხოლოდ ერთ ორგანიზაციამდე.

თქვენი ორგანიზაციის ID მითითებულია თქვენი სამართავი პანელის API გასაღებების ეკრანზე, თავად გასაღებთან ახლოს. ის ერთნაირია თქვენ მიერ განხორციელებულ ყველა გამოძახებაში.

სცადეთ

შეSubstituted any value inside angle brackets with your own and the key placeholder with a key from your dashboard.

curl -X PATCH https://api.zinndigital.com/v1/reseller/currencies \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

შესული ხართ? თქვენი სამართავ პანელში არსებული API კონსოლი ავტომატურად ამატებს თქვენი რეალური ორგანიზაციის ID-სა და საკუთარ გასაღებს და ატარებს მოთხოვნას ცოცხალ API-ს წინააღმდეგ, რათა იხილოთ რეალური პასუხი. გაAღით ეს ენდპოინტი API კონსოლში

დეტალები

`currencies` replaces the list your clients may be quoted in; send an empty array to go back to offering every currency we can charge. `default_currency` is what a client is quoted in before they choose and must be one you offer. `sell_in_currency` is what you are settled in and is deliberately **not** required to be one of them — a reseller may be paid in one currency and sell in others. `switcher: false` hides the control from your clients. A currency no payment gateway can capture is refused rather than dropped, because a currency we can display and cannot charge is a checkout that fails at the last step. Requires `reseller.manage`.

პარამეტრები

სახელი	ტიპი	სავალდებულო	რა არის ეს
`org_id (query)`	`Uuid`	არა	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…

მოთხოვნის სხეული

სახელი	ტიპი	სავალდებულო	რა არის ეს
`currencies`	`string[]`	არა	Replaces the list your clients may be quoted in. An empty array returns you to offering every currency we can charge.
`default_currency`	`string`	არა	Empty returns to the platform answer. Must be one you offer.
`sell_in_currency`	`string`	არა	Empty returns to the platform base currency. Deliberately not required to be one of `currencies`.
`switcher`	`boolean`	არა	Whether the currency control renders in your clients' panel.

პასუხი

სახელი	ტიპი	სავალდებულო	რა არის ეს
`currencies`	`ResellerCurrency[]`	დიახ	—
`offers_all`	`boolean`	დიახ	You have made no choice, so your clients get every currency.
`offered_count`	`integer`	დიახ	—
`total_count`	`integer`	დიახ	—
`default_currency`	`string`	დიახ	What a client is quoted in before they choose. Empty means the platform answer — their own inference, then USD.
`sell_in_currency`	`string`	დიახ	What you are priced and settled in, resolved — never empty, and never disclosed to your clients.
`switcher`	`boolean`	დიახ	Whether the currency control renders in your clients' panel at all. `false` quotes every client in `default_currency`.

შეცდომები, რომლებიც ამ ენდპოინტს შეუძლია დააბრუნოს

401 · 403 · 404 · 422 · 429

PATCH /v1/reseller/currencies