Digital Product Delivery

Entregue arquivos para download, links externos e instruções de download automaticamente quando os clientes efetuarem a compra. A Entrega de Produtos Digitais é o tipo de direito de Arquivos Digitais. Os arquivos são emitidos com URLs de download pré-assinados em cada concessão e revogados quando o acesso é retirado.

​

Overview

A Entrega de Produtos Digitais é o tipo de direito Arquivos Digitais. Você faz o upload dos seus arquivos uma vez para um direito de Arquivos Digitais, anexa o direito a um produto, e o Dodo Payments entrega links de download pré-assinados para cada cliente pagante por e-mail e no portal do cliente.

O direito suporta:

• Uploads de arquivos hospedados: armazene arquivos no Dodo Payments e forneça-os via URLs pré-assinados de curta duração.
• Links de download externos: links para arquivos hospedados no Dropbox, Google Drive, S3 ou qualquer URL.
• Instruções de download: texto livre mostrado ao cliente na página do pedido e no e-mail de entrega.

Você pode misturar todos os três em um único direito.

​

Principais Recursos

Upload de arquivos (PDF, ZIP, imagens, vídeos, etc.) de até 100 MB. Os arquivos são transmitidos e armazenados de forma eficiente.

Anexe quantos arquivos forem necessários a um único direito.

Forneça links de download externos (Dropbox, Google Drive, URLs S3 assinadas) como alternativa ou adição.

Os arquivos hospedados são servidos via URLs pré-assinados de curta duração. Cada URL de download expira automaticamente após cerca de 15 minutos.

---

​

Configurar Entrega de Produtos Digitais

Vá para Direitos no painel de controle do Dodo Payments e clique em + para criar um novo direito.

Selecione Entrega de Produtos Digitais como integração.

Configure qualquer combinação de:

• Arquivos: faça o upload de um ou mais arquivos. Cada upload retorna um file_id que é anexado ao direito.
• URL Externa: um link HTTPS publicamente acessível entregue junto com arquivos hospedados.
• Instruções: texto livre mostrado ao cliente (por exemplo, “Descompacte e execute setup.sh”).

Salvar. O direito agora está disponível para anexar a qualquer produto.

​

Anexar a Produtos

Abra um produto, expanda Configurações Avançadas → Direitos & Créditos, e selecione seu direito de Arquivos Digitais. O direito é entregue em cada compra bem-sucedida ou assinatura ativa vinculada a esse produto.

---

​

Como Funciona a Entrega

A entrega de Arquivos Digitais segue o padrão de ciclo de vida da concessão:

Evento	Comportamento
payment.succeeded (uma vez)	Emita uma concessão. A concessão carrega URLs de download pré-assinados válidos por ~15 minutos; os clientes podem atualizá-los reabrindo o link do e-mail ou a página do portal do cliente.
subscription.active	Emita uma concessão. Os arquivos permanecem acessíveis enquanto a assinatura estiver ativa.
subscription.renewed	Sem operação. A mesma concessão continua; novos URLs pré-assinados são gerados a cada solicitação.
subscription.on_hold / cancelled / expired	Revogue a concessão. Novos URLs pré-assinados não são mais emitidos.
subscription.plan_changed	Revogue a concessão antiga; emita uma nova para o direito do novo plano.
refund.succeeded (uma vez)	Revogue a concessão.
Revogação manual	Revogar com revocation_reason: manual.

A revogação impede que o Dodo Payments emita novos URLs de download, mas não invalida cópias que um cliente já baixou. Considere downloads de arquivos hospedados como “entregue uma vez lido.”

---

​

Experiência do Cliente

​

Confirmação de Compra

Após uma transação bem-sucedida, o cliente recebe um e-mail com links de download e quaisquer instruções que você configurou.

​

Acesso ao Portal do Cliente

Os clientes podem buscar novamente links de download a qualquer momento no Portal do Cliente. A página do portal gera URLs pré-assinados novos sob demanda, para que a mesma compra continue funcionando mesmo após a expiração dos links do e-mail.

Os clientes podem baixar arquivos diretamente dos e-mails de confirmação ou acessá-los a qualquer momento através do seu portal.

---

​

Gerenciar Arquivos Programaticamente

​

Faça o upload de um arquivo para um direito

​

Listar concessões e resolver URLs de download

​

Remover um arquivo de um direito

---

​

Considerações Importantes

• URLs pré-assinados expiram rapidamente. URLs de download retornados em cargas de concessão ou eventos webhook são válidos por ~15 minutos. Não os armazene; busque-os novamente quando o cliente precisar baixar novamente.
• Atualizar arquivos afeta apenas compras futuras. Substituir ou remover um arquivo não altera retroativamente downloads já emitidos. Clientes anteriores ainda podem buscar novamente a versão que estava disponível quando sua concessão foi criada.
• Reembolsos não invalidam cópias baixadas. Um cliente que já baixou um arquivo mantém essa cópia. Para conteúdo revogável (mídia restrita por licença, acesso por tempo limitado), combine Arquivos Digitais com Chaves de Licença e valide em tempo de execução.
• Para conteúdo sensível, prefira URLs externas com sua própria autenticação. Os URLs pré-assinados do Dodo Payments são de curta duração, mas não autenticados dentro de sua janela; qualquer pessoa com o URL pode fazer o download nessa janela. Conteúdo hospedado externamente e com autenticação proporciona garantias mais fortes.

---

​

Gerenciamento de API

Crie um direito de Arquivos Digitais com URL externa opcional e instruções.

Carregue um arquivo (até 100 MB) e anexe-o ao direito.

Remove um arquivo do direito.

Liste concessões e leia os URLs de download resolvidos.

Atualize instruções, URL externa ou substitua arquivos.

Revogue manualmente o acesso de um cliente.

---

​

Webhooks

A entrega e revogação de arquivos digitais acionam os quatro eventos webhook entitlement_grant.*. Para concessões de Arquivos Digitais, a carga inclui um objeto digital_product_delivery com a lista de arquivos resolvida (URLs pré-assinados, nomes de arquivos, tamanhos), o opcional instructions e o opcional external_url.

---

​

Entrega de Produto Digital Legado

---

​

Entrega de Produto Digital Legado

Produtos configurados com o bloco digital_product_delivery nos próprios produtos foram automaticamente migrados para um direito de Arquivos Digitais. Arquivos existentes enviados pela API de arquivos de produto legados são preservados; eles continuam a ser baixáveis e aparecem em payloads de concessão marcados com source: "legacy". Atualizações futuras (adicionar arquivos, alterar instruções, substituir o URL externo) devem ser feitas editando o direito de Arquivos Digitais migrado em Concessões.

Os campos legados a nível de produto (digital_product_delivery.external_url, digital_product_delivery.instructions) continuam a ser preenchidos nas respostas de produto para compatibilidade retroativa, mas a concessão é a fonte da verdade daqui para frente.

---

​

Melhores Práticas

• Trate downloads como eventos únicos. Clientes compartilharão ou perderão links, então desenhe seu produto assumindo que qualquer coisa que eles baixem é para eles manterem.
• Use instruções para definir expectativas. Para pacotes de múltiplos arquivos, adicione uma linha instructions explicando o que instalar primeiro ou como combinar os arquivos.
• Atenção ao limite de 100 MB. Artefatos maiores (conjuntos de dados de múltiplos GB, cursos de vídeo) devem ser hospedados externamente e vinculados via external_url em vez de enviados.
• Combine com Chaves de Licença para acesso revogável. Se você precisar revogar o acesso a recursos no produto após um reembolso, combine o direito de Arquivos Digitais com um direito de Chave de Licença e valide a chave em tempo de execução.
• Teste o fluxo de atualização do portal do cliente. Confirme se um cliente pode retornar ao portal uma semana depois e ainda obter um link de download funcional. Este é o principal caminho de recuperação quando links por e-mail expiram.