---
title: "PaymentConductor"
description: "Единая оркестрация платежей для магазина, членства и промоции новостей — WayForPay, Stripe, внутренний кредит"
locale: "ru"
---
# PaymentConductor

PaymentConductor (v1, 2026-05-22) — конфигурируемый платёжный слой Ring Platform. Один реестр (`payment_transactions`) и один диспетчер webhook обслуживают checkout магазина, повышение членства и промоцию новостей.

## Архитектура

```
Checkout / upgrade / promotion
        ↓
lib/payments/conductor/payment-conductor.ts
        ↓
Процессоры: wayforpay | stripe | credit_balance
        ↓
payment_transactions (PostgreSQL)
```

Реализация: `lib/payments/conductor/`, `lib/payments/processors/`, `lib/payments/payment.config.ts`.

## Назначения платежей

| Purpose | Обработчик | Типичный процессор |
|---------|------------|-------------------|
| `store_order` | `handlers/store-order.ts` | WayForPay или Stripe |
| `membership_upgrade` | `handlers/membership-upgrade.ts` | WayForPay или Stripe |
| `news_promotion` | `handlers/news-promotion.ts` | WayForPay или Stripe |

Переопределение через env: `PAYMENT_STORE_PROCESSOR`, `PAYMENT_MEMBERSHIP_PROCESSOR`, `PAYMENT_NEWS_PROCESSOR`. По умолчанию: `PAYMENT_DEFAULT_PROCESSOR`.

## Переменные окружения

```bash
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=RUB
```

## База данных

Примените миграцию `data/migrations/004_payment_transactions.sql` перед продакшеном.

## Связанное

- [Обзор платежей](/docs/features/payments.md)
- [WayForPay](/docs/features/wayforpay-integration.md)
- [Архитектура PaymentConductor](/docs/architecture/payment-conductor.md)