Словарь

Термины, без которых первые разговоры в команде звучат как шифр. Порядок — от участников к внутренней кухне, а не по алфавиту.

Участники

Мерчант — наш клиент, принимающий платежи: магазин, сервис, платформа. В системе у него есть ключ, секрет, настройки и счета.

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

Эквайер — банк или платёжный провайдер, через который мы проводим операцию. Иногда это настоящий банк, иногда посредник; в коде и разговоре разница часто стирается.

Эмитент — банк, выпустивший карту плательщика. Напрямую мы с ним не общаемся.

Деньги и сущности

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

Счёт — счёт мерчанта у нас, в конкретной валюте. Хранит баланс и настройки приёма платежей.

Удержание (hold) — часть суммы, которая уже принята, но пока недоступна мерчанту. Страховка на случай возвратов и споров.

Роллинг — вид удержания, при котором фиксированная доля оборота придерживается на оговорённый срок.

Комиссия — наша плата за проведение операции, рассчитывается при финализации.

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

Проведение платежа

Гейт — настроенное подключение к конкретному эквайеру: валюта, лимиты, секреты, параметры. Один эквайер может быть представлен несколькими гейтами.

Драйвер — код, который умеет разговаривать с API конкретного эквайера. Гейт указывает, какой драйвер использовать.

Балансировщик (каскад) — список гейтов с правилами перебора. Если первый не подходит или отказал, пробуем следующий.

Стадия — подсостояние транзакции внутри обработки: на каком именно шаге она сейчас находится. См. статусы и стадии.

Финализация — момент, когда транзакция получает окончательный результат и меняется баланс мерчанта.

Колбек — уведомление о результате. Входящий приходит к нам от банка, исходящий уходит от нас мерчанту. Два разных механизма, которые легко перепутать.

Карты и безопасность

PAN — номер карты. CVV — код на обороте. Вместе с сроком действия это и есть те данные, ради которых существует отдельный защищённый контур.

PCI DSS — стандарт безопасности карточных данных. На практике означает, что код, видящий настоящий номер карты, живёт в отдельном контуре и проходит аудит.

Токен карты — постоянный заменитель номера карты, одинаковый для одной и той же карты между платежами.

Токен сессии — временный заменитель полного набора данных, включая CVV, который нельзя хранить долго.

3DS — процедура подтверждения операции держателем карты: плательщика перенаправляют на страницу его банка. ACS — та самая страница банка; «вернулся с ACS» означает, что плательщик прошёл подтверждение.

Антифрод — проверка платежа на мошенничество до отправки в банк.

Отпечаток (fingerprint) — набор характеристик браузера и устройства плательщика, используется антифродом.

Наши сценарии

H2H (host-to-host) — платёж, при котором карту собирает мерчант и присылает нам серверным запросом.

Hosted-форма — наша платёжная страница, на которой карту вводит сам плательщик.

Выплата (withdrawal) — перевод денег в обратную сторону: от мерчанта получателю.

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

CVU — аргентинский аналог банковских реквизитов, используется в местных переводах.

FTD-probe — проверочный платёж на маленькую сумму, которым система прощупывает карту или гейт перед основной операцией.