Saltar para o conteúdo
Tejobit

Pagamentos

Integração Viva Wallet

Junta os pagamentos Viva Wallet do terminal físico e do online num só fluxo, com faturas e reembolsos tratados por webhook.

Pedir esta integração Ver todas as integrações

Visão geral

Viva Wallet

A Viva Wallet (hoje apresentada como Viva) é muito usada em Portugal por restaurantes, cafés e comércio local, pelos terminais de pagamento e pela app que transforma o telemóvel num TPA. Também tem checkout online e links de pagamento.

A Tejobit liga os webhooks da Viva ao sistema da empresa. Um pagamento criado no terminal, no Smart Checkout ou por link dá origem ao mesmo evento, e a ligação trata-o da mesma forma: confirma a transação, atualiza a venda e passa os dados ao programa de faturação.

Para quem usa um POS próprio ou um software de reservas, a ligação também pode enviar o valor a cobrar para o terminal, evitando que alguém tenha de o digitar à mão.

Casos de uso

Para que serve

  • Restaurante que cobra no terminal Viva e quer as vendas no back-office sem fecho manual
  • Loja com venda física e online que precisa de um único registo de pagamentos
  • Clínica ou estúdio que envia links de pagamento antes da consulta
  • Operador turístico que cobra no terminal móvel e confirma a reserva no momento
IN

O que a ligação escuta

  • Webhook Transaction Payment Created quando um pagamento é aceite
  • Transaction Failed para pagamentos recusados
  • Transaction Reversal Created em reembolsos e anulações
  • Nova venda ou reserva no sistema de origem a cobrar no terminal
OUT

O que a ligação faz

  • Criar ordens de pagamento para o Smart Checkout ou para links
  • Enviar um pedido de cobrança para o terminal físico
  • Marcar a venda ou a reserva como paga e guardar o código da transação
  • Pedir a fatura ou a nota de crédito ao programa de faturação
  • Fechar o dia com um resumo de pagamentos por método

Como funciona

Do pedido à ligação em funcionamento

  1. 01

    Pedido

    O formulário indica a integração, as ferramentas envolvidas e o que deve acontecer em cada caso.

  2. 02

    Análise e proposta

    A Tejobit confirma o que a API permite e envia uma proposta com o fluxo, o preço e o prazo.

  3. 03

    Configuração e testes

    A ligação é configurada com as contas do negócio e testada com casos reais antes de ficar ativa.

  4. 04

    Manutenção e monitorização

    A Tejobit aloja a ligação, acompanha os erros e adapta-a quando a API muda.

A ligação corre na infraestrutura da Tejobit. A mensalidade cobre o alojamento, a monitorização e as alterações da API.

O que é preciso preparar

  • Conta Viva com acesso às credenciais de API no painel
  • URL de webhook verificado e os eventos de transação subscritos
  • Identificação dos terminais e da conta de cada loja
  • Acesso ao programa de faturação ou ao POS

Por segurança, não envie passwords, chaves API ou tokens pelo formulário. As credenciais são pedidas por um canal seguro quando a configuração começa.

Limites

  • O envio de cobranças para o terminal só funciona com modelos e configurações que o suportem
  • As credenciais de produção e do ambiente de demonstração são separadas e a passagem exige nova configuração
  • A Viva não emite faturas certificadas pela AT; o programa de faturação continua necessário

Perguntas frequentes

Antes de começar

Os pagamentos do terminal e do site ficam juntos?

Sim. Todos geram o mesmo tipo de evento na Viva, e a ligação regista-os no mesmo sítio, identificando o canal de origem.

O meu POS já tem integração com a Viva. Para que serve esta?

Serve quando o POS não chega a outros sistemas: reservas, faturação noutro programa, uma loja online à parte, ou relatórios que juntam tudo.

Como é verificado o webhook?

A Viva pede uma chave de verificação ao URL antes de ativar o webhook. A ligação responde a esse pedido e, depois, confirma cada transação antes de a dar como paga.

Integrações relacionadas

Ver todas as integrações

Ativar a integração Viva Wallet?

Descreva o que deve passar entre as ferramentas. A resposta confirma a viabilidade, o preço e o prazo.

Fale sobre o projeto geral@tejobit.com