marketplace

GET `/v1/marketplace/vendor/payout-readiness`

Whether money may leave the platform to this seller, and why not.

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/payout-readiness \
  -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

docs/82 §7a: *"the vendor is told exactly why and what to do."* ⭐ The same computation the payout runner performs, rendered for the seller. One producer, two audiences — a screen that re-derived the reasons would drift from the gate, and the drift would show as a seller told they are ready while the runner refuses. ⛔ Verification is optional until the first payout and then mandatory. An unverified seller may list, sell and be accepted; it is the **payout** that is held, never the sale.

Resposta

Nome	Tipo	Obrigatório	O que é
`permitted`	`boolean`	Sim	—
`reasons`	`string<no_verification, verification_not_approved, document_expired, document_missing, subject_not_approved, sanctions_not_screened, sanctions_not_clear, document_request_holds_payouts, vendor_not_approved, no_destination, destination_cooling_off, dac7_data_incomplete>[]`	Sim	Every reason at once, not the first — a seller told one problem at a time makes one round trip per problem.

Erros que este endpoint pode retornar

401 · 404