Stripe

Disponível

A Stripe é a integração de cartão do NivoPay por meio de Checkout hospedado. Os dados sensíveis do cartão são preenchidos no ambiente da Stripe, enquanto o backend do NivoPay prepara a cobrança e acompanha seu estado.

Onde é utilizada

Na cobrança rápida da Sidebar, o operador pode preparar uma cobrança por cartão para o valor original, um valor com desconto, uma entrada ou o total do atendimento. O link é devolvido à Sidebar e seu envio ao cliente é uma ação humana.

O cartão Stripe ainda não está disponível na página pública de orçamento. A disponibilidade na Sidebar não implica ativação automática em outro contexto.

Configuração no Painel Admin

Cada empresa conecta sua própria conta Stripe no Painel Admin. O salvamento da credencial e a validação da conexão são etapas separadas.

Quando há mais de uma integração de cartão disponível, a empresa escolhe explicitamente o provider padrão. Para que a confirmação automática funcione, o webhook da conexão também precisa estar configurado corretamente.

Fluxo técnico

  1. O backend autentica a sessão e verifica se o NivoPay está ativado para a empresa.
  2. O valor escolhido e uma correlação própria da cobrança são registrados.
  3. A operação recebe proteção de idempotência antes do contato com o provider.
  4. O backend resolve a credencial protegida da conexão Stripe da empresa.
  5. Uma Checkout Session de pagamento único é criada pela API oficial.
  6. O link do Checkout hospedado retorna para a Sidebar.
  7. O operador envia esse link ao cliente de forma humana.
  8. O cliente preenche os dados do cartão no ambiente da Stripe.
  9. O retorno do navegador é apresentado como em análise, sem confirmar isoladamente o pagamento.
  10. Um evento assinado é recebido e validado sobre o corpo original da requisição.
  11. A empresa, a conexão, o ambiente e o valor são comparados com a cobrança registrada.
  12. A confirmação é aceita somente depois de um evento compatível com o estado esperado.

Quem faz o quê

NivoPay

Controla acesso, ativação, valor, correlação, idempotência, integração com o provider e auditoria sanitizada. Também impede que um retorno de navegação confirme prematuramente a cobrança.

Stripe

Hospeda o Checkout, recebe os dados do cartão, coordena o processamento da tentativa e emite os eventos da cobrança.

Bandeira, adquirência e banco emissor

Participam da autorização financeira e podem aprovar ou recusar a tentativa conforme suas regras e análises.

Operador e cliente

O operador prepara e envia o link. O cliente confere as condições e informa os dados do cartão diretamente no Checkout da Stripe.

Dados processados

O Nivo não armazena número completo do cartão, CVC, senha bancária ou dados de autenticação financeira. Ele mantém somente referências operacionais, valor, moeda, estado, validade e auditoria sanitizada necessários para relacionar e acompanhar a cobrança.

Segurança implementada

  • Credencial protegida e isolada por empresa.
  • Acesso ao provider realizado somente pelo backend.
  • Idempotência aplicada localmente e na criação feita no provider.
  • Validação de Stripe-Signature sobre o corpo original recebido.
  • Compatibilidade verificada entre evento, empresa, conexão e ambiente.
  • Divergência de valor rejeitada antes da atualização do estado.
  • Eventos repetidos tratados de forma idempotente.
  • Registros e respostas operacionais sanitizados.
  • Retorno do navegador tratado sem confirmação prematura.

Validação da conexão

A validação consulta de forma controlada a conta conectada e verifica se ela está habilitada para cobranças. Esse processo não cria Checkout, não solicita cartão e não realiza pagamento.

Estados

  • Aguardando conclusão: o Checkout foi preparado, mas ainda não existe confirmação compatível.
  • Confirmado: um evento válido e compatível confirmou a cobrança.
  • Recusado ou não concluído: a tentativa falhou ou não chegou ao estado de confirmação.
  • Expirado: a validade do Checkout terminou sem conclusão.
  • Integração indisponível: a conexão, a ativação ou o provider não permitem criar ou acompanhar a cobrança naquele momento.

Limites atuais

A versão atual envia uma cobrança única e não configura uma política própria de parcelamento, assinatura ou cobrança recorrente. Esses recursos não são apresentados como capacidades disponíveis.

A aprovação do cartão depende das instituições participantes e não é garantida pelo NivoPay. A confirmação automática também depende da conexão e do webhook corretamente configurados.

Referências oficiais

Continue