R RISITECHDevelopers
API pública em homologação

Uma integração.
Infraestrutura RISITECH.

Conecte seu SaaS à RISITECH por uma interface única. A complexidade de adquirência, credenciamento, terminais, eventos e evolução dos provedores permanece atrás do nosso Core.

Começar integração OpenAPI v1
Contrato API: v1Formato: JSONHTTPS obrigatório
Arquitetura de integração
SaaS do cliente→API RISITECH→CMPR→Infraestrutura homologada

O cliente integra exclusivamente com a RISITECH. Credenciais, endpoints e contratos técnicos de provedores não são expostos.

AbstraçãoIntegração independente de adquirente
IsolamentoEscopo por cliente, Revenda e estabelecimento
AuditoriaRastreabilidade por request_id
VersionamentoContrato estável em /v1
COMECE AQUI

Primeiros passos

O fluxo padrão de integração é composto por credencial de aplicação, Sandbox autorizado, chamadas HTTPS e webhooks assinados. Credenciais são individualizadas por cliente e nunca compartilhadas entre Revendas.

Estado atual: o contrato da API v1 está sendo preparado para homologação externa. Operações financeiras só serão liberadas após a respectiva capacidade estar homologada no Core RISITECH.
AMBIENTES

Separação entre Sandbox e Produção

HOMOLOGAÇÃO

Sandbox

https://sandbox.api.risitech.com.br/v1

Endereço reservado para integrações autorizadas. A disponibilização ocorre por cliente após habilitação.

PRODUÇÃO

LIVE

https://api.risitech.com.br/v1

Será liberado somente após homologação técnica, segurança e capacidades operacionais aprovadas.

SEGURANÇA

Autenticação

A API pública utilizará credenciais próprias RISITECH. Nenhuma credencial de adquirente será fornecida ao cliente.

Authorization: Bearer <access_token>
Content-Type: application/json
Idempotency-Key: <uuid>

O modelo final de emissão/rotação de credenciais será publicado antes da abertura do Sandbox externo.

API V1

Referência funcional

Estes recursos compõem o contrato público previsto. A disponibilidade efetiva será indicada por ambiente e capacidade homologada.

POST/merchants
Cadastrar estabelecimentoCria o cadastro no escopo do cliente para análise e credenciamento.
Homologação
GET/merchants/{id}
Consultar estabelecimentoConsulta dados e estado operacional do cadastro.
Homologação
GET/terminals
Consultar terminaisInventário e associação de equipamentos disponíveis ao escopo autorizado.
Homologação
GET/transactions
Consultar transaçõesSomente registros confirmados por infraestrutura homologada.
Dependência externa
GET/receivables
Consultar recebíveisAgenda baseada exclusivamente em registros oficiais recebidos e conciliados.
Dependência externa
Consultar contrato OpenAPI →
EVENTOS

Webhooks RISITECH

O SaaS receberá eventos RISITECH. O payload original e as credenciais dos provedores permanecem internos.

merchant.updated merchant.approved terminal.updated transaction.updated receivable.updated settlement.updated
A lista definitiva de eventos, assinatura criptográfica, retry e janela de retenção será congelada na homologação do contrato v1.
CONFIABILIDADE

Idempotência

Operações de escrita utilizarão Idempotency-Key para impedir execução duplicada em retries. O Core RISITECH já adota idempotência no contrato interno de eventos de provedores.

DIAGNÓSTICO

Erros e rastreabilidade

{
  "error": {
    "code": "RESOURCE_NOT_AVAILABLE",
    "message": "Recurso indisponível no ambiente atual.",
    "request_id": "req_..."
  }
}

Ao abrir um chamado, envie sempre o request_id, ambiente e endpoint. Nunca envie senha, segredo de API ou token completo.

STATUS

Disponibilidade atual

Developer PortalDisponível
API pública RISITECH v1Contrato e homologação
Sandbox para clientes SaaSLiberação controlada após habilitação
Capacidades financeirasDependem de homologação por operação
ATENDIMENTO TÉCNICO

Fale com Integrações RISITECH

Para dúvidas de integração, homologação, webhooks ou incidentes de API, utilize o canal técnico.

suporte@risitech.com.br
Para integraçãoInforme empresa, ambiente e objetivo da integração.
Para incidenteInforme request_id, endpoint, horário e código HTTP.
Não envieSenhas, client_secret, tokens completos ou dados sensíveis.