reseller

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

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

Упълномощаване

Този крайpoint е публичен. Той не изисква данни за удостоверяване и организация — това е съдържанието, което нашият собствен маркетинг сайт и AI машини за отговори четат.

Където отива идентификаторът на вашата организация

Този краен пункт приема идентификатора на вашата организация директно в URL адреса като orgId. Заменете го в пътя — няма заглавна част или заявков параметър, които да го заместят.

ИД на вашата организация се намира на екрана с API ключове във вашето табло за управление, до самия ключ. Това е същият ИД във всяко заявка, която правите.

Опитайте

Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.

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

Влязохте ли в профила си? API конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в 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.

Грешки, които този крайpoint може да върне

400 · 404 · 503

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