С чего начать

База знаний по нашему процессинговому продукту: как устроены платежи, какой сервис за что отвечает и где искать ответы. Читается сверху вниз — от общей картины к деталям.

Если вы новый разработчик

Идите по порядку, не перепрыгивая:

1. Платёжная система за десять минут — общая картина.
2. Словарь — термины, которые звучат в любом разговоре.
3. Продукт глазами бизнеса — что мы продаём.
4. Транзакция и модель денег — как система учитывает происходящее.
5. Три сценария подряд, чтобы увидеть картину целиком:
   • Платёж картой server-to-server — базовый флоу, на котором держится всё остальное.
   • Платёж через нашу форму — тот же путь, но карту собираем мы.
   • Выплата — те же механизмы в обратную сторону.
6. Статусы и стадии — язык, на котором система описывает состояние платежа.
7. Почему шлюзов несколько и карточки сервисов критического пути.
8. Как начать кодить — доступы и настройка рабочего места.

После этого можно читать раздел механик выборочно — по мере того, как задачи будут приводить вас в конкретную подсистему.

Потрогать систему

Прочитать про платёж и провести его самостоятельно — разные вещи. Прежде чем браться за первую задачу, пройдите весь путь платежа руками от начала до конца:

Как всё это создать в BackOffice — в гиде по BackOffice.

1. Создайте тестовый стенд.
2. Создайте тестового мерчанта.
3. Создайте EUR sandbox-гейт.
4. Создайте EUR счёт для выплат с этим гейтом.
5. Создайте EUR счёт для оплат с этим гейтом.
6. На тестовом мерчанте создайте h2h-оплату по API.
7. Создайте оплату через платёжную форму по API.
8. Пополните баланс выплатного счёта.
9. Сделайте выплату по API.
10. Проверьте статус выплаты по API.

Скриншоты запросов и ответов, а также скриншоты карточек транзакций из бэкофиса приложите своему куратору в рамках онбординга.

Если вы разбираете инцидент

Начните со статусов и стадий: пара «статус и стадия» почти однозначно указывает, на каком шаге остановился платёж. Дальше — раздел «Где ломается чаще всего» в базовом флоу. Инфраструктурная диагностика (сеть, балансировщики, логи) живёт не здесь, а в репозитории superpos-prod-architecture.

Как устроена база

Флоу отвечают на вопрос «что происходит и в каком порядке». Подробно описан только базовый платёж; остальные сценарии изложены как отличия от него.

Механики отвечают на вопрос «как устроена подсистема» — выбор банка, 3DS, токенизация, антифрод, очереди. На них ссылаются все флоу, чтобы не повторять одно и то же.

Карточки сервисов отвечают на вопрос «кто за это отвечает» и, что не менее важно, чего сервис не делает.

Чего здесь нет: устройства инфраструктуры (оно в superpos-prod-architecture), описания интеграций с конкретными банками (в репозитории драйверов) и публичной документации API для мерчантов (отдельный сайт документации).