Payments Overview

Ring Platform routes card, credit, native-token, and PayPal flows through PaymentConductor (lib/payments/conductor/). WayForPay is the primary PSP for Ukraine; Stripe and PayPal cover international rails. Wallet credit top-up is a live wallet_topup purpose. Public pool / DAO jar card and PayPal chip-ins use purpose public_pool_contribution (desk-oracle FX — not 1:1 fiat↔native). Membership recurring PayPal uses SubscriptionConductor (Subscriptions v1).

Rates and presentment denominations come from Ring Oracle (main_currency / native_token / credit_balance).

Browser handoff is Conductor CheckoutRedirect — architecture · WayForPay HPP.

Deep dive: PaymentConductor feature · Architecture · Ring Oracle · Public Pools & DAO Jars · WayForPay · SubscriptionConductor

Use Founder / Developer tabs in the docs sidebar to filter this page.

What PaymentConductor covers

Purpose	Description	PSP / rail
`store_order`	Cart → checkout	WayForPay / Stripe / credit / native token / PayPal
`membership_upgrade`	Role upgrade (e.g. SUBSCRIBER → MEMBER)	WayForPay / Stripe / native token / PayPal
`news_promotion`	News Kingdom sponsored articles	WayForPay / Stripe
`wallet_topup`	Fiat credit top-up (Card / PayPal tabs)	WayForPay or Stripe (`PAYMENT_WALLET_TOPUP_PROCESSOR`); PayPal when `processor=paypal`
`public_pool_contribution`	DAO jar / public-pool card or PayPal chip-in	WayForPay / Stripe / PayPal → desk oracle → `pledged_native_token`
Internal credit

Not PSP donation products

WayForPay hosted Донати, Stripe submit_type=donate, and PayPal Donate SDK are not Ring jar SSOT. See Public Pools.

What founders get

One ledger — payment_transactions for store, membership, news, wallet top-up, and public-pool card chip-ins.
Config-driven gateways — PAYMENT_DEFAULT_PROCESSOR plus per-purpose overrides (including optional PAYMENT_PUBLIC_POOL_CONTRIBUTION_PROCESSOR).
Admin visibility — Payments tab on the user detail sheet lists membership and wallet top-up rows.
Membership UI — PaymentModal: native-token, card, and PayPal (when NEXT_PUBLIC_PAYMENT_STORE_ALLOW_PAYPAL=true). Manage cancel/history at /membership/manage.
Store PayPal — optional checkout rail with the same public flag + PAYPAL_* credentials.
DAO jars — dual-currency chip-in on /dao and docs FutureFeature widgets; builder payout when the jar fills (Public Pools).

`ring-config.json` payment section

Symbols below are examples — replace with your clone’s store.mainCurrency and tokens.nativeToken.symbol.

Jar fee map (separate key): publicPools.platformFeePercentByRole — see Public Pools.

Architecture

Key modules

Module	Path	Role
Conductor	`lib/payments/conductor/payment-conductor.ts`	Routes by purpose + processor
Config	`lib/payments/payment.config.ts`	Config + env overrides
Ring Oracle	`lib/ring-oracle/index.ts`	Desk, FX, credit rate SSOT
WayForPay	`lib/payments/processors/wayforpay.processor.ts`	HMAC, form/redirect, Conductor purposes including public pools
Stripe	`lib/payments/processors/stripe.processor.ts`	Checkout + webhook verify

Payments Overview

Rates and presentment denominations come from Ring Oracle (main_currency / native_token / credit_balance).

Browser handoff is Conductor CheckoutRedirect — architecture · WayForPay HPP.

Deep dive: PaymentConductor feature · Architecture · Ring Oracle · Public Pools & DAO Jars · WayForPay · SubscriptionConductor

Use Founder / Developer tabs in the docs sidebar to filter this page.

What PaymentConductor covers

Purpose	Description	PSP / rail
`store_order`	Cart → checkout	WayForPay / Stripe / credit / native token / PayPal
`membership_upgrade`	Role upgrade (e.g. SUBSCRIBER → MEMBER)	WayForPay / Stripe / native token / PayPal
`news_promotion`	News Kingdom sponsored articles	WayForPay / Stripe
`wallet_topup`	Fiat credit top-up (Card / PayPal tabs)	WayForPay or Stripe (`PAYMENT_WALLET_TOPUP_PROCESSOR`); PayPal when `processor=paypal`
`public_pool_contribution`	DAO jar / public-pool card or PayPal chip-in	WayForPay / Stripe / PayPal → desk oracle → `pledged_native_token`
Internal credit

Not PSP donation products

WayForPay hosted Донати, Stripe submit_type=donate, and PayPal Donate SDK are not Ring jar SSOT. See Public Pools.

What founders get

One ledger — payment_transactions for store, membership, news, wallet top-up, and public-pool card chip-ins.
Config-driven gateways — PAYMENT_DEFAULT_PROCESSOR plus per-purpose overrides (including optional PAYMENT_PUBLIC_POOL_CONTRIBUTION_PROCESSOR).
Admin visibility — Payments tab on the user detail sheet lists membership and wallet top-up rows.
Membership UI — PaymentModal: native-token, card, and PayPal (when NEXT_PUBLIC_PAYMENT_STORE_ALLOW_PAYPAL=true). Manage cancel/history at /membership/manage.
Store PayPal — optional checkout rail with the same public flag + PAYPAL_* credentials.
DAO jars — dual-currency chip-in on /dao and docs FutureFeature widgets; builder payout when the jar fills (Public Pools).

`ring-config.json` payment section

Symbols below are examples — replace with your clone’s store.mainCurrency and tokens.nativeToken.symbol.

Jar fee map (separate key): publicPools.platformFeePercentByRole — see Public Pools.

Architecture

Key modules

Module	Path	Role
Conductor	`lib/payments/conductor/payment-conductor.ts`	Routes by purpose + processor
Config	`lib/payments/payment.config.ts`	Config + env overrides
Ring Oracle	`lib/ring-oracle/index.ts`	Desk, FX, credit rate SSOT
WayForPay	`lib/payments/processors/wayforpay.processor.ts`	HMAC, form/redirect, Conductor purposes including public pools
Stripe	`lib/payments/processors/stripe.processor.ts`	Checkout + webhook verify

Payments Overview

Rates and presentment denominations come from Ring Oracle (main_currency / native_token / credit_balance).

Browser handoff is Conductor CheckoutRedirect — architecture · WayForPay HPP.

Deep dive: PaymentConductor feature · Architecture · Ring Oracle · Public Pools & DAO Jars · WayForPay · SubscriptionConductor

Use Founder / Developer tabs in the docs sidebar to filter this page.

What PaymentConductor covers

Purpose	Description	PSP / rail
`store_order`	Cart → checkout	WayForPay / Stripe / credit / native token / PayPal
`membership_upgrade`	Role upgrade (e.g. SUBSCRIBER → MEMBER)	WayForPay / Stripe / native token / PayPal
`news_promotion`	News Kingdom sponsored articles	WayForPay / Stripe
`wallet_topup`	Fiat credit top-up (Card / PayPal tabs)	WayForPay or Stripe (`PAYMENT_WALLET_TOPUP_PROCESSOR`); PayPal when `processor=paypal`
`public_pool_contribution`	DAO jar / public-pool card or PayPal chip-in	WayForPay / Stripe / PayPal → desk oracle → `pledged_native_token`
Internal credit

Not PSP donation products

WayForPay hosted Донати, Stripe submit_type=donate, and PayPal Donate SDK are not Ring jar SSOT. See Public Pools.

What founders get

One ledger — payment_transactions for store, membership, news, wallet top-up, and public-pool card chip-ins.
Config-driven gateways — PAYMENT_DEFAULT_PROCESSOR plus per-purpose overrides (including optional PAYMENT_PUBLIC_POOL_CONTRIBUTION_PROCESSOR).
Admin visibility — Payments tab on the user detail sheet lists membership and wallet top-up rows.
Membership UI — PaymentModal: native-token, card, and PayPal (when NEXT_PUBLIC_PAYMENT_STORE_ALLOW_PAYPAL=true). Manage cancel/history at /membership/manage.
Store PayPal — optional checkout rail with the same public flag + PAYPAL_* credentials.
DAO jars — dual-currency chip-in on /dao and docs FutureFeature widgets; builder payout when the jar fills (Public Pools).

`ring-config.json` payment section

Symbols below are examples — replace with your clone’s store.mainCurrency and tokens.nativeToken.symbol.

Jar fee map (separate key): publicPools.platformFeePercentByRole — see Public Pools.

Architecture

Key modules

Module	Path	Role
Conductor	`lib/payments/conductor/payment-conductor.ts`	Routes by purpose + processor
Config	`lib/payments/payment.config.ts`	Config + env overrides
Ring Oracle	`lib/ring-oracle/index.ts`	Desk, FX, credit rate SSOT
WayForPay	`lib/payments/processors/wayforpay.processor.ts`	HMAC, form/redirect, Conductor purposes including public pools
Stripe	`lib/payments/processors/stripe.processor.ts`	Checkout + webhook verify

Related documentation

PaymentConductor

Deep-dive: purposes, rails, and module paths including public_pool_contribution.

Ring Oracle

Depends-on: main_currency / native_token rates for checkout presentment and jar FX.

Public Pools & DAO Jars

Same-workflow: DAO jar card chip-ins, desk FX, and builder payout.

WayForPay Payment Integration

Depends-on: WayForPay HPP env SSOT and HMAC for card jars.

json


{
  "payment": {
    "cardPaymentProcessor": "wayforpay",
    "supportedMethods": ["wayforpay", "credit_balance", "native_token"],
    "futureMethods": ["stripe", "paypal", "nft_gate"],
    "gateways": {
      "wayforpay": { "enabled": true, "feePercent": 2.5, "currency": "<main_currency>" },
      "stripe": { "enabled": false, "feePercent": 2.9, "feeFixedCents": 30, "currency": "<main_currency>" },
      "credit_balance": { "enabled": true, "feePercent": 0, "currency": "<main_currency>" },
      "native_token": { "enabled": true, "feePercent": 0, "currency": "<native_token_symbol>", "label": "Tokens" }
    }
  }
}

text


Checkout / upgrade / promotion / wallet top-up
        ↓
lib/payments/conductor/payment-conductor.ts
        ↓
Processors: wayforpay.processor | stripe.processor | credit-balance.processor | native-token.processor | paypal.processor
        ↓
payment_transactions (PostgreSQL, migration 004)
        ↓
lib/payments/conductor/webhook-dispatcher.ts → handlers/* (+ PayPal Subscriptions lifecycle)

json


{
  "payment": {
    "cardPaymentProcessor": "wayforpay",
    "supportedMethods": ["wayforpay", "credit_balance", "native_token"],
    "futureMethods": ["stripe", "paypal", "nft_gate"],
    "gateways": {
      "wayforpay": { "enabled": true, "feePercent": 2.5, "currency": "<main_currency>" },
      "stripe": { "enabled": false, "feePercent": 2.9, "feeFixedCents": 30, "currency": "<main_currency>" },
      "credit_balance": { "enabled": true, "feePercent": 0, "currency": "<main_currency>" },
      "native_token": { "enabled": true, "feePercent": 0, "currency": "<native_token_symbol>", "label": "Tokens" }
    }
  }
}

text


Checkout / upgrade / promotion / wallet top-up
        ↓
lib/payments/conductor/payment-conductor.ts
        ↓
Processors: wayforpay.processor | stripe.processor | credit-balance.processor | native-token.processor | paypal.processor
        ↓
payment_transactions (PostgreSQL, migration 004)
        ↓
lib/payments/conductor/webhook-dispatcher.ts → handlers/* (+ PayPal Subscriptions lifecycle)

json


{
  "payment": {
    "cardPaymentProcessor": "wayforpay",
    "supportedMethods": ["wayforpay", "credit_balance", "native_token"],
    "futureMethods": ["stripe", "paypal", "nft_gate"],
    "gateways": {
      "wayforpay": { "enabled": true, "feePercent": 2.5, "currency": "<main_currency>" },
      "stripe": { "enabled": false, "feePercent": 2.9, "feeFixedCents": 30, "currency": "<main_currency>" },
      "credit_balance": { "enabled": true, "feePercent": 0, "currency": "<main_currency>" },
      "native_token": { "enabled": true, "feePercent": 0, "currency": "<native_token_symbol>", "label": "Tokens" }
    }
  }
}

text


Checkout / upgrade / promotion / wallet top-up
        ↓
lib/payments/conductor/payment-conductor.ts
        ↓
Processors: wayforpay.processor | stripe.processor | credit-balance.processor | native-token.processor | paypal.processor
        ↓
payment_transactions (PostgreSQL, migration 004)
        ↓
lib/payments/conductor/webhook-dispatcher.ts → handlers/* (+ PayPal Subscriptions lifecycle)

Documentation

Quick entry (CTOs · auditors · agents)

Documentation

Quick entry (CTOs · auditors · agents)

Documentation

Quick entry (CTOs · auditors · agents)

Loading documentation...

Documentation

Quick entry (CTOs · auditors · agents)

Loading documentation...

Documentation

Quick entry (CTOs · auditors · agents)

Loading documentation...

Documentation

Quick entry (CTOs · auditors · agents)

Loading documentation...

Loading documentation...

Loading documentation...

Payments Overview

What PaymentConductor covers

What founders get

ring-config.json payment section

Related

Related documentation

PaymentConductor

Ring Oracle

Public Pools & DAO Jars

WayForPay Payment Integration

Payments Overview

What PaymentConductor covers

What founders get

ring-config.json payment section

Related

Related documentation

PaymentConductor

Ring Oracle

Public Pools & DAO Jars

WayForPay Payment Integration

Payments Overview

What PaymentConductor covers

What founders get

ring-config.json payment section

Related

Related documentation

PaymentConductor

Ring Oracle

Public Pools & DAO Jars

WayForPay Payment Integration

Environment variables

Database

Wallet & Credit System

SubscriptionConductor

Payment Gateway Integration

Environment variables

Database

Wallet & Credit System

SubscriptionConductor

Payment Gateway Integration

Environment variables

Database

Wallet & Credit System

SubscriptionConductor

Payment Gateway Integration

`ring-config.json` payment section

`ring-config.json` payment section

`ring-config.json` payment section