marketplace

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

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

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

Передайте API-ключ в качестве маркера носителя (bearer token). Эта конечная точка не указывает конкретное разрешение в спецификации, поэтому предоставьте своему ключу минимум необходимых прав и проверьте ответ, вместо того чтобы делать предположения.

Этот эндпоинт не принимает идентификатор организации. Ваш ключ уже определяет организацию, к которой он принадлежит, и ответ ограничивается ее рамками.

Попробовать

Замените всё в угловых скобках на собственные значения, а плейсхолдер ключа — на ключ из вашей панели управления.

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

Вошли в систему? Консоль API в вашей панели управления автоматически подставляет реальный идентификатор вашей организации и ваш собственный ключ, а также выполняет запрос к работающему API, чтобы вы могли увидеть актуальный ответ. Откройте эту конечную точку в API-консоли

Подробнее

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.

Ответ

Имя	Тип	Обязательно	Что это
`permitted`	`boolean`	Да	—
`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>[]`	Да	Every reason at once, not the first — a seller told one problem at a time makes one round trip per problem.

Ошибки, которые может возвращать этот эндпоинт

401 · 404