Os cartões-presente normalmente têm um valor armazenado que pode ser gasto em várias transações até que o saldo seja esgotado, por exemplo, numa experiência e/ou um item da loja. São frequentemente utilizados como presentes para amigos, familiares ou colegas, permitindo que os destinatários escolham livremente os seus próprios produtos ou experiências.

A Ventrata permite que os clientes comprem vales por qualquer valor desejado, que podem posteriormente ser utilizados para comprar qualquer produto da sua oferta.

Os cartões-presente podem ser vendidos e resgatados através de:

📱 Pontos de Venda
💻 Backoffice
🌍 Checkout web (seguir este artigo)

Configuração dos vales-presente

Para ativar o fluxo de cartões-presente no seu site, os vales-presente devem primeiro ser permitidos nas configurações do checkout web. Siga os passos abaixo para configurar este funcionalidade globalmente e definir a sua disponibilidade para páginas ou botões específicos.

Permitir vales-presente globalmente

No painel da Ventrata, vá para Web Checkouts > Checkouts.

Checkouts (Checkouts)
Selecione um checkout existente.
Pressione o botão EDIT DETAILS (EDITAR DETALHES) para editar o checkout.

Edit Details (Editar detalhes)
Desça no formulário do checkout ou procure por 'Allow Gift Voucher (Permitir vale presente)' e marque a caixa para permitir a compra de vales-presente através do widget de checkout.

Allow Gift Voucher (Permitir vale presente)
Pressione o botão Update Checkout (Atualizar checkout) para guardar as alterações.

Update Checkout (Atualizar checkout)

Ativar vales-presente para páginas ou botões específicos

Depois de os vales-presente estaram permitidos globalmente, pode definir em que páginas ou botões a funcionalidade fica disponível.

1. Desativar a funcionalidade globalmente

Desative temporariamente a funcionalidade em todo o site. Este passo reduz o trabalho manual ao ativá-la para páginas ou botões específicos.

Adicione o seguinte código ao data-config da sua tag <script>:

"features": {
    "gifts": {
       "allowed": false
    }
}

2. Ativar a funcionalidade para páginas ou botões específicos

Adicione o seguinte código ao data-config das páginas ou botões onde pretende permitir a compra de vales-presente.

"features": {
    "gifts": {
       "allowed": true
    }
}

📒 NOTA

Os vales-presente têm de estar ativados nas definições checkout web para que o fluxo de cartões presente funcione. Se esta funcionalidade não estiver ativada globalmente, o fluxo não estará disponível no seu site.

Parâmetros do Cartão Presente

Pode definir parâmetros adicionais, como o valor mínimo e o período de validade.

No painel da Ventrata, vá para Supplier Settings (Configurações do Fornecedor) > Supplier Settings (Configurações do Fornecedor).

Supplier Settings (Configurações do Fornecedor)
Pressione o botão EDIT DETAILS (EDITAR DETALHES).

Edit Details (Editar detalhes)
Procure por 'Gift Card Min Amount (Valor mínimo do Cartão Presente)' e defina o valor mínimo e/ou máximo do cartão presente.

Gift Card Min / Max Amount (Valor mín / máx do cartão-presente)

📒 NOTA
O mesmo valor é apresentado em todas as moedas. Este valor não é convertido.
Defina o período de validade do cartão-presente em dias, meses ou anos.

Gift expiry (Validade do vale-presente)
Pressione o botão Update Supplier (Atualizar fornecedor).

Update Supplier (Atualizar fornecedor)

Funcionalidades dos cartões-presente

A funcionalidade cartões-presente suporta várias sub-funcionalidades que podem ser adicionadas à sua solução de checkout Ventrata fazendo uma das seguintes coisas:

Atualizar atributo Data-Config - adicionando o código abaixo, substituindo o subfeatureName pelo nome de uma das funcionalidades suportadas e especificando o campo value, veja a tabela de subfuncionalidades abaixo.

📗 DICA
Se pretender incluir várias subfuncionalidades, inclua todas no mesmo objeto gifts. O objeto gifts deve estar sempre dentro do obejto features.
```
"features": {
  "gifts": {
    "subfeatureName": value,
    "subfeatureName1": value
  }
}
```
Adicionar subfuncionalidade ao script ou botão - adicione a subfuncionalidade à sua configuração de dados para script ou botão no seguinte formato:

📗 DICA
Se pretender incluir várias subfuncionalidades, inclua todas no mesmo objeto gifts, cada subfuncionalidade separada por vírgula. O objeto gifts deve estar sempre dentro do objeto features.
```
<script 
src="https://cdn.checkout.ventrata.com/v3/production/ventrata-checkout.min.js" type="module" data-config='{"apiKey":"<YOUR_API_TOKEN>", "features":{"gifts": {"featureName": value, "featureName1": value }}}'></script>
```

Subfuncionalidaded suportadas

Subfuncionalidade	Por defeito	Valores disponíveis	Descrição
`allowed`	`true`	`true` / `false`	quando ativado no painel, esta funcionalidade pode aparecer no script
`modo`	por defeito não definido	`simple`	o modo por defeito inicia o processo com a seleção de um produto antes de avançar para o fluxo do cartão-presente. Por ser o modo por defeito, não precisa de ser definido no script; o modo simples permite a compra de um cartão-presente independente, sem selecionar um produto específico, através de um botão dedicado
`openByDefault`	`false`	`true` / `false`	permite a compra de cartões-presente via checkout web; utilizada apenas no modo por defeito
`disableAmountInput`	`false`	`true` / `false`	desativa a posibiliaded de ajustar o preço por unidade do cartão-presente; utilizada apenas no modo por defeito

Fluxo dos Cartões-Presente

Modo por defeito

O cliente seleciona um produto onde os cartões-presente são permitidos. Na página Tickets (Bilhetes), um link Buy as a gift card (Comprar como cartão-presente) aparece abaixo dos seletores de unidade.

Quando o cliente seleciona o link, o lado direito do widget é preenchido com uma breve descrição da funcionalidade, um campo para introduzir o valor do cartão-presente, instruções sobre o valor mínimo e os termos de compra.

📗 DICA

Depois de entrar no fluxo do cartão-presente, o link Back to ticket purchase (Voltar à compra de bilhetes) substitui o link Buy as a gift card (Comprar como cartão-presente), permitindo sair do fluxo do cartão-presente e continuar com a compra normal do bilhete.

O cliente tem a opção de:

definir um valor total sem selecionar unidades, ou
definir um valor por unidade e selecionar o número de unidades pretendidas; o detalhe da compra é apresentado acima do campo 'Gift card value (Valor do cartão-presente)'.

O botão Continue (Continuar) leva o cliente para a página Checkout, onde:

À esquerda, o cliente introduz os dados de contato

📒 NOTA
O endereço de e-mail é o único campo obrigatório.
À direita, é apresentado um fundo em gradiente e um ícone de cartão-presente com o respetivo valor

📒 NOTA
As cores do gradiente são obtidas das definições da marca no painel do Ventrata.
È apresentada uma nota com o período de validade do cartão-presente, conforme definido em Supplier Settings (Configurações do fornecedor).

📒 NOTA
Se a funcionalidade promoAndGiftCardInput está definida como true, o cliente pode resgatar códigos promocionais ou outros cartões-presente. Se estiver definida como false, o campo de promoções não é apresentado e não é possível aplicar descontos. Para mais informações, consulte a Lista de recursos do checkout.

Modo simples

O modo simples permite aos clientes comprar um cartão-presente sem selecionar previamente um produto.

📒 NOTA

O modo simples é um fluxo sem produto. Por isso, NÃO inclua um productID no data-config.

Configuraçåo

Adicione o objeto gifts e a subfuncionalidade do modo simples ao data-config do script ou botão:

📒 NOTA

As subfuncionalidades openByDefault e disableAmountInput não são suportadas no modo simples.

"features": {
    "gifts": {
      "mode": "simple"
    }
}

Moeda por defeito

Como o modo simples não está associado a um destino ou produto específico, a lista de moedas suportadas é obtida a partir das definições do Web Checkout (Web Checkout > [checkout selecionado] > Edit Details (Editar detalhes) > Available Currencies (Moedas disponíveis)).

Para definir uma moeda específica como moeda por defeito, certifique-se de que esta aparece em primeiro lugar na lista de moedas disponíveis. Para alternar entre moedas no modo simples, utilize o ícone do globo como habitualmente.

Fluxo

Ao selecionar o botão dedicado ao cartão-presente, o cliente é redirecionado para a vista simples do cartão-presente.

Buy a gift card (Comprar um vale-presente)

O cliente introduz o valor do cartão-presente e seleciona o botão Continue (Continuar).

Em seguida, é encaminhado para a página Checkout, onde:

Á esquerda, introduz os dados de contato.

📒 NOTA
O endereço de e-mail é o único campo obrigatório.
À direita, é apresentado um fundo em gradiente e um ícone do cartão-presente com o respetivo valor.

📒 NOTA
As cores do gradiente são obtidas das definições configuradas em brand (marca) no painel do Ventrata.
É apresentado uma nota com o período de validade do cartão-presente, conforme definido em Supplier Settings (Configurações do fornecedor).

📒 NOTA
Se a funcionalidade promoAndGiftCardInput está definida como true, o cliente pode resgatar códigos promocionais ou outros cartões-presente. Se estiver definida como false, o campo de promoções não é apresentado e não é possível aplicar descontos. Para mais informações, consulte a Lista de recursos do checkout.

Checkout

Opções de entrega do cartão presente

Entregar ao comprador - o cliente introduz o seu endereço de e-mail na página de checkout e o cartão presente é enviado a esse endereço. A entrega ao destinário final a cargo do comprador.
Entregar a um amigo - o cliente pode enviar o cartão-presente diretamente para um amigo. Após o pagamento, é apresentado um formulário adicional para introduzir o nome completo, o endereço de e-mail e uma mensagem personalizada.

Delivered To The Buyer (left) & To Friend (right)

Opções de entrega do cartão presente

Configurações personalizadas do cartão-presente

Atualizar o `data-config`

Pode adicionar uma ou ambas das funcionalidades seguintes ao data-config do script ou botão para personalizar o comportamento do widget, consulte o Guia de implementação para mais informações.

openByDefault

Quando definido como true, o cliente é automaticamente direcionado para o fluxo do cartão-presente do produto, sem necessidade de selecionar um link. O fluxo mantém-se inalterado. É util quando o produto funciona essencialmente como um cartão-presente.

"features": {
    "gifts" : {
      "openByDefault": true // by default: false
    }
}

disabledAmountInput

Restringe a possibilidade de ajustar o preço por unidade do cartão-presente; o cliente apenas pode selecionar o número de unidades.

"features": {
    "gifts" : {
      "disableAmountInput": true // by default false
    }
}

openByDefault + disableAmountInput

A combinação destas funcionalidades permite direcionar automaticamente o cliente para o fluxo do cartão-presente, mantendo o preço por unidade fixo.

"features": {
    "gifts" : {
      "openByDefault": true, // by default: false
      "disableAmountInput": true // by default false
    }
}

Como usar cartões-presente no checkout web

Configuração dos vales-presente

Permitir vales-presente globalmente

Ativar vales-presente para páginas ou botões específicos

1. Desativar a funcionalidade globalmente

2. Ativar a funcionalidade para páginas ou botões específicos

Parâmetros do Cartão Presente

Funcionalidades dos cartões-presente

Fluxo dos Cartões-Presente

Modo por defeito

Modo simples

Configuraçåo

Moeda por defeito

Fluxo

Opções de entrega do cartão presente

Configurações personalizadas do cartão-presente

Atualizar o data-config

Atualizar o `data-config`