Neosurf: ваучеры наличными
1) Что такое Neosurf и когда его выбирать
Neosurf — предоплаченный ваучерный метод оплаты: пользователь покупает ваучер за наличные/картой у офлайн-партнеров (киоски, супермаркеты, АЗС) или пополняет баланс myNeosurf и затем платит онлайн, вводя PIN-код ваучера либо авторизуясь в кошельке. Средства списываются мгновенно, риск чарджбэка, как в картах, отсутствует; возвраты оформляются как отдельные кредитовые операции согласно правилам провайдера/PSP.
Где работает хорошо
Цифровые товары, игры, подписки с невысоким чеком.
Аудитории с низкой карт-пенетрацией/доверие к наличным.
Рынки с развитой ритейл-сетью продажи ваучеров.
2) Экосистема и роли
Провайдер/схема: выпуск ваучеров, правила KYC/KYB, антифрод, кошелек myNeosurf.
Ритейл-сеть: продажа ваучеров/пополнение кошельков, выдача чека с PIN.
PSP/эквайер: подключение мерчанта, хостед-касса/SDK/API, статусы, отчеты и расчеты.
Мерчант: инициирует оплату, обрабатывает статусы и возвраты, ведет сверку.
Плательщик: вводит PIN или входит в myNeosurf и подтверждает списание.
3) Продукты и сценарии
Neosurf Voucher (PIN): оплата одним или несколькими ваучерами; поддерживаются частичные списания и комбинация ваучеров (в пределах лимитов).
myNeosurf (кошелек): оплата из баланса; удобно для повторных покупок и возвратов.
Инвойс/Pay-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 и поведение
Зависят от страны, валюты, статуса KYC пользователя (анонимный ваучер vs кошелек с верификацией) и политики риска:- 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.
- Каталоги: страны/валюты, лимиты/KYC-уровни, коды ошибок, SLA-метрики.
12) Подписки и повторные списания
Базовый ваучер — one-off. Для рекуррентных платежей:- использовать 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 и комбинацию ваучеров.
Не «вшивайте» суммы: ведите конфиги лимитов/KYC по странам и регулярно актуализируйте.
Для подписок — первый ваучер → мандат/myNeosurf с прозрачным управлением и уведомлениями.