Платежная инфраструктура без vendor lock-in

Что под капотом

interface SubscriptionProvider {
  id: 'demo' | 'wayforpay' | 'stripe';
  isConfigured(): boolean;
  createCheckout(args): Promise<{ url }>;
  createPortal(args): Promise<
    | { kind: 'hosted'; url }
    | { kind: 'unsupported'; reason }
  >;
}

type RefundProviderId =
  | 'liqpay' | 'monobank'
  | 'stripe' | 'manual';

executePaymentRefund(provider, {
  paymentIntentId,
  amountUah,
  reason,
  idempotencyKey,
}) => Promise<RefundResult>

Кодовая база открыта на GitHub — apps/orchestrator/src/billing/.

FAQ — Платежи

• Почему вы не используете Stripe как primary, как все западные SaaS?

  Stripe для UA ФОП-3 требует либо EU LLC (Estonia OÜ / Польша sp. z o.o.), либо Stripe Atlas (US LLC). Оба пути стоят денег и времени, которые мы сейчас вкладываем в продукт. WayForPay принимает украинского ФОП-3, интегрируется с ПРРО для автоматических чеков и имеет нативный UAH recurring без FX-обменов. Stripe остается в кодовой базе — активируем при Y2 EU expansion.

• Безопасно ли платить через WayForPay?

  WayForPay имеет сертификацию PCI DSS Level 1 (высочайший уровень для платежных провайдеров). Данные карты никогда не касаются наших серверов — вы вводите их на hosted checkout WayForPay; мы получаем только tokenized identifier для recurring charges. 3-D Secure 2.0 обязательный. То же для LiqPay, Monobank.

• Как автоматизируются возвраты (refunds)?

  Refunds маршрутизируются к провайдеру, которым была изначально оплачена подписка. Сценарий: клиент возвращает посылку → AI агент распознает событие через KeyCRM → выполняет refund через соответствующего провайдера (WayForPay refund API, LiqPay action=refund, Monobank API). Для заказов оплаченных через WayForPay — refund через WayForPay. Для других — через LiqPay или Monobank. Все провайдеры PCI DSS compliant и поддерживают ПРРО интеграцию.

• Что с ПРРО (программной РРО) и fiscal receipts?

  WayForPay имеет нативную интеграцию с ПРРО (Cabinet of Taxpayer) — каждая подписка автоматически выставляет fiscal receipt клиенту по email. Активируется во время KYC. Для ФОП-3 на упрощенной системе (5%) это обязательно при продаже услуг резидентам Украины. Мы передаем metadata заказа (категория услуги, ставка VAT "VAT-exempt для ФОП-3"), остальное — в WayForPay automation.

• Могу ли я платить крипто / Apple Pay / Google Pay?

  Apple Pay + Google Pay — да, через WayForPay native wallet support. Криптовалюты — нет в V1; рассмотрим в Y2 когда будет регуляторная ясность по NBU directive касательно virtual assets.

• А если WayForPay временно недоступен?

  Архитектура provider-agnostic (см. ADR-039) — мы можем emergency-switch на Stripe одной env переменной (BILLING_PROVIDER=stripe), если WayForPay имеет extended outage. Существующие подписки остаются в WayForPay; новые signups идут через Stripe до recovery. Это документировано в production-deploy runbook.

• Сколько процентов берет WayForPay? Это повлияет на мою цену?

  WayForPay комиссия ~2.7-3% от суммы + ПРРО fee (~₴1-2 на чек). Эти расходы мы покрываем из marketplace margin, ваша цена на Unitelia не меняется. Для сравнения: Stripe для UA ФОП — 2.9% + $0.30 fixed fee на транзакцию, что для плана $49/месяц составляет ~$1.72 vs WayForPay ~$1.32-1.47. Дешевле для маленьких сумм.

• Выставляете акты, счета, VAT invoices?

  Подписки на ФОП-3 — мы ФОП-3 на упрощенной системе (5%), без VAT. WayForPay автоматически формирует fiscal receipt через ПРРО — он юридически является закрывающим документом для большинства случаев. Если ваша бухгалтерия требует service agreement в docx формате — пишите на m.nazar77@gmail.com, выставим вручную. Для legal entities с VAT (редко для UA SMB) — отдельный путь, не оптимизировано при launch.