kroz docs
⌘K
kroz.co Abrir app

Integração financeira

Como a kroz coordena a operação com uma instituição de pagamento licenciada.

Responsabilidades

A kroz organiza contratos, recebedores, regras, aprovações, conciliação e evidências. A camada financeira regulada é executada por uma instituição de pagamento habilitada.

Camada Responsabilidade principal
kroz Orquestração, regras, validações, governança e experiência operacional
Parceiro financeiro Contas de pagamento, identificação cadastral, Pix, boleto, liquidação e capacidades reguladas
Organização cliente Veracidade dos dados, contrato comercial, aprovações e uso autorizado

A integração pública permanece independente de nomes comerciais de fornecedores. A relação aplicável a cada operação é definida contratualmente.

Recebedores

Uma parte só pode entrar na distribuição depois de ser identificada e habilitada para receber.

O fluxo esperado é:

  1. coletar os dados necessários para a identificação;
  2. validar o papel da parte no contrato;
  3. encaminhar o cadastro ao parceiro financeiro quando aplicável;
  4. aguardar o estado apto;
  5. vincular a referência financeira ao recebedor na kroz;
  6. liberar o uso na matriz.

Não use o pagador como recebedor apenas porque ambos aparecem no mesmo contrato.

Cobrança e distribuição

Antes de emitir uma cobrança, a operação deve ter:

  • contrato e unidade corretos;
  • pagador identificado;
  • recebedores habilitados;
  • matriz válida e versionada;
  • fechamento aprovado;
  • meio de pagamento e vencimento conferidos.

A intenção de cobrança é enviada com uma referência idempotente. O resultado financeiro retornado pelo parceiro deve ser associado à mesma intenção e à versão de matriz utilizada.

Liquidação e conciliação

Uma confirmação financeira não encerra sozinha a responsabilidade operacional.

A kroz compara:

  • cobrança esperada;
  • valor e data confirmados;
  • matriz vigente;
  • distribuição realizada;
  • eventos já processados.

Diferenças são encaminhadas para conciliação. Ações que alterem o resultado exigem decisão humana quando a política da organização determinar.

Modos de operação

Modo Uso
Homologação Validar integração, regras e reenvios sem efeitos de produção
Modo seguro Preparar e revisar uma intenção antes da execução
Produção Executar somente operações autorizadas e aprovadas

Credenciais, dados e identificadores não devem ser compartilhados entre homologação e produção.

Controles obrigatórios

  • idempotência para qualquer operação mutável;
  • validação de origem e autenticidade de eventos;
  • deduplicação antes de produzir efeitos;
  • timeout e repetição com limites definidos;
  • logs sem credenciais ou dados desnecessários;
  • bloqueio por padrão quando faltar configuração;
  • trilha de auditoria ligada à intenção de negócio;
  • procedimento de interrupção e revogação.

Onboarding técnico

Durante o onboarding, kroz, cliente e parceiro financeiro definem:

  1. ambientes e responsáveis;
  2. recursos e escopos autorizados;
  3. dados necessários e base legal;
  4. credenciais e política de rotação;
  5. eventos, reenvio e deduplicação;
  6. limites, timeout e contingência;
  7. critérios para produção;
  8. conciliação, suporte e evidência.

Detalhes executáveis são compartilhados em canal controlado com os responsáveis aprovados.

Relacionado