Neosurf: ваучери готівкою

1) Що таке Neosurf і коли його вибирати

Neosurf - передплачений ваучерний метод оплати: користувач купує ваучер за готівкою/карткою у офлайн-партнерів (кіоски, супермаркети, АЗС) або поповнює баланс myNeosurf і потім платить онлайн, вводячи PIN-код ваучера або авторизуючись в гаманці. Кошти списуються миттєво, ризик чарджбека, як в картах, відсутній; повернення оформляються як окремі кредитові операції згідно з правилами провайдера/PSP.

Де працює добре

Цифрові товари, ігри, підписки з невисоким чеком.
Аудиторії з низькою карт-пенетрацією/довіра до готівки.
Ринки з розвиненою рітейл-мережею продажу ваучерів.

2) Екосистема і ролі

Провайдер/схема: випуск ваучерів, правила KYC/KYB, антифрод, гаманець myNeosurf.
Рітейл-мережа: продаж ваучерів/поповнення гаманців, видача чека з PIN.
PSP/еквайєр: підключення мерчанта, хостед-каса/SDK/API, статуси, звіти та розрахунки.
Мерчант: ініціює оплату, обробляє статуси і повернення, веде звірку.
Платник: вводить PIN або входить в myNeosurf і підтверджує списання.

3) Продукти та сценарії

Neosurf Voucher (PIN): оплата одним або декількома ваучерами; підтримуються часткові списання і комбінація ваучерів (в межах лімітів).
myNeosurf (гаманець): оплата з балансу; зручно для повторних покупок і повернень.
Інвойс/Рау-by-Link: платіжне посилання від PSP з введенням PIN/входом в гаманець на хостед-сторінці.

4) Потоки оплати

4. 1 Hosted/Redirect (рекомендується)

1. Checkout → вибір Neosurf.
2. Редирект на хостед-сторінку PSP/провайдера → введення PIN або вхід в myNeosurf → підтвердження.
3. Повернення до мерчанта з'status'( success/failed/canceled/pending) і'paymentId'.
4. Фінальний кредит відображається в щоденних реєстрах (settlement).

4. 2 Embedded/Widget

Вбудований віджет PIN/myNeosurf в касі. Вимагає дотримання UI/безпеки і політики провайдера.

4. 3 Server-to-Server

Бекенд мерчанта ініціює платіж і опитує статус; PIN завжди вводиться на стороні провайдера/віджета, щоб не зберігати чутливі дані.

5) Ліміти, KYC і поведінка

• Per-transaction, добові/тижневі ліміти.
• Обмеження на кількість ваучерів в одній оплаті.
• Гео-обмеження (країна випуску ваучера vs країна мерчанта/гаманця).
• Для нових мерчантів/категорій - знижені пороги, step-up перевірки.

6) Статуси, розрахунки та повернення

Онлайн-статуси: `success`, `pending`, `failed`, `canceled`, `expired`.
Settlement: кредит за звітами PSP/провайдера (зазвичай T + 1/T + 2 робочі дні, договірно).
Chargeback відсутній.
Refunds: окрема кредитова операція (в myNeosurf або за узгодженим каналом); підтримуються partial refunds.
Часткове списання: залишок залишається на PIN/гаманці (залежить від налаштування/регіону).

7) Економіка і тарифи

Тарифи, як правило, нижче CNP-карткового MDR, варіюються за гео/обсягом/категорією (ігри, цифрові послуги тощо).
Допзатрати: hosted/SDK, саппорт і ODR, обробка'pending/expired', recon.

8) UX-патерни каси

Де купити ваучер: карта/пошук точок продажу підвищують конверсію новачків.
Комбінація PIN: зручний UI додавання декількох ваучерів + показ залишку.
Ясні помилки: «невірний/вже використаний PIN», «ліміт перевищено», «регіон не підтримується».
Квитанція: сума, час,'paymentId', метод (PIN/myNeosurf); для повернення - «refundId».
Локалізація: валюта/мова/юртексти країни клієнта.

9) Комплаєнс і безпека

Автентифікація та перевірка PIN/гаманця - на стороні провайдера (SCA/поведінковий скоринг).
PII-мінімізація: не обробляйте PIN у себе; використовуйте hosted/віджет.
Webhooks: HMAC/nonce, захист від replay, дедуп подій, аудит.
KYC/AML/GDPR: вікові та лімітні вимоги для передплачених коштів; санкційні/гео-обмеження.

10) Звірка та звітність (reconciliation)

Логіруйте: 'paymentId','orderId', метод (PIN/myNeosurf), валюта, сума, статус, timestamps, банківську/фінансову референцію (UTR) з реєстрів PSP.
Щодня: auto-recon касових подій з фін-реєстрами (зарахування/повернення/корекції).
Алерти: «успіх без запису в реєстрі», «подвійне списання», «pending, що довго висить».

11) Інтеграція мерчанта

Варіанти

1. Hosted/Embedded від PSP - швидкий старт і відповідність вимогам безпеки.
2. Server-to-Server + Hosted PIN - контроль статусів без обробки PIN у вас.
3. Pay-by-Link/Invoice - для відкладених платежів і саппорту.

• API: `createPayment`, `refund`, `queryStatus`, `webhook`, `reconcile`.
• Ідемпотентність ('orderId'+ ключ), експоненціальні ретраї, DLQ.
• Каталоги: країни/валюти, ліміти/КУС-рівні, коди помилок, SLA-метрики.

12) Підписки і повторні списання

• використовувати myNeosurf як джерело засобів (якщо дозволено),
• або схему перший ваучер → мандат (SEPA/Open Banking) для майбутніх дебетів.
• Покажіть користувачеві екран управління мандатом (ліміт/періодичність/повідомлення).

13) Антифрод і політика ризику

Сигнали: невідповідність гео (IP/ваучер/мерчант), часті помилки PIN, повторні спроби, зв'язок акаунтів через одні і ті ж PIN.
Мітигіція: ліміт на число PIN за сесію/добу, cooling-off, капча/step-up, м'які відмови з поясненням.

14) High-risk вертикалі (включаючи iGaming)

Доступність, пороги та звітність залежать від країни та політики провайдера/PSP.
Очікуйте знижені ліміти, посилений моніторинг транзакцій і вимоги до верифікації.
Тримайте альтернативні рейки (інші ваучери, A2A, карти) і smart-routing.

15) Архітектура «Neosurf Gateway»

API-шар (REST/GraphQL) каси/білінгу.
Черги подій: статуси → білінг/CRM/аналітика/саппорт.
Security: vault секретів, IP-allowlist, сувора валідація redirect-URI, анти-replay токени.
Observability: конверсія (PIN vs myNeosurf), «pending→success/expired», середня латентність, частка часткових/комбінованих списань, метрики повернень.

16) Чек-лист виведення в прод

1. Підключіть канал у PSP і увімкніть Hosted PIN/myNeosurf.
2. Реалізуйте'createPayment'+ веб-хуки (HMAC), ідемпотентність і повтори.
3. Увімкніть partial refunds, сценарії комбінування ваучерів і зрозумілі помилки.
4. Налаштуйте daily auto-recon + періодичний full-recon; зберігайте фін-референції/UTR.
5. Дашборди SLA і алерти на підвислі'pending', високу частку'failed', аномалії по гео.
6. E2E-тести з країн/валют: кілька PIN, часткове повернення, прострочені PIN/ліміти.

Картка орієнтирів

Статуси: `success/pending/failed/canceled/expired`.
Settlement: зазвичай T + 1/T + 2 за реєстрами.
Chargeback: ні; refund - окрема кредитова операція (частинами допустимо).
Комбінація PIN: дозволена в межах лімітів.
Рекурент: через myNeosurf або альтернативний мандат (після першого платежу).

Резюме

Вибирайте Neosurf для готівкової аудиторії та мікроплатежів: hosted PIN/myNeosurf → швидко і безпечно.
Будуйте процес навколо webhooks + recon, підтримуйте partial refunds і комбінацію ваучерів.
Не «вшивайте» суми: ведіть конфіги лімітів/КУС по країнах і регулярно актуалізуйте.
Для підписок - перший ваучер → мандат/myNeosurf з прозорим управлінням і повідомленнями.