Платіжна інфраструктура без 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 виконуються через провайдера, яким було сплачено оригінальне замовлення. Якщо замовлення оплачено WayForPay — refund йде в WayForPay refund API. Якщо LiqPay — до LiqPay action=refund тощо. Це забезпечує прямі грошові потоки без посередників. AI агент розпізнає повернення через KeyCRM або Нова Пошта event (зміна статусу ТТН) → запускає return workflow → автоматично скеровує refund до вірного провайдера. Ніякої переплати, ніякого friction.

• Що з ПРРО (програмною РРО) і фіскальними чеками?

  WayForPay має нативну інтеграцію з ПРРО (Кабінет платника податків) — кожна підписка автоматично виставляє фіскальний чек клієнту по email. Активується під час KYC. Для ФОП-3 на спрощеній системі (5%) це обовʼязково при продажу послуг резидентам України. Ми передаємо метадані замовлення (категорія послуги, ставка ПДВ "без ПДВ для ФОП-3"), решта — у WayForPay automation.

• Чи можу я платити криптою / Apple Pay / Google Pay?

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

• А якщо WayForPay тимчасово недоступний?

  Архітектура provider-agnostic (див. ADR-039) — ми можемо emergency-switch на Stripe за один env var (BILLING_PROVIDER=stripe), якщо WayForPay має extended outage. Існуючі підписки залишаються в WayForPay; нові signups йдуть через Stripe до відновлення. Це задокументовано у 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. Дешевше для маленьких сум.

• Виставляєте акти, рахунки, ПДВ-накладні?

  Підписки на ФОП-3 — ми ФОП-3 на спрощеній системі (5%), без ПДВ. WayForPay автоматично формує фіскальний чек через ПРРО — він юридично є закриваючим документом для більшості випадків. Якщо ваша бухгалтерія потребує акт виконаних робіт у форматі docx — пишіть на m.nazar77@gmail.com, виставимо вручну. Юр.особам з ПДВ (рідкісне для UA SMB) — окремий шлях, на старті не оптимізовано.