marketplace
GET /v1/marketplace/vendor/ledger
What the seller is owed, and what is still being held.
Autenticação
Envie uma chave de API como um token bearer. Este endpoint não especifica uma permissão específica na documentação, portanto, conceda à sua chave o mínimo necessário e verifique a resposta em vez de assumir.
Este endpoint não requer um ID de organização. Sua chave já identifica a organização à qual pertence, e a resposta é delimitada a ela.
Experimente
Substitua qualquer item entre colchetes por seus próprios valores e o espaço reservado para a chave por uma chave do seu painel.
curl -X GET https://api.zinndigital.com/v1/marketplace/vendor/ledger \
-H "Authorization: Bearer zdk_live_…"Conectado? O console da API no seu painel preenche o ID da sua organização real e a sua própria chave, e executa a requisição contra a API de produção para que você possa ver a resposta real. Abra este endpoint no console da API
Detalhes
"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.
Parâmetros
| Nome | Tipo | Obrigatório | O que é |
|---|---|---|---|
cursor (query) | string | Não | Opaque cursor from a previous page's `page.next_cursor`. |
limit (query) | integer | Não | Maximum items to return (page size). |
Resposta
| Nome | Tipo | Obrigatório | O que é |
|---|---|---|---|
data | MarketplaceLedgerEntry[] | Sim | — |
page | PageMeta | Sim | — |
balance | MarketplaceLedgerBalance | Sim | 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… |
Erros que este endpoint pode retornar
401