Como os cartões-presente funcionam na Shopify¶
Antes de configurar o Gift Card Hero, vale entender como a Shopify trata os cartões-presente nativamente. Este artigo explica a mecânica por trás disso, para que você saiba sobre o que o app se apoia.
O que é um cartão-presente da Shopify¶
Um cartão-presente da Shopify é um registro de valor armazenado no banco de dados da sua loja. Ele tem:
- Um código único (normalmente 16 caracteres alfanuméricos divididos em grupos, por exemplo
ABCD-EFGH-IJKL-MNOP) - Um saldo na moeda da sua loja
- Uma data de validade opcional
- Um status (ativo, desativado ou totalmente resgatado)
- Uma associação opcional com uma conta de cliente
Quando um cliente finaliza a compra com um código de cartão-presente, a Shopify deduz o valor do saldo do cartão e registra a transação. Se o total do pedido for maior que o saldo do cartão, o cliente paga a diferença com outra forma de pagamento.
Ativando cartões-presente na Shopify¶
Os cartões-presente precisam estar ativados na sua loja Shopify antes que qualquer app possa criá-los. Se não estiverem, o Gift Card Hero avisa durante a configuração ("One more click in Shopify"): abra Gift cards no admin da Shopify e clique em Add gift card product. A Central de Ajuda da própria Shopify lista quais planos e regiões oferecem suporte a cartões-presente.
Como os cartões-presente são criados na Shopify¶
Existem duas formas de criar um cartão-presente nativamente:
- Shopify Admin → Products → Gift cards → Issue gift card — crie manualmente um cartão de um valor específico e, opcionalmente, atribua-o a um cliente.
- Um cliente compra um produto de cartão-presente — quando sua loja vende um produto de cartão-presente, a Shopify gera automaticamente um código e o envia por e-mail ao comprador.
O Gift Card Hero usa os dois mecanismos nos bastidores e acrescenta um terceiro: geração em massa pela API Admin da Shopify.
A Shopify limita um único cartão-presente a $2,000 (ou o equivalente na moeda da sua loja). Para emitir ou recarregar cartões acima desse valor, ative Increase limit em Recarga de saldo; o Gift Card Hero então eleva o teto para $10,000 ou o equivalente.
Cartões-presente como forma de pagamento¶
No Shopify, cartões-presente são uma forma de pagamento, não um desconto. Esta distinção é importante:
| Cartões-presente | Códigos de desconto |
|---|---|
| Reduzem o total do pedido como forma de pagamento | Reduzem o preço dos itens |
| O saldo permanece entre pedidos | Uso único |
| Aparecem nos relatórios financeiros como passivo | Aparecem como desconto |
| Podem ser combinados com descontos | Normalmente não podem ser combinados com outros descontos |
| Não são tributados na compra (na maioria das regiões) | N/A |
Impostos e contabilidade¶
Na maioria das jurisdições, as compras de cartões-presente não são tributáveis — você está vendendo um instrumento de pagamento futuro, não um produto. O imposto é cobrado quando o cartão-presente é resgatado para comprar produtos tributáveis.
A Shopify faz isso automaticamente: as vendas de cartões-presente são registradas como passivo e, quando resgatadas, o passivo é compensado com a venda.
Importante: as leis tributárias variam por país e estado. Sempre consulte seu contador para a sua situação específica. Alguns estados dos EUA (por exemplo, Califórnia) têm regras específicas para cartões-presente.
Datas de validade¶
A Shopify permite definir uma data de validade em um cartão-presente, mas você precisa cumprir a lei local:
- Estados Unidos: a maioria dos estados proíbe datas de validade inferiores a 5 anos. Califórnia, Flórida e outros proíbem totalmente datas de validade em cartões-presente abaixo de determinado valor.
- União Europeia: não há proibição geral em toda a UE, mas cada Estado-membro tem suas próprias regras.
- Canadá: pela lei federal, cartões-presente não podem expirar (com algumas exceções).
- Austrália: pela Lei de Defesa do Consumidor australiana, cartões-presente devem ter validade de pelo menos 3 anos.
O Gift Card Hero permite definir uma data de validade para cartões físicos, cartões eGift de valor personalizado e cada operação em massa. Os cartões emitidos por promoções sempre expiram um ano depois de emitidos. Todo o resto segue a configuração de validade da própria Shopify. Veja o FAQ. O app não garante automaticamente o cumprimento da lei — você é responsável por definir datas de validade adequadas para a sua região.
O que a Shopify NÃO oferece nativamente¶
| Recurso | Shopify nativo | Com o Gift Card Hero |
|---|---|---|
| E-mail com a marca e o código do cartão-presente | Somente e-mail básico | Totalmente personalizável |
| O destinatário pode personalizar (mensagem, design) | Não | Sim |
| Gestão de códigos de cartões-presente físicos | Não | Sim |
| Widget de consulta de saldo na loja virtual | Não | Sim |
| Geração e envio em massa | Não | Sim |
| Analytics (taxa de resgate, aumento de vendas) | Básico | Detalhado |
| Ferramentas de POS (consulta de saldo, emissão, reembolso) | Não | Sim |
| Lembretes de saldo não utilizado | Não | Sim |
| Saldos compartilhados entre várias lojas | Não | Sim |
Como o Gift Card Hero se encaixa¶
O Gift Card Hero é uma camada sobre o sistema de cartões-presente da Shopify. Ele usa a API Admin da Shopify para:
- Criar cartões-presente em seu nome quando pedidos são feitos ou operações em massa são executadas
- Ler os saldos dos cartões para o widget de consulta de saldo e as ferramentas de POS
- Atualizar os saldos dos cartões durante as recargas
- Puxar dados de transações para os analytics
Todos os cartões-presente criados pelo Gift Card Hero aparecem no admin da Shopify em Gift Cards — são cartões-presente Shopify completos.
Principais limitações a considerar¶
- Em algumas configurações, cartões-presente não podem ser aplicados a pedidos com assinaturas.
- Um único cartão tem no máximo $2,000, a menos que Increase limit esteja ativado (veja acima).
- Cartões-presente não podem ser usados para pagar outros cartões-presente (restrição da Shopify).
- Um pedido da Shopify pode ter até 10 cartões-presente aplicados.
- Os códigos de cartão-presente não diferenciam maiúsculas de minúsculas no checkout da Shopify.
- Depois que o cartão é criado, o admin da Shopify mostra apenas os últimos quatro caracteres do código. O Gift Card Hero guarda o código completo criptografado para poder entregar o cartão, mostrá-lo ao cliente na conta dele e pesquisá-lo. Quando você emite um cartão manualmente, o código completo é exibido uma única vez no banner de confirmação, então copie-o nesse momento.
- Um código tem de 8 a 20 letras e números. A Shopify gera códigos de 16 caracteres por padrão.