PayStar API Documentation
  1. PAYSTAR FEATURES | RU
  • PRODUCTS & FEATURES | EN
    • GATEWAY QUALITY INDEX (GQI)
    • DIRECT CONNECT
    • PAYSTAR CORE
    • Deposits section in PayStar
    • Summary Report
    • Payment Analytics
    • Payment Form Analytics
    • Unified audit log
    • Export reports
    • Black list
    • Commissions
    • Team
    • My Account
    • PayStar in 100 Questions
  • PAYSTAR FEATURES | RU
    • ИНДЕКС КАЧЕСТВА ПЛАТЕЖНЫХ ШЛЮЗОВ
    • ПРЯМОЕ ПОДКЛЮЧЕНИЕ
    • PAYSTAR ЯДРО
    • Депозиты
    • Сводный отчёт
    • Аналитика по платежам
    • Аналитика платёжной формы
    • Единый журнал событий
    • Экспорт отчётов
    • Черный список
    • Комиссии
    • Команда
    • Мой аккаунт
    • PayStar в 100 вопросах
  • MERCHANT API DOC | EN
    • Introduction
    • Glossary
    • Authorization key
    • Sandbox
    • Additional fields
    • Currencies
    • Bank names
    • Telecom operators
    • Callbacks
    • Error descriptions
    • Tech FAQ
    • Events
    • Payment history v2
      • Payment history - backward compatibility (legacy `X.Y.Z.W`)
    • Integratins
      • Stripe
      • Inwizo
      • 2Checkout
      • Adyen
      • AffiniPay
      • Alikassa
      • AlliancePay
      • Amazon Pay
      • AnyMoney
      • AstroPay
      • Aureavia
      • AurisMyChanger
      • Authorize.Net
      • Avatarix
    • Balance H2H
    • Deposit H2H - Card & P2P
    • Deposit H2H - Token
    • Deposit H2C - Card
    • Deposit status H2H - PayStar ID
    • Deposit status H2H - Merch ID
    • Payout H2H
    • Payout status H2H - PayStar ID
    • Payout status H2H - Merch ID
  1. PAYSTAR FEATURES | RU

Черный список

Раздел Black list — это простой инструмент для жёсткой блокировки подозрительных реквизитов (карта / email / IP / телефон / PayeerIdentifier). Он помогает быстро остановить повторные проблемные попытки, снизить риск фрода и разгрузить саппорт — до того, как трафик уйдёт в роутинг и дальше к провайдерам.
image.png

1) Когда нужен Black list#

Black list полезен, когда вы точно уверены, что конкретный реквизит нельзя пропускать:
фродовые реквизиты (повторяются, “бьют” по конверсии и лимитам провайдеров);
тестовые прогоны/переборы;
пользователи/реквизиты из расследований (support case / risk case);
профилактика повторных chargeback-историй.
Важно: Black list — это постоянная блокировка, она действует до тех пор, пока запись не удалят или не изменят.

2) By Merch vs By Pipeline — как выбрать область действия#

При добавлении записи вы выбираете вкладку:
By Merch — блокировка применяется для мерчанта (шире по охвату).
By Pipeline — блокировка действует только внутри выбранного пайплайна (точечно, меньше риск “задеть” другие маршруты).
image.png

3) Какие типы реквизитов можно блокировать#

TypeЧто блокируемПример
CardНомер карты4111111111111111
EmailEmail плательщикаuser@mail.com
IPIP-адрес203.0.113.10
PhoneТелефон+447700900123
PayeerIdentifierИдентификатор плательщика12345678980

image.png#

4) Как добавить запись в Black list#

1.
Откройте Black list.
2.
Нажмите + Add new.
3.
Выберите вкладку By Merch или By Pipeline.
4.
Выберите Merchant или Pipeline.
5.
Выберите Type.
6.
Введите значение в Requisites.
7.
(Опционально) заполните Description — комментарий/причину.
8.
Нажмите Add.

Что означают поля#

Merchant / Pipeline — где именно применяется правило блокировки.
Type — тип реквизита (карта/email/IP/телефон/идентификатор).
Requisites — конкретное значение, которое нужно заблокировать.
Description — причина/контекст (например: fraud, chargeback, test user, case #1234).

5) Поиск и фильтры#

Вверху страницы доступны фильтры:
Created
Merchant
Pipeline
Type
Requisites
Description
Кнопка Clear Filters сбрасывает все фильтры.

image.png#

6) Как изменить запись (Update)#

1.
В строке записи откройте меню ⋮.
2.
Выберите Update.
3.
Внесите изменения и нажмите Save.

7) Временная блокировка: почему лучше делать через роутинг#

Если вам нужно временно ограничить пользователя — например:
“более N неуспешных попыток за 24 часа”,
“более N попыток с одного IP за час”,
“подозрительная динамика — отправлять в отдельный сценарий”,
то это правильнее задавать в роутинге, потому что:
можно задать порог и окно времени,
блокировка может сниматься автоматически по окончании периода,
можно выбрать мягкую реакцию (не всегда нужен полный запрет): понижение приоритета, другой сценарий, другой PSP и т. п.
Полезное: пример логики роутинга (видео)
https://youtu.be/9BhqEqoIRAM

8) Бизнес-практики: как не “убить” конверсию#

Начинайте с точечного подхода: By Pipeline → расширяйте до By Merch только при необходимости.
В Description всегда фиксируйте причину и источник (support/risk case).
Для временных лимитов используйте роутинг, а не “вечные” записи.
Делайте ревизию списка:
быстрый просмотр — раз в неделю,
чистка устаревшего/дубликатов — раз в месяц/квартал.

9) FAQ#

1. Что произойдёт при совпадении с Black list?
Попытка будет заблокирована по правилу чёрного списка и не пойдёт дальше по обработке.
2. Что выбрать: By Merch или By Pipeline?
By Merch — шире, для мерчанта.
By Pipeline — точечно, для конкретного потока.
3. Можно ли использовать Black list как “whitelist”?
Нет. Это инструмент запрета. Для исключений/приоритизации используйте роутинг.
4. Можно ли сделать TTL (время жизни записи)?
В интерфейсе Black list запись действует до удаления/изменения. Для временных правил — используйте роутинг.
5. Что писать в Description?
Коротко и понятно для аудита: fraud, chargeback, bonus abuse, test, case #1234, provider request.
6. Что делать при false positive (заблокировали “нормального” клиента)?
Найдите запись, уточните scope (часто помогает переход на By Pipeline) и исправьте/удалите, добавив комментарий “почему сняли блок”.
Previous
Экспорт отчётов
Next
Комиссии
Built with