Documentacao

Uway Gateway Docs

Hub tecnico do produto

Documentacao oficial do Uway Gateway

Central tecnica da plataforma com arquitetura, operacao, integracao por chave, billing, observabilidade e fluxos essenciais para producao.

Saude do sistema

/api/system/status

Consultando status...

App

Uway Gateway

Locale

pt_BR

Queue

database

Ambiente

local

168+

Rotas

Asaas, Mercado Pago + modular

Gateways

Sandbox e Production

Ambientes

Carteira + consumo

Billing

Visao geral

Produto, proposta e escopo

O Uway Gateway e uma plataforma para centralizar integracoes de pagamento, padronizar contratos de API e permitir que cada merchant opere com varios gateways sem reescrever sua integracao a cada provider.

Abrir secao

Arquitetura

Divisao de dominios

A arquitetura foi separada por dominio funcional para manter a Client Api previsivel, consistente e preparada para crescer com novos gateways e novas capacidades.

Abrir secao

Observabilidade

Status, falhas e saude do ecossistema

A observabilidade do produto foi desenhada para responder rapidamente tres perguntas: o sistema esta saudavel, qual gateway esta falhando e qual rotina automatica ficou para tras.

Abrir secao

Autenticacao

Visao geral da autenticacao

A documentacao publica foca na autenticacao da Client Api, usada para integracoes server-to-server com chaves proprias do merchant.

Abrir secao

Autenticacao

Fluxo de autenticacao da Client Api

A Client Api tem um endpoint de autenticacao explicita e um endpoint de introspeccao do api client autenticado. A autenticacao explicita aceita credenciais no body JSON ou via headers `X-API-PUBLIC-KEY` e `X-API-SECRET-KEY`.

Abrir secao

Client Api

Pagamentos

Endpoints para criar, listar, consultar e acompanhar status de pagamentos. O formato recomendado da Uway usa um payload enxuto com blocos opcionais `checkout`, `payment_options` e `payment_source`. Campos antigos em formato plano continuam aceitos por compatibilidade, mas a recomendacao e usar o shape simplificado daqui para frente. Pix e boleto seguem o mesmo fluxo padronizado; em cartao, o provider pode aceitar `card_token` ou dados brutos dependendo da capability da conta selecionada.

Abrir secao