Autenticação e restrição de origem - Guia Nexus

A API Nexus exige comunicação via mTLS (Mutual TLS) para a segurança de transporte e autenticação Bearer Token para gerenciar as sessões.

Para obter acesso inicial à API, solicite seu cadastro de integração através do e-mail infraestrutura@ticto.com.br informando sua demanda. Você receberá suas chaves brutas de acesso (client_id e token).

Após configurado, o ecossistema utilizará um esquema de autenticação duplo (protegido por middlewares específicos), dependendo do escopo da operação:

Client Token

Rotas globais e públicas, como a criação de novos usuários ou a geração de checkouts, exigem um token de autorização do sistema/cliente parceiro.Header: X-Api-Client-Token

User Token

Rotas restritas a dados de um produtor específico (como criar produtos, contas bancárias ou solicitar saques) exigem, além do Client Token, o token de sessão do produtor logado.Header: padrão OAuth 2.0 · Authorization: Bearer <user_token>

Exemplo de headers em requisições logadas

POST /api/v1/products HTTP/1.1
Host: https://nexus.ticto.cloud/api/v1/
Content-Type: application/json
Accept: application/json
X-Api-Client-Token: <seu_client_auth_token>
Authorization: Bearer <seu_user_public_token>