Documentation Index
Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
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.
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_idque é 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”).
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. |
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.
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 webhookentitlement_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.