reseller
PATCH /v1/reseller/currencies
Choose the currencies, the default, and what you sell in.
Аутентификация
API кілтін bearer токені ретінде жіберіңіз. Кілтте reseller.manage рұқсаты болуы тиіс; онсыз кілтке 404 емес, 403 қатесі қайтарылады.
Ұйымыңыздың идентификаторы орналасатын жер
Бұл соңғы нүкте сұрау параметрі ретінде org_id мәнін қабылдайды. Оны бос қалдырсаңыз, шақыру бүкіл жалға алушы тармағын қамтиды; шақыруды бір ұйымға шектеу үшін оны жіберіңіз.
Сіздің ұйым идентификаторыңыз басқару панеліндегі API кілттері экранында, кілттің өзінің жанында орналасқан. Бұл сіз жасайтын әрбір шақырудағы бірдей идентификатор.
Әрекет етіп көру
Бұрыштық жақшалардағы кез келген нәрсені өз мәндеріңізбен, ал кілт орналастырушысын басқару тақтасынан алынған кілтпен алмастырыңыз.
curl -X PATCH https://api.zinndigital.com/v1/reseller/currencies \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ }'Жүйеге кіргенсіз бе? Бақылау тақтасындағы API консолі ұйымыңыздың нақты идентификаторы мен жеке кілтіңізді автоматты түрде толтырады да, нақты жауапты көре алуыңыз үшін сұрауды тікелей жұмыс істеп тұрған API арқылы орындайды. Бұл соңғы нүктені 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`.
Параметрлер
| Аты | Tүрі | Міндетті | Мазмұны |
|---|---|---|---|
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… |
Сұрау денесі
| Аты | Tүрі | Міндетті | Мазмұны |
|---|---|---|---|
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. |
Жауап
| Аты | Tүрі | Міндетті | Мазмұны |
|---|---|---|---|
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