PaymentConductor

    PaymentConductor (v1, 2026-05-22) is Ring Platform's config-driven payment layer. One ledger (payment_transactions) and one webhook dispatcher serve store checkout, membership upgrades, and news promotion.

    Architecture

    Checkout / upgrade / promotion
        ↓
lib/payments/conductor/payment-conductor.ts
        ↓
Processors: wayforpay | stripe | internal_credit
        ↓
payment_transactions (PostgreSQL)

    Implementation: lib/payments/conductor/, lib/payments/processors/, lib/payments/payment.config.ts.

    Payment purposes

    PurposeHandlerTypical processor
    store_orderhandlers/store-order.tsWayForPay or Stripe
    membership_upgradehandlers/membership-upgrade.tsWayForPay or Stripe
    news_promotionhandlers/news-promotion.tsWayForPay or Stripe

    Per-purpose override via env: PAYMENT_STORE_PROCESSOR, PAYMENT_MEMBERSHIP_PROCESSOR, PAYMENT_NEWS_PROCESSOR. Default: PAYMENT_DEFAULT_PROCESSOR (wayforpay or stripe).

    Rails

    • merchant_redirect — WayForPay / Stripe hosted checkout
    • internal_credit — Wallet credit balance (PAYMENT_STORE_ALLOW_CREDIT)
    • native_token — RING token (optional, PAYMENT_STORE_ALLOW_TOKEN)

    Environment variables

    PAYMENT_DEFAULT_PROCESSOR=wayforpay
WAYFORPAY_MERCHANT_ACCOUNT=your_merchant
WAYFORPAY_SECRET_KEY=your_secret
STRIPE_SECRET_KEY=sk_live_...
STRIPE_WEBHOOK_SECRET=whsec_...
PAYMENT_FIAT_CURRENCY=UAH

    Webhooks: /api/payments/wayforpay/webhook, /api/payments/stripe/webhook — dispatched by webhook-dispatcher.ts.

    Database

    Apply migration data/migrations/004_payment_transactions.sql before enabling PaymentConductor in production.

    Related

    • Payments overview
    • WayForPay integration
    • Architecture: PaymentConductor

    Documentation

    Welcome — mission & audiences

    Welcome to Ring Platform - Gateway Between Humanity and the Quantum World

    Library hub

    Welcome to Ring Platform - Gateway Between Humanity and the Quantum World

    Getting Started

    Index
    Prerequisites
    Installation
    Database migrations
    First Success Validation
    Troubleshooting
    Next Steps

    Architecture

    Index
    Backend modes and databases
    Data Model
    Authentication Architecture
    Email AI-CRM Architecture
    PaymentConductor architecture
    News Kingdom architecture
    Proxy and internationalization
    Real Time
    Security

    Features

    Platform Features
    Authentication
    Email AI-CRM System
    Entities
    Opportunities
    Notifications
    Push Notifications with FCM (Ring-Powered)
    Web3 Wallet
    Multi-Vendor Store
    Payment Integration
    PaymentConductor
    WayForPay Payment Integration
    News Module - Digital Newspaper Experience

    API

    Index
    Authentication
    Email AI-CRM API
    Entities
    Opportunities
    Messaging API
    Notifications API
    Wallet
    Store API

    CLI

    Ring CLI (enterprise only)

    Customization

    Index
    Branding
    Features
    Localization
    Themes
    Components

    Deployment

    Index
    Self-hosted deployment
    Vercel
    Docker
    Environment Configuration
    Monitoring & Analytics
    Performance Optimization
    Backup & Recovery

    Development

    Index
    Local Setup
    Code Structure
    Community tooling
    Ring MCP Server
    OSS vs enterprise
    Whitelabel Navigation
    Best Practices

    Examples

    Index
    Quick Start
    Authentication
    Email AI-CRM Tutorial
    Api Integration
    Web3 Integration
    White Label
    Real World

    Integrations

    Ethereum wallets (Wagmi v3)

    Quick entry (CTOs · auditors · agents)

    Library hub
    Welcome — mission & audiences
    Getting started
    Architecture & Auth.js
    Backend modes & databases (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP
    Deploy (Docker · k8s)
    Security & compliance reads

    PaymentConductor

    PaymentConductor (v1, 2026-05-22) is Ring Platform's config-driven payment layer. One ledger (payment_transactions) and one webhook dispatcher serve store checkout, membership upgrades, and news promotion.

    Architecture

    Checkout / upgrade / promotion
        ↓
lib/payments/conductor/payment-conductor.ts
        ↓
Processors: wayforpay | stripe | internal_credit
        ↓
payment_transactions (PostgreSQL)

    Implementation: lib/payments/conductor/, lib/payments/processors/, lib/payments/payment.config.ts.

    Payment purposes

    PurposeHandlerTypical processor
    store_orderhandlers/store-order.tsWayForPay or Stripe
    membership_upgradehandlers/membership-upgrade.tsWayForPay or Stripe
    news_promotionhandlers/news-promotion.tsWayForPay or Stripe

    Per-purpose override via env: PAYMENT_STORE_PROCESSOR, PAYMENT_MEMBERSHIP_PROCESSOR, PAYMENT_NEWS_PROCESSOR. Default: PAYMENT_DEFAULT_PROCESSOR (wayforpay or stripe).

    Rails

    • merchant_redirect — WayForPay / Stripe hosted checkout
    • internal_credit — Wallet credit balance (PAYMENT_STORE_ALLOW_CREDIT)
    • native_token — RING token (optional, PAYMENT_STORE_ALLOW_TOKEN)

    Environment variables

    PAYMENT_DEFAULT_PROCESSOR=wayforpay
WAYFORPAY_MERCHANT_ACCOUNT=your_merchant
WAYFORPAY_SECRET_KEY=your_secret
STRIPE_SECRET_KEY=sk_live_...
STRIPE_WEBHOOK_SECRET=whsec_...
PAYMENT_FIAT_CURRENCY=UAH

    Webhooks: /api/payments/wayforpay/webhook, /api/payments/stripe/webhook — dispatched by webhook-dispatcher.ts.

    Database

    Apply migration data/migrations/004_payment_transactions.sql before enabling PaymentConductor in production.

    Related

    • Payments overview
    • WayForPay integration
    • Architecture: PaymentConductor

    Documentation

    Welcome — mission & audiences

    Welcome to Ring Platform - Gateway Between Humanity and the Quantum World

    Library hub

    Welcome to Ring Platform - Gateway Between Humanity and the Quantum World

    Getting Started

    Index
    Prerequisites
    Installation
    Database migrations
    First Success Validation
    Troubleshooting
    Next Steps

    Architecture

    Index
    Backend modes and databases
    Data Model
    Authentication Architecture
    Email AI-CRM Architecture
    PaymentConductor architecture
    News Kingdom architecture
    Proxy and internationalization

    Features

    Platform Features
    Authentication
    Email AI-CRM System
    Entities
    Opportunities
    Notifications
    Push Notifications with FCM (Ring-Powered)
    Web3 Wallet

    API

    Index
    Authentication
    Email AI-CRM API
    Entities
    Opportunities
    Messaging API
    Notifications API
    Wallet
    Store API

    CLI

    Ring CLI (enterprise only)

    Customization

    Index
    Branding
    Features
    Localization
    Themes
    Components

    Deployment

    Index
    Self-hosted deployment
    Vercel
    Docker
    Environment Configuration
    Monitoring & Analytics
    Performance Optimization
    Backup & Recovery

    Development

    Index
    Local Setup
    Code Structure
    Community tooling
    Ring MCP Server
    OSS vs enterprise
    Whitelabel Navigation
    Best Practices

    Examples

    Index
    Quick Start
    Authentication
    Email AI-CRM Tutorial
    Api Integration
    Web3 Integration
    White Label
    Real World

    Integrations

    Ethereum wallets (Wagmi v3)

    Quick entry (CTOs · auditors · agents)

    Library hub
    Welcome — mission & audiences
    Getting started
    Architecture & Auth.js
    Backend modes & databases (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP
    Deploy (Docker · k8s)
    Security & compliance reads

    PaymentConductor

    PaymentConductor (v1, 2026-05-22) is Ring Platform's config-driven payment layer. One ledger (payment_transactions) and one webhook dispatcher serve store checkout, membership upgrades, and news promotion.

    Architecture

    Checkout / upgrade / promotion
        ↓
lib/payments/conductor/payment-conductor.ts
        ↓
Processors: wayforpay | stripe | internal_credit
        ↓
payment_transactions (PostgreSQL)

    Implementation: lib/payments/conductor/, lib/payments/processors/, lib/payments/payment.config.ts.

    Payment purposes

    PurposeHandlerTypical processor
    store_orderhandlers/store-order.tsWayForPay or Stripe
    membership_upgradehandlers/membership-upgrade.tsWayForPay or Stripe
    news_promotionhandlers/news-promotion.tsWayForPay or Stripe

    Per-purpose override via env: PAYMENT_STORE_PROCESSOR, PAYMENT_MEMBERSHIP_PROCESSOR, PAYMENT_NEWS_PROCESSOR. Default: PAYMENT_DEFAULT_PROCESSOR (wayforpay or stripe).

    Rails

    • merchant_redirect — WayForPay / Stripe hosted checkout
    • internal_credit — Wallet credit balance (PAYMENT_STORE_ALLOW_CREDIT)
    • native_token — RING token (optional, PAYMENT_STORE_ALLOW_TOKEN)

    Environment variables

    PAYMENT_DEFAULT_PROCESSOR=wayforpay
WAYFORPAY_MERCHANT_ACCOUNT=your_merchant
WAYFORPAY_SECRET_KEY=your_secret
STRIPE_SECRET_KEY=sk_live_...
STRIPE_WEBHOOK_SECRET=whsec_...
PAYMENT_FIAT_CURRENCY=UAH

    Webhooks: /api/payments/wayforpay/webhook, /api/payments/stripe/webhook — dispatched by webhook-dispatcher.ts.

    Database

    Apply migration data/migrations/004_payment_transactions.sql before enabling PaymentConductor in production.

    Related

    • Payments overview
    • WayForPay integration
    • Architecture: PaymentConductor

    Documentation

    Welcome — mission & audiences

    Welcome to Ring Platform - Gateway Between Humanity and the Quantum World

    Library hub

    Welcome to Ring Platform - Gateway Between Humanity and the Quantum World

    Getting Started

    Index
    Prerequisites
    Installation
    Database migrations
    First Success Validation
    Troubleshooting
    Next Steps

    Architecture

    Index
    Backend modes and databases
    Data Model
    Authentication Architecture
    Email AI-CRM Architecture
    PaymentConductor architecture
    News Kingdom architecture
    Proxy and internationalization

    Features

    Platform Features
    Authentication
    Email AI-CRM System
    Entities
    Opportunities
    Notifications
    Push Notifications with FCM (Ring-Powered)
    Web3 Wallet

    API

    Index
    Authentication
    Email AI-CRM API
    Entities
    Opportunities
    Messaging API
    Notifications API
    Wallet
    Store API

    CLI

    Ring CLI (enterprise only)

    Customization

    Index
    Branding
    Features
    Localization
    Themes
    Components

    Deployment

    Index
    Self-hosted deployment
    Vercel
    Docker
    Environment Configuration
    Monitoring & Analytics
    Performance Optimization
    Backup & Recovery

    Development

    Index
    Local Setup
    Code Structure
    Community tooling
    Ring MCP Server
    OSS vs enterprise
    Whitelabel Navigation
    Best Practices

    Examples

    Index
    Quick Start
    Authentication
    Email AI-CRM Tutorial
    Api Integration
    Web3 Integration
    White Label
    Real World

    Integrations

    Ethereum wallets (Wagmi v3)

    Quick entry (CTOs · auditors · agents)

    Library hub
    Welcome — mission & audiences
    Getting started
    Architecture & Auth.js
    Backend modes & databases (DB_BACKEND_MODE)
    Self-hosted
    Ring MCP
    Deploy (Docker · k8s)
    Security & compliance reads
    Member Blogs
    Scientific Editor
    Locale System
    Security & Compliance
    NFT Marketplace
    Token Staking System
    Performance Optimization Patterns
    Mobile Experience
    Admin API
    Workflow
    Code Style
    Performance
    Testing
    Deployment
    Debugging
    Contributing
    Api Examples
    ringdom.org — LegioX homebase
    Source — MIT license (GitHub)
    Real Time
    Security
    Multi-Vendor Store
    Payment Integration
    PaymentConductor
    WayForPay Payment Integration
    News Module - Digital Newspaper Experience
    Member Blogs
    Scientific Editor
    Locale System
    Security & Compliance
    NFT Marketplace
    Token Staking System
    Performance Optimization Patterns
    Mobile Experience
    Admin API
    Workflow
    Code Style
    Performance
    Testing
    Deployment
    Debugging
    Contributing
    Api Examples
    ringdom.org — LegioX homebase
    Source — MIT license (GitHub)
    Real Time
    Security
    Multi-Vendor Store
    Payment Integration
    PaymentConductor
    WayForPay Payment Integration
    News Module - Digital Newspaper Experience
    Member Blogs
    Scientific Editor
    Locale System
    Security & Compliance
    NFT Marketplace
    Token Staking System
    Performance Optimization Patterns
    Mobile Experience
    Admin API
    Workflow
    Code Style
    Performance
    Testing
    Deployment
    Debugging
    Contributing
    Api Examples
    ringdom.org — LegioX homebase
    Source — MIT license (GitHub)