reseller

POST `/v1/reseller/gateways/{code}`

Connect or re-key your own payment gateway.

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

Изпратете API ключ като токен за носене. Ключът трябва да притежава разрешението reseller.manage; ключ без него се отхвърля с 403, а не с 404.

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

Този ендпойнт приема org_id като параметър на заявката. Оставете го празен и извикването ще обхване цялото ви поддървано дърво; изпратете го, за да ограничите извикването до една организация.

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

Опитайте

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

curl -X POST https://api.zinndigital.com/v1/reseller/gateways/{code} \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "values": <object> }'

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

Детайли

The credentials are checked against the provider with a real authenticated call before anything is stored, then written to Vault — never to a database row, a log line, an audit entry or an error message. With validate_only the check runs and nothing is stored, returning 200 even when the credentials are rejected, because that is the answer being asked for. Requires reseller.manage.

Параметри

Име	Тип	Задължително	Какво представлява
`code (path)`	`string`	Да	The gateway code — `stripe`, `paypal` or `nowpayments`.
`org_id (query)`	`Uuid`	Не	Which of your organizations this applies to. Required only when you belong to more than one here — otherwise it is inferred, and an id outside your direct memberships is a 404…

Тяло на заявката

Име	Тип	Задължително	Какво представлява
`values`	`object`	Да	`{settings_key: value}` for the fields the gateway declares. Written to Vault, never to a database row, a log line, an audit entry or an error message (CLAUDE.md §2.4).
`mode`	`string<test, live>`	Не	—
`validate_only`	`boolean`	Не	Check the credentials and return the result without storing.

Отговор

Име	Тип	Задължително	Какво представлява
`healthy`	`boolean`	Да	—
`detail`	`string`	Да	—

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

401 · 403 · 404 · 422 · 429 · 503

POST /v1/reseller/gateways/{code}