Por que isso importa
Chaves de licença são finitas. Um código de ativação ou token de desbloqueio de uso único só pode ser usado uma vez — e, depois de enviado por e-mail a um comprador, ele saiu do seu estoque, tendo o comprador pago com cartão roubado ou não. Sem essa regra, todo pedido fraudulento consumiria uma chave real e lojistas que vendem software em pequenos lotes, acesso a cursos ou códigos de ativação veriam o estoque drenar com fraude de chargeback. O Alva Digital Downloads trata a atribuição de chave como uma reserva feita depois de o pedido ser confiável, não no momento do pagamento.
Como funciona na prática
O fluxo roda da mesma forma toda vez quando as checagens antifraude estão habilitadas na loja:
- Pedido pago — the Shopify
orders/paidwebhook lands. Alva creates the Purchase record and queues the order in the fraud queue. - Chaves reservadas? Não. Every linked key stays at status
AVAILABLEin the pool. NoPurchaseLicenseKeyrow exists yet. - Você aprova — Alva picks the oldest available keys from the linked tag, marks them
ASSIGNED, attaches them to the purchase, and emails the customer. - Estoque vazio na aprovação? Alva creates a
PendingLicenseKeyAssignmentrecord. The next CSV upload fills pending orders in FIFO order and emails customers automatically. - Você rejeita — nenhuma chave é atribuída. O estoque fica inalterado. O pedido não recebe e-mail de download.
O que você verá no admin
The order detail page shows the fraud-pending status in the License keys section. The license key status API returns pending_fraud_check with the message "Order is pending verification" while the order sits in the queue. The home dashboard surfaces a Aprovações antifraude pendentes count so held orders don't get forgotten.
Página de detalhes do pedido no admin do Alva para um pedido na fila antifraude. Mostre a seção Chaves de licença exibindo o status "verificação pendente", com os botões Aprovar e Rejeitar visíveis acima. Sem dados reais de cliente visíveis.
O que os clientes veem
A página do pedido do cliente no Shopify mostra o pedido como pago — o Alva não bloqueia o checkout do Shopify. O cliente não recebe um e-mail de download e nenhuma chave aparece na página de status do pedido ou na página de conta do cliente. Na aprovação, o Alva envia o e-mail de entrega com a chave atribuída. Na rejeição, nenhum e-mail é enviado e o lojista reembolsa o pedido pelo Shopify.
Limitações
Pedidos POS pulam a fila antifraude por completo. Um produto digital vendido em um terminal Shopify POS atribui a chave de licença e envia o e-mail de entrega imediatamente no ponto de venda. O motivo: uma venda com cartão presente é operacionalmente diferente (o comprador está fisicamente presente, chip-and-PIN já rodou) e forçar aprovação em toda compra na loja física quebraria a experiência do balcão. Se sua loja vende produtos com chave de licença em POS e online, espere que vendas POS consumam chaves instantaneamente enquanto vendas online aguardam aprovação.
FAQ
Posso atribuir uma chave a um pedido antes da aprovação antifraude?
Não enquanto o pedido estiver na fila antifraude. Aprove o pedido primeiro e o Alva atribui e envia a chave por e-mail automaticamente. Para pular a espera por completo, desative as checagens antifraude em Configurações — todo pedido pago receberá então a chave imediatamente.
E se eu ficar sem chaves no momento da aprovação?
O Alva cria um registro PendingLicenseKeyAssignment para a compra. Assim que você fizer upload de mais chaves para aquela tag, o pedido pendente mais antigo as reivindica primeiro (FIFO) e o cliente é notificado por e-mail automaticamente.
Isso se aplica a chaves atribuídas manualmente também?
Sim. Qualquer chave que passe pelo Alva — auto-atribuída, auto-gerada ou anexada manualmente — fica retida até a aprovação antifraude passar. A exceção são pedidos POS, que pulam a fila por completo.
Veja também
Foi útil?
Última atualização 2026-05-06