reseller

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

Connect or re-key your own payment gateway.

Autentifikimi

Drgoni një çelës API si një token mbajtës. Çelësi duhet të ketë lejen reseller.manage; një çelës pa të refuzohet me 403, jo 404.

Ku shkon id i organizatës suaj

Ky endpoint pranon org_id si parametër kërkimi. Lëreni bosh dhe thirrja do të mbulojë të gjithë nëndrurin tuaj të qiramarrjes; dërgojeni atë për ta ngushtuar thirrjen në një organizatë të vetme.

ID-ja e organizatës suaj ndodhet në ekranin e çelësave API në panelin tuaj të kontrollit, pranë vetë çelësit. Është i njëjti ID në çdo thirrje që bëni.

Provoje

Zëvendësoni çdo gjë brenda kllapave këndore me vlerat tuaja dhe vendbanuesin e çelësit me një çelës nga paneli juaj.

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

Jeni kyçur? Konsola e API-së në panelin tuaj plotëson ID-në tuaj reale të organizatës dhe çelësin tuaj, dhe ekzekuton kërkesën kundrejt API-së live, kështu që ju mund të shihni përgjigjen aktuale. Hapni këtë pikë fundore në konsolën e API-së

Detajet

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`.

Parametrat

Emri	Lloji	Kërkohet	Çfarë është kjo
`code (path)`	`string`	Po	The gateway code — `stripe`, `paypal` or `nowpayments`.
`org_id (query)`	`Uuid`	Jo	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 r…

Trupi i kërkesës

Emri	Lloji	Kërkohet	Çfarë është kjo
`values`	`object`	Po	`{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>`	Jo	—
`validate_only`	`boolean`	Jo	Check the credentials and return the result without storing.

Përgjigja

Emri	Lloji	Kërkohet	Çfarë është kjo
`healthy`	`boolean`	Po	—
`detail`	`string`	Po	—

Gabimet që ky pikëndalim mund të kthejë

401 · 403 · 404 · 422 · 429 · 503