marketplace
GET /v1/marketplace/vendor/ledger
What the seller is owed, and what is still being held.
Упълномощаване
Изпратете API ключ като носител (bearer token). Тази точка за достъп не указва конкретно разрешение в спецификацията, затова дайте на ключа си най-малкото необходимо и проверете отговора, вместо да правите предположения.
Този ендпойнт не изисква идентификатор на организация. Вашият ключ вече идентифицира организацията, към която принадлежи, и отговорът е ограничен до нея.
Опитайте
Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.
curl -X GET https://api.zinndigital.com/v1/marketplace/vendor/ledger \
-H "Authorization: Bearer zdk_live_…"Влязохте ли в профила си? API конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в API конзолата
Детайли
"Funds are held securely by Zinn® until the buyer accepts delivery" (docs/82 §1) is a promise to two people, and the seller is the one who needs to watch it — a balance they cannot see is indistinguishable from not being paid. The three balance figures are computed over every entry by the database, not summed from data. They are kept separate rather than netted because they answer different questions: pending is what no buyer has accepted yet, released is what the next weekly payout run will pay, paid is history.
Параметри
| Име | Тип | Задължително | Какво представлява |
|---|---|---|---|
cursor (query) | string | Не | Opaque cursor from a previous page's page.next_cursor. |
limit (query) | integer | Не | Maximum items to return (page size). |
Отговор
| Име | Тип | Задължително | Какво представлява |
|---|---|---|---|
data | MarketplaceLedgerEntry[] | Да | — |
page | PageMeta | Да | — |
balance | MarketplaceLedgerBalance | Да | Computed by the database over EVERY entry, never summed from the page above it — a paginated list summed in a client is wrong from the second page onward, and wrong about the… |
Грешки, които този крайpoint може да върне
401