reseller

PATCH `/v1/reseller/currencies`

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

Πισtoποίηση

Στείλτε ένα κλειδί API ως διακριτικό φορέα (bearer token). Το κλειδί πρέπει να διαθέτει το δικαίωμα reseller.manage· ένα κλειδί που δεν το διαθέτει απορρίπτεται με 403, όχι 404.

Πού μπαίνει το αναγνωριστικό του οργανισμού σας

Αυτό το τελικό σημείο δέχεται την παράμετρο org_id ως παράμετρο ερωτήματος. Παραλείψτε την και η κλήση καλύπτει ολόκληρο το υποδέντρο μίσθωσής σας· στείλτε την για να περιορίσετε την κλήση σε έναν οργανισμό.

Το αναγνωριστικό του οργανισμού σας βρίσκεται στην οθόνη των κλειδιών API στον πίνακα ελέγχου σας, δίπλα στο ίδιο το κλειδί. Είναι το ίδιο αναγνωριστικό σε κάθε κλήση που πραγματοποιείτε.

Δοκιμάστε το

Ατικatastήstε ό,τι βρίskεtai μέσα σe γώniaδeς μe τis δikές sas timές, kai to placeholder klεidioύ μe éna klεidi apó ton pinaka ελέgchou sas.

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

Παράμετροι

Όνομα	Τύpος	Υποχρεωτικό	Τι είναι
`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…

Σώμα αίτησης

Όνομα	Τύpος	Υποχρεωτικό	Τι είναι
`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.

Απάντηση

Όνομα	Τύpος	Υποχρεωτικό	Τι είναι
`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