Платіжна інфраструктура без привʼязки до постачальника

Що під капотом

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 як основний, як усі західні SaaS?

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

• Чи безпечно платити через WayForPay?

  WayForPay має сертифікацію PCI DSS Рівень 1 (найвищий рівень для платіжних провайдерів). Дані картки ніколи не торкаються наших серверів — ви вводите їх на розташованому оформленні замовлення WayForPay; ми отримуємо лише токенізований ідентифікатор для повторюваних зборів. 3-D Secure 2.0 обовʼязковий. Те саме для LiqPay, Monobank та інших провайдерів.

• Як автоматизуються повернення?

  Повернення виконуються через провайдера, яким було сплачено оригінальне замовлення. Якщо замовлення оплачено WayForPay — повернення йде до API повернення WayForPay. Якщо LiqPay — до дії повернення LiqPay тощо. Це забезпечує прямі грошові потоки без посередників. ШІ-агент розпізнає повернення через KeyCRM або подію Нови Пошти (зміна статусу ТТН) → запускає робочий процес повернення → автоматично скеровує повернення до вірного провайдера. Жодних додаткових витрат, жодного тертя.

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

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

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

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

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

  Архітектура, незалежна від постачальника (див. ADR-039) — ми можемо аварійно перейти на Stripe за одну змінну середовища (BILLING_PROVIDER=stripe), якщо WayForPay має тривале відключення. Існуючі підписки залишаються в WayForPay; нові реєстрації йдуть через Stripe до відновлення. Це задокументовано у посібнику розгортання виробництва.

• Скільки відсотків бере WayForPay? Це вплине на мою ціну?

  Комісія WayForPay ~2.7-3% від суми + збір ПРРО (~₴1-2 на чек). Ці витрати ми покриваємо з маржі ринку, ваша ціна на Unitelia не змінюється від цього. Для порівняння: Stripe для UA ФОП — 2.9% + $0.30 фіксована комісія на транзакцію, що для плану $49/міс становить ~$1.72 vs WayForPay ~$1.32-1.47. Дешевше для маленьких сум.

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

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