reseller

POST `/v1/reseller/webhooks/{code}/{orgId}`

Ingest a signed callback from a reseller's OWN payment gateway.

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

Этот эндпоинт является публичным. Он не требует учетных данных и организации — его читают наш собственный маркетинговый сайт и поисковые системы на базе ИИ.

Идентификатор вашей организации

Этот эндпоинт принимает идентификатор вашей организации прямо в URL в качестве orgId. Подставьте его в путь — другие заголовки или параметры запроса не могут его заменить.

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

Попробовать

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

curl -X POST https://api.zinndigital.com/v1/reseller/webhooks/{code}/{orgId}

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

Подробнее

Unauthenticated by design, exactly like the platform callbacks above — the provider's signature over the raw body is the authentication. What differs is whose secret it is verified against: this endpoint resolves the reseller's own credential from Vault first, because /v1/webhooks/{code} verifies against Zinn®'s secret and answers 400 INVALID_SIGNATURE to anything a reseller's account sends it. Without this endpoint a BYO gateway can charge but never settle asynchronously — no SCA completion, no mandate confirmation, no crypto IPN. ⛔ A valid signature is not an authorization to touch a tenant. It proves only that the delivery came from the account we hold keys for; the event may act only on organizations that bill back to this reseller, and anything else is acknowledged with 200 and changes nothing. Replays are expected and converge on a dedupe key namespaced per reseller, so two accounts delivering the same provider event id cannot silently cancel each other out.

Параметры

Имя	Тип	Обязательно	Что это
`code (path)`	`string`	Да	The gateway code — `stripe`, `paypal` or `nowpayments`.
`orgId (path)`	`Uuid`	Да	The RESELLER organization whose own gateway account is calling back. It is in the path because the signing secret is per organization: the engine must resolve their credential…

Ответ

Имя	Тип	Обязательно	Что это
`status`	`string<handled, ignored, duplicate>`	Да	`handled` — acted on. `ignored` — a valid event of a type Zinn® does not consume. `duplicate` — already processed; Stripe may stop redelivering.

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

400 · 404 · 503

POST /v1/reseller/webhooks/{code}/{orgId}