PayStar API Documentation
  1. ВОЗМОЖНОСТИ | RU
  • MERCHANT
    • PRODUCTS | EN
    • ПРОДУКТЫ | RU
    • Untitled Doc
    • FEATURES | EN
      • Deposits & Payouts
      • Issues (Tickets)
      • Secure data (One-time secret)
      • Summary Report
      • Payment Analytics
      • Payment Form Analytics
      • Unified audit log
      • Export reports
      • Black list
      • Routing & Cascading
      • Limits
      • Commissions
      • Team
      • My Account
      • PayStar in 100 Questions
    • ВОЗМОЖНОСТИ | RU
      • Депозиты и выплаты
      • Issues (Задачи)
      • Защищённые данные (One-time secret)
      • Сводный отчёт
      • Аналитика по платежам
      • Единый журнал событий
      • Аналитика платёжной формы
      • Экспорт отчётов
      • Черный список
      • Мавршрутизация и Каскады
      • Лимиты
      • Комиссии
      • Команда
      • Мой аккаунт
      • PayStar в 100 вопросах
    • 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
  • AGENT (REFERRAL)
  1. ВОЗМОЖНОСТИ | 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