OpenPix
Disponível
A OpenPix é a integração Pix do NivoPay. Ela permite preparar cobranças Pix e acompanhar seus estados, mas não processa cartão.
Onde é utilizada
A integração pode participar de dois contextos distintos:
- Cobrança rápida na Sidebar: o operador prepara a cobrança durante um atendimento autorizado.
- Orçamento público: o Pix pode ser oferecido no orçamento quando esse contexto estiver separadamente ativado para a empresa.
As duas formas de uso possuem ativações próprias. Ter a OpenPix disponível em um contexto não libera automaticamente o outro.
Configuração
A conexão é configurada no Painel Admin e pertence à empresa que realizará a cobrança. O salvamento da credencial e a validação da conexão são etapas separadas.
Depois de salva, a credencial permanece protegida e não é devolvida à interface. A operação só fica disponível quando as condições de acesso, ativação e validação aplicáveis ao contexto estiverem atendidas.
Fluxo técnico
- O operador prepara o valor e as condições da cobrança.
- O backend autentica a solicitação e verifica a ativação aplicável.
- Uma correlação própria é criada para relacionar a cobrança ao atendimento.
- A credencial protegida da empresa é resolvida somente no backend.
- A API oficial da OpenPix cria ou localiza a cobrança correspondente.
- O código Pix, o QR Code ou o link retornam para a experiência autorizada.
- O cliente autoriza o pagamento no aplicativo de sua instituição financeira.
- Quando um evento é recebido, sua validade é conferida.
- O estado da cobrança é novamente consultado na OpenPix.
- A confirmação é aceita somente depois das validações aplicáveis.
Quem faz o quê
NivoPay
Controla acesso, valor, correlação, integração e auditoria operacional da cobrança.
OpenPix
Cria e acompanha a cobrança Pix, disponibilizando código, estado e eventos compatíveis com a integração.
Banco do cliente
Realiza a autenticação do cliente e a autorização financeira no ambiente da própria instituição.
Dados processados
O Nivo não armazena senha bancária, credencial do pagador, número de cartão, código de segurança ou dados de autenticação financeira. Ele mantém somente os registros operacionais necessários para relacionar a cobrança ao atendimento, acompanhar seu estado e produzir auditoria sanitizada.
Segurança implementada
- Credencial protegida e isolada por empresa.
- Correlação e idempotência para relacionar a operação à cobrança correta.
- Validação dos eventos suportados antes de aceitar seu efeito.
- Nova conferência no provider antes da confirmação.
- Rejeição quando o valor retornado diverge da cobrança registrada.
- Respostas e registros sanitizados.
- Estado incerto tratado sem retry ou fallback cego.
Validação da conexão
A configuração passa por um precheck de disponibilidade e por um teste final controlado. Essas etapas verificam a conexão e o retorno técnico necessário, mas nenhum pagamento real é realizado durante a validação da credencial.
Salvar a credencial, validar a conexão e realizar uma cobrança são ações diferentes.
Estados e limites
- Aguardando pagamento: a cobrança foi preparada, mas ainda não houve confirmação válida.
- Confirmado: as validações aplicáveis foram concluídas e o estado foi confirmado no provider.
- Expirado ou não concluído: a cobrança perdeu a validade ou não chegou a uma confirmação aceita.
- Integração indisponível: a configuração, a conexão ou o provider não permitem concluir o fluxo naquele momento.
A confirmação depende da configuração correta e da disponibilidade do provider. A integração não garante pagamento, confirmação instantânea ou disponibilidade contínua.
Evolução contínua de segurança
Os controles da integração são revisados conforme a evolução do produto, do provider e das práticas aplicáveis. Alterações relevantes passam por validação técnica e revisão antes de serem apresentadas como capacidade disponível.
Este portal mantém a explicação em nível institucional e não publica detalhes que reduzam a proteção da operação.