Карты клиентов и регулярные списания с карт.
Карты хранятся для того, чтобы с клиентов можно было списывать средства по согласованному с ними графику — отображаются только название марки и последние четыре цифры, карты запечатаны и расшифрованы только для создания файла для банка.
Подписка, ежемесячная плата, рассрочка: клиент соглашается один раз, а оплата производится по графику. В разделе «Бухгалтерия → Платежи по картам» находятся три части — карты, соглашения об их использовании и пакеты платежей, отправляемые в банк. Они созданы в соответствии со стандартом безопасности карточной индустрии (PCI DSS), поэтому номер карты — это единственное, что никто не сможет прочитать на экране в TRANXACT.
Карты
Функция добавления карты забирает данные клиента, номер карты, срок действия, имя владельца карты и почтовый индекс для выставления счетов. После этого карта отображается везде только с указанием бренда и последних четырех цифр: на экране, в файлах загрузок, в ASK, в журнале аудита.
- Номер карты зашифрован: он зашифрован собственным ключом (AES-256-GCM), а этот ключ, в свою очередь, зашифрован ключом шифрования, который платформа хранит вне базы данных. В производственной установке без этого ключа карта вообще не будет сохранена.
- Код безопасности (CVV или CVC), PIN-код и данные магнитной полосы отклоняются при отправке и никогда не сохраняются.
- Одна и та же карта, добавленная дважды, распознается и сохраняется один раз.
- Изменение параметров карты позволяет изменить срок действия, имя владельца карты, почтовый индекс для выставления счетов или статус — но никогда не номер. Новая карта — это новая карта: добавьте её, перенесите на неё права доступа, а затем удалите старую.
- Удаление уничтожает собственный ключ карты, поэтому номер невозможно восстановить, и аннулирует связанные с ним полномочия.
Карточные требования
Договор поручительства — это согласие клиента на списание средств: карта, сумма и валюта, частота списаний (раз в месяц, ежеквартально или ежегодно), дата первого списания и, если таковое имеется, дата окончания. Необходимо, чтобы клиент дал слово в слово то, на что он соглашается в случае оспаривания платежа. Договор поручительства может быть приостановлен, возобновлен или аннулирован.
Пакеты платежей по картам
- При использовании системы начисления платы за каждое обязательство, подлежащее оплате в день выполнения, взимается только одна плата, и не более того: повторное выполнение на ту же дату не влечет за собой двойного начисления платы.
- Экспорт для банка формирует файл, который получает эквайер или банк. Это единственное место, где когда-либо расшифровывается номер карты, для этого требуется собственное разрешение (пакетный экспорт карт), и каждый экспорт записывается — без номеров карт. Загрузите файл, а затем удалите свою копию.
- Ответ банка фиксируется по каждому платежу: урегулирован или не урегулирован.
Кто может что делать
Карты, мандаты на использование карт, пакетные платежи по картам, экспорт пакетных платежей по картам и API для работы с картами (внешние интеграции) — все это предоставляется в разделе «Платформа» → «Роли и авторизации», как и на любом другом экране. ASK и агентам отклоняются все маршруты обработки карт, независимо от их роли.
Карточки с вашего сайта: API для работы с карточками
Веб-сайт или приложение, принимающее карты, может хранить их через внешний API, поэтому номер никогда не передается человеку.
| Вызов | Что это делает |
|---|---|
| POST /api/accounting/card-api/v1/cards | Сохраняет карту. Отправляет заголовок Idempotency-Key: один и тот же ключ, отправленный дважды, сохраняет карту один раз и возвращает тот же ответ. |
| GET /api/accounting/card-api/v1/cards | Карты, замаскированные — название бренда и последние четыре. |
| PATCH …/cards/{id} | Срок действия, имя владельца карты, почтовый индекс для выставления счетов или статус. Номер карты указывать не нужно. |
| УДАЛИТЬ …/cards/{id} | Уничтожает карту, как и карта Delete. |
| /api/accounting/card-api/v1/mandates | Создает и считывает мандаты с ключом идемпотентности аналогичным образом. |
- Вызывающая сторона входит в систему с помощью токена сервисного аккаунта (см. Сервисные аккаунты), и роль этого сервисного аккаунта должна быть явно предоставлена через Card API (внешние интеграции). Роль со всеми правами или роль администратора не учитываются: права должны быть предоставлены по имени.
- В производственной среде вызовы принимаются только по протоколу HTTPS.
- Количество звонков ограничено для каждого аккаунта, а серия отклоненных или недействительных карт — типичная ситуация, когда кто-то проверяет украденные номера — блокирует доступ звонящему.