As fontes são utilizadas para identificar e gerir pagamentos online efetuados através do Smart Checkout, de plugins e de outras payment tools. Pode encontrar mais informações sobre cada opção no Viva.com Developer Portal, respetivamente nas secções Smart Checkout, Plugins e Payment tools.
➡️ Adicionar uma fonte
Para adicionar uma fonte para pagamentos online, siga estes passos:
Inicie sessão no Viva.com e selecione a conta relevante (demo ou real).
Vá a Vendas → Pagamentos online → Websites/Apps.
Selecione Adicionar Website/App.
Preencha os detalhes necessários na janela pop-up da seguinte forma:
Código – O número de quatro dígitos no canto superior esquerdo do campo é o "Código da fonte" – o identificador exclusivo para esta fonte de pagamento. Este código é gerado automaticamente, mas pode escolher um valor diferente se preferir (para fins organizacionais, por exemplo). Se utilizar a nossa Payment API, este código é transmitido através do parâmetro sourceCode ao criar uma ordem de pagamento. Para mais informações, consulte a página de documentação da Payment API no Viva.com Developer Portal.
Nome da fonte – Além do Código da fonte, também pode atribuir um nome à sua fonte de pagamento. Isto permite-lhe identificar mais facilmente a fonte dentro da sua conta e nos relatórios (como, por exemplo, o Relatório de liquidação).
Conta vinculada – Selecione a conta (carteira) que deseja vincular a esta fonte de pagamento. Quando esta fonte de pagamento for utilizada, os fundos serão depositados na conta selecionada. Pode vincular várias fontes diferentes a uma única conta, se desejar.
Protocolo – Se a sua plataforma de e-commerce utilizar SSL no checkout, selecione https. Se a sua plataforma não utilizar SSL (como acontece em alguns ambientes de desenvolvimento, por exemplo), selecione http.
Nome de domínio – Introduza o domínio que será vinculado a esta fonte de pagamento. Não é necessário incluir a barra final (\) nem o protocolo (http:// ou https://). Por exemplo:
Se o seu site usar www: www.seudominio.com
Se o seu site não usar www: seudominio.com
Método de integração – Deixe definido como Redirection/Native Checkout v2.
Logotipo da empresa – Carregue o logotipo da sua empresa para ser associado a esta fonte de pagamento, em formato PNG com transparência, até 100KB (tamanho recomendado: 128 x 128 píxeis). Este é um passo importante, pois o logotipo aparecerá na sua página de pagamento, ajudando os clientes a reconhecer e confirmar a sua empresa.
Success URL – Este é o URL da página para a qual o cliente será redirecionado após um pagamento bem-sucedido. Por exemplo, pode usá-lo para exibir uma página de confirmação de pagamento ou uma página que agradeça ao cliente pelo pagamento.
Failure URL – Este é o URL da página para a qual o cliente será redirecionado após um pagamento mal-sucedido. Por exemplo, pode usá-lo para devolver o cliente ao último passo do processo de checkout, para que ele possa tentar novamente a transação.
Configurações avançadas – Neste ponto, pode ativar a exibição de um Botão Cancelar no Smart Checkout, bem como modificar os nomes dos parâmetros de URL adicionados aos Success/Failure URLs após uma transação. Para mais informações sobre os parâmetros adicionados aos Success e Failure URLs, visite a página Viva.com Developer Portal – Response information na secção Integration reference e consulte os parâmetros da cadeia de consulta da resposta.
Para ativar o Botão Cancelar no Smart Checkout, ative a opção Cancel Button. Quando o Botão Cancelar for clicado, o Smart Checkout redirecionará para o seu Failure URL com o parâmetro cancel na query.
Nota:
Atualmente, o Botão Cancelar é suportado para integrações diretas com o Smart Checkout, bem como para funcionalidades específicas nos nossos plugins para Shopify e PrestaShop.
Também é possível receber webhooks relativos a eventos de cancelamento de encomendas. Visite a página Viva.com Developer Portal – Order Updated na secção Webhooks for payments para obter informações sobre o webhook Order Updated e os eventos de cancelamento de encomendas.
Os parâmetros padrão são:
Parameter | Default Name |
Cancellation status | cancel |
Order Code | s |
Transaction ID | t |
Language | lang |
Recomenda-se manter estes padrões, a menos que sejam necessárias alterações específicas para os alinhar com os sistemas internos.
Por fim, reveja as informações ao lado de cada caixa de seleção na parte inferior do ecrã. Deve concordar com estes termos para poder criar a fonte de pagamento. Depois de selecionar todas as opções, clique no botão Criar para concluir o processo.
 |
 |