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}