Skip to main content

​
Prerequisites

  • A compatible Ruoom Core 1.x checkout on Python 3.10 or newer and Django 5.2.
  • The licensed payment_plugin-1.5.5-py3-none-any.whl artifact.
  • Credentials for at least one supported provider: Stripe, PayPal, or PortOne.

​
Install

From the activated Core virtual environment, install the wheel. Do not extract its source into Core.
Enable the plugin in .env by adding payment to the comma-separated list:
If other plugins are enabled, preserve them, for example RUOOM_PLUGINS=payment,digitalproducts,email_otp. Apply migrations, collect static files for deployment, and verify Django:
Restart the application. Core mounts the plugin at /payment/ and adds its Payment Processing settings tab automatically; do not edit INSTALLED_APPS or root URLs.

​
Configure a provider

Sign in as staff and open Platform Settings → Payment Processing. Configure and enable a gateway account, validate its credentials, and assign a route for each business/currency combination you intend to accept. Payment Processing
  • PayPal routes are USD-only.
  • PortOne accepts KRW by default; USD requires an explicit account capability.
  • Stripe accepts USD. KRW requires an eligible account/capability and is never inferred from browser locale.
Run a test checkout and confirm that a purchase appears under /payment/purchases/. Configure provider webhook destinations at /payment/webhooks/stripe/, /payment/webhooks/paypal/, or /payment/webhooks/portone/ as appropriate.

​
Upgrade