Fontes são usadas para pagamentos online através do Smart Checkout, plugins e das nossas ferramentas de pagamento.
➡️ 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.
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.
Se estiver a utilizar um dos nossos plugins, os Success URL e Failure URL podem exigir valores específicos. Consulte a tabela de URLs dos plugins abaixo.
Plugin name | Success URL |
WooCommerce Smart Checkout |
|
OpenCart Smart Checkout |
|
Magento Smart Checkout |
|
Plugin name | Failure URL |
WooCommerce Smart Checkout |
|
OpenCart Smart Checkout |
|
Magento Smart Checkout |
|
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 (consulte Response information | Viva.com Developer Portal).
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 para eventos de cancelamento de pedidos. Siga este guia (Order Updated | Viva.com Developer Portal) para configurar um webhook para cancelamentos de pedidos.
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.