reseller

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

Connect or re-key your own payment gateway.

Автентифікація

Надішліть ключ API як маркер носія (bearer token). Ключ повинен мати дозвіл 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, щоб ви могли побачити справжню відповідь. Відкрийте цю кінцеву точку в консолі 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`	Так	—

Помилки, які може повертати ця кінцева точка

401 · 403 · 404 · 422 · 429 · 503

POST /v1/reseller/gateways/{code}