Skip to main content

​
Prerequisites

  • A compatible Ruoom Core 1.x environment on Python 3.10 or newer and Django 5.2.
  • Payment Plugin 1.2 or newer, installed and configured.
  • Licensed Payment and Digital Products wheel artifacts.

​
Install

Install Payment first, then Digital Products, in the activated Core environment:
Enable both identifiers in .env:
Apply all migrations and verify the composition:
Restart the application. Core mounts the plugin at /digitalproducts/; do not edit INSTALLED_APPS or copy plugin source into Core.

​
Create a product

Open the Digital Products management page at /digitalproducts/digitalproducts/ and create an active product with a name, price, and description. Choose one fulfillment mode:
  • Link and passcode: enter the external resource URL and an optional passcode.
  • Uploaded file: upload the file that an eligible purchaser may download.
Share the generated checkout URL, /digitalproducts/checkout/<id>. After a successful payment, link products expose their configured link/passcode. Uploaded products generate signed links tied to the order, product, and customer. The default signed download lifetime is 24 hours. Override it with DIGITALPRODUCT_DOWNLOAD_LINK_MAX_AGE_SECONDS when required.

​
Purchase notifications

The plugin can notify a configured user when a product is purchased. Notification settings are stored per business; leaving the recipient empty uses the business superuser. Delivery records prevent duplicate notifications for the same order.

​
Upgrade

Upgrade Payment first when required by the target Digital Products release, then install the new Digital Products wheel and run migrate and check.