marketplace

GET /v1/marketplace/vendor/ledger

What the seller is owed, and what is still being held.

Све marketplace крајње тачке

Сва документација за програмере →

Аутентификација

Пошаљите API кључ као bearer токен. Ова крајња тачка не наводи конкретну дозволу у спецификацији, па свом кључу доделите најмања неопходна овлашћења и проверите одговор уместо да претпостављате.

Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.

Испробајте

Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.

curl -X GET https://api.zinndigital.com/v1/marketplace/vendor/ledger \
  -H "Authorization: Bearer zdk_live_…"

Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у 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).

Одговор

НазивТипОбавезноШта је ово
dataMarketplaceLedgerEntry[]Да—
pagePageMetaДа—
balanceMarketplaceLedgerBalanceДа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…

Грешке које ова крајња тачка може вратити

401