Point-of-sale icon

Cartões vale presente para seu terminal

Aprenda a fazer transações com cartões vale presente com nossa API de terminais.

Usando nossa solução não integrada?

Nossa solução não integrada não suporta transações com cartões vale presente.

Nossa API de terminais suporta Cartões vale presente emitidos pela Givex, Stored Value Solutions (SVS), e ValueLink.

Também suportamos Cartões vale presente de fornecedores locais na Dinamarca, França, Holanda, Noruega, Suécia e Reino Unido. Você poderá processar pagamentos com cartões destes fornecedores, mas não poderá realizar outras operações.

As transações com cartões vale presente são iniciadas realizando uma solicitação para a API de terminais de sua caixa registradora. Você pode fazer as seguintes transações com cartões vale presente usando nossa API de terminais:

  • Ativação: Ativa o cartões vale presente para outras transações. Opcionalmente, você pode carregar o cartão com um saldo inicial ao ativá-lo.

    Após a ativação do cartão, você pode fazer as seguintes transações:

  • Efetuar um pagamento: Efetue um pagamento total ou parcial com um cartões vale presente.
  • Verificar saldo: Consulte o saldo restante do cartões vale presente.
  • Carregar o cartão: Adicione fundos ao saldo do cartões vale presente.
  • Reembolso: Reembolse os fundos do cartões vale presente. Você também pode reverter um pagamento feito com o cartões vale presente, completamente ou parcialmente.
  • Desativar ou sacar: Desative o cartão e retire os fundos restantes.
  • Desfazer transações de um carregamento anterior: desfaça a transação de carregamento mais recente, desde que ela tenha ocorrido nas últimas 24 horas.

Quando uma solicitação de transação é processada, você recebe uma resposta indicando se a transação foi bem-sucedida.

Antes de começar

Antes de realizar transações com cartões vale presente, certifique-se de:

Leitura do cartões vale presente

Para processar solicitações de pagamento e outras solicitações que envolvam um cartões vale presente, precisamos ter acesso as informações do cartão. Você pode obtê-las das seguintes maneiras:

  • Leitura por scanner: Fazer a leitura do cartões vale presente usando um scanner de código de barras vinculado à caixa registradora. Em seguida, você especifica os detalhes do cartão presente na solicitação que será enviada ao terminal.
  • Swipe: Quando você envia uma solicitação ao terminal de pagamento, a caixa registradora solicita que o comprador deslize o cartão no terminal. O terminal combina a solicitação e os detalhes do cartão para processar a transação. O resultado da transação é enviado para a caixa registradora.
  • Venda digitada (MKE - Manual keyed entry): Quando você envia uma solicitação ao terminal de pagamento, a caixa registradora solicita ao comprador que insira manualmente os detalhes do cartão presente no terminal. O terminal combina a solicitação e os detalhes inseridos para processar a transação e envia o resultado da transação para a caixa registradora..

A presença do titular do cartão ainda é necessária para realizar a venda digitada (MKE). Use pagamentos MOTO se precisar oferecer suporte a transações nas quais o titular do cartão não está presente.

API de terminais ou API de valores armazenados

Existem tipos de transações com cartões vale presente que podem ser realizadas de duas maneiras diferentes:

  • Utilizando a API de terminais: É o que descrevemos aqui. É a API em que nossa solução de terminais se baseia e ela suporta todas as transações com cartões vale presente realizadas em loja.
  • Usando a API de valores armazenados (Stored Value) : Esta é uma API simples, que utiliza apenas JSON, e é a mesma para terminais e web. Você não pode efetuar pagamentos com esta API, mas pode usá-la para outras transações com cartões vale presente, tanto na loja quanto online.

Para ambas as opções, você poderá realizar as seguintes transações:

  • Ativação
  • Carregamento de saldo
  • Verificação de saldo
  • Desativação

Com uma integração no terminal, você já conhece a estrutura da API de terminais e, portanto, pode escolher realizar todas as transações com cartão presente no terminal usando essa API.
Se você também possui uma integração de pagamentos online, pode escolher fazer essas transações para o PDV para Web usando a API de valores armazenados (Stored Value). Você ainda poderia usar a API de terminais, mas apenas para transações relacionadas a pagamento.

Próximos Passos

Veja também