reseller

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

Connect or re-key your own payment gateway.

Autenticação

Envie uma chave de API como um token de portador. A chave deve ter a permissão reseller.manage; uma chave sem ela é recusada com 403, e não 404.

Onde vai o ID da sua organização

Este endpoint aceita org_id como parâmetro de consulta. Omita-o e a chamada abrangerá toda a sua subárvore de locatários; envie-o para restringir a chamada a uma única organização.

O ID da sua organização está na tela de chaves de API no seu painel, ao lado da própria chave. É o mesmo ID em todas as chamadas que você fizer.

Experimente

Substitua qualquer item entre colchetes por seus próprios valores e o espaço reservado para a chave por uma chave do seu painel.

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

Conectado? O console da API no seu painel preenche o ID da sua organização real e a sua própria chave, e executa a requisição contra a API de produção para que você possa ver a resposta real. Abra este endpoint no console da API

Detalhes

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

Parâmetros

Nome	Tipo	Obrigatório	O que é
`code (path)`	`string`	Sim	The gateway code — `stripe`, `paypal` or `nowpayments`.
`org_id (query)`	`Uuid`	Não	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…

Corpo da requisição

Nome	Tipo	Obrigatório	O que é
`values`	`object`	Sim	`{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>`	Não	—
`validate_only`	`boolean`	Não	Check the credentials and return the result without storing.

Resposta

Nome	Tipo	Obrigatório	O que é
`healthy`	`boolean`	Sim	—
`detail`	`string`	Sim	—

Erros que este endpoint pode retornar

401 · 403 · 404 · 422 · 429 · 503