reseller

POST `/v1/reseller/client-wallets/{walletId}/adjustments`

Correct a client's balance.

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 POST https://api.zinndigital.com/v1/reseller/client-wallets/{walletId}/adjustments \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "amount_minor": <integer>, "reason": <string> }'

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

Signed — positive credits, negative takes back. ⛔ A negative adjustment that would put the client below zero is refused with 422 naming what is available: you may correct your own mistake, you may not push a customer into debt. `reason` is required and the client sees it on their statement. A wallet belonging to another reseller answers 404, never 403, so this is not an existence oracle. Requires `reseller.manage`.

Parametry

Nazwa	Typ	Wymagane	Co to jest
`walletId (path)`	`Uuid`	Tak	—
`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
`amount_minor`	`integer`	Tak	Signed minor units. ⛔ Cannot take the client below zero.
`reason`	`string`	Tak	Required, and the client sees it on their statement. An unexplained movement of somebody else's money is the first thing an audit asks about.

Odpowiedź

Nazwa	Typ	Wymagane	Co to jest
`org_id`	`Uuid`	Tak	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`currency`	`string`	Tak	—
`balance_minor`	`integer`	Tak	What you are owed — the float your provider is holding for you.
`spendable_minor`	`integer`	Tak	What you can spend today. Lower than `balance_minor` when your provider's reseller programme is suspended: the deposit is still yours, but nobody is delivering service again…
`reseller_org_id`	`Uuid \| null`	Nie	The provider whose float this is.
`entries`	`ClientWalletEntry[]`	Tak	—
`other_floats`	`ClientOtherFloat[]`	Tak	Balances a previous provider still holds for you. ⛔ Normally empty. A client who changed provider is still owed what the old one took; omitting it would make that money disa…
`provider`	`string<reseller, zinn>`	Nie	⭐ Who is holding this money. One screen serves both, because "credit you hold with your provider" is one question whose answer depends on the customer, not on the feature.…
`purses`	`WalletPurse[]`	Nie	The owner's "one ledger, named purses" — a balance may be restricted to a kind of spending. ⛔ Empty for a reseller float, which has no purses. A purse whose authoritative stor…

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

401 · 403 · 404 · 422 · 429