marketplace
GET /v1/marketplace/vendor/ledger
What the seller is owed, and what is still being held.
Doğrulama
API açarını bearer token kimi göndərin. Bu səhifə spresifikasiyada xüsusi icazə tələb etmir, buna görə də açarınıza ehtiyac duyduğu minimum səviyyədə icazə verin və güman etmək əvəzinə cavabı yoxlayın.
Bu endpoint heç bir təşkilat ID-si tələb etmir. Sizin açarınız artıq aid olduğu təşkilatı müəyyən edir və cavab həmin təşkilat üçün məhdudlaşdırılır.
Sınaqdan keçir
Bucaqlı mötərizələrdə olan hór şeyi öz qiymətlərinizlə, açar yertutucusunu isə idarə panelinizdən bir açarla əvəz edin.
curl -X GET https://api.zinndigital.com/v1/marketplace/vendor/ledger \
-H "Authorization: Bearer zdk_live_…"Sistemə daxil olmusunuz? İdarə panelinizdəki API konsolu real təşkilatınızın identifikatorunu və öz açarınızı avtomatik doldurur, sorğunu canlı API-yə qarşı icra edir ki, siz faktiki cavabı görə biləsiniz. Bu son nöqtəni API konsolunda açın
Təfərrüatlar
"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.
Parametrlər
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
cursor (query) | string | Xeyr | Opaque cursor from a previous page's `page.next_cursor`. |
limit (query) | integer | Xeyr | Maximum items to return (page size). |
Cavab
| Ad | Tip | Tələb olunur | Nədir |
|---|---|---|---|
data | MarketplaceLedgerEntry[] | Bəli | — |
page | PageMeta | Bəli | — |
balance | MarketplaceLedgerBalance | Bəli | 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 ve… |
Bu son nöqtənin qaytara biləcəyi xətalar
401