Карты и автосписания

Полный перечень полей — в глоссарии.

​

Что это и зачем

Раздел «Карты и автосписания» отвечает за сохранённые банковские карты компании. Одна привязанная карта позволяет системе списывать платежи по подписке автоматически, без участия человека: когда наступает срок оплаты, деньги снимаются с карты через платёжный шлюз FreedomPay. Карта хранится не целиком — сам номер и данные для оплаты остаются на стороне шлюза. В системе Yume сохраняются только «указатели» на карту в шлюзе и безопасные для показа реквизиты (маскированный номер, банк, платёжная система, срок действия).

​

Модель данных

Карта компании описывается следующими полями.

​

Инварианты уникальности

У модели два ограничения целостности, которые нельзя нарушить:

1. Одна активная карта на компанию. База данных физически не даст сохранить вторую карту с признаком «активная» для той же компании. Поэтому перед тем как сделать карту активной, система всегда сначала снимает флаг активности со всех прочих карт этой компании.
2. Пара «компания + маскированный номер» уникальна. Одну и ту же карту нельзя привязать к одной компании дважды — повторная привязка обновит уже существующую запись, а не создаст дубликат.

​

Жизненный цикл карты

Карта проходит три этапа: инициализация привязки → подтверждение шлюзом (callback) → использование и, при необходимости, удаление.

​

1. Инициализация привязки

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

• ссылку перенаправления — адрес формы FreedomPay, куда нужно отправить пользователя для ввода данных карты;
• идентификатор платежа — номер операции привязки в шлюзе.

Пользователя перенаправляют на эту форму. Реальные данные карты вводятся уже на стороне шлюза — система Yume их не видит и не хранит.

​

2. Приём подтверждения от шлюза (callback)

После того как пользователь успешно ввёл карту, FreedomPay сам обращается к системе на служебный адрес приёма привязки и присылает XML-уведомление о результате. Обработчик реагирует только на уведомления об успешной привязке. Любое другое уведомление отклоняется. Из уведомления берутся: идентификатор компании, идентификатор карты в шлюзе, маскированный номер, токен, профиль рекуррента, банк и срок действия. Дальше происходит следующее:

1. Если в уведомлении нет идентификатора компании или идентификатора карты — запрос отклоняется.
2. Если компания с таким идентификатором не найдена — запрос отклоняется.
3. Со всех текущих активных карт этой компании снимается признак активности.
4. Карта создаётся заново или обновляется (если карта с таким идентификатором в шлюзе уже была). Ей проставляется статус «Подтверждена» и признак «активная».
5. Администраторам уходит уведомление о привязке карты с указанием маскированного номера и банка.

​

3. Просмотр и переключение активной карты

При запросе списка карт компания видит все свои привязанные карты, отсортированные от самых свежих к самым старым. Здесь работает важное «самолечение»: если у компании есть карты, но ни одна из них не активна, система автоматически делает активной самую свежую карту. Это гарантирует, что при наличии хотя бы одной карты автосписания всегда есть с чего проводить. Пользователь может вручную переключить активную карту. При активации другой карты система сначала снимает признак активности со всех остальных карт компании, и только потом активирует выбранную — так соблюдается правило единственной активной карты. Все остальные поля карты доступны только для чтения: через этот механизм можно менять лишь признак активности (и, технически, флаг разрешения автосписаний).

​

4. Удаление карты

При удалении карты система сначала обращается к шлюзу с командой удалить карту (по её токену). Запись в системе удаляется только если шлюз подтвердил удаление (вернул статус «удалена»). После успешного удаления:

1. Администраторам уходит уведомление об удалении карты с маскированным номером и банком.
2. Если у компании после удаления не осталось ни одной активной карты, система берёт любую из оставшихся неактивных карт и делает её активной.

​

Роль карты в автосписаниях

Активная карта — это то, с чего идут рекуррентные (повторяющиеся) списания по подписке. Когда приходит время выставить и оплатить очередной счёт, система использует профиль рекуррента активной карты, чтобы провести списание во FreedomPay без участия пользователя. Флаг «разрешены автосписания» по умолчанию включён у каждой привязанной карты. Именно связка «активная карта + разрешённый рекуррент + профиль рекуррента» делает возможным автоматическое продление подписки.

​

Как это используется на практике

• Первая привязка. Пользователь запускает привязку, вводит карту на форме шлюза, шлюз присылает подтверждение — карта становится активной автоматически. Отдельно её включать не нужно.
• Несколько карт. Компания может привязать несколько карт «про запас», но списываться будет только с активной. Смена активной карты выполняется вручную одним переключением.
• Замена карты. Чтобы перевести автосписания на другую карту, достаточно сделать её активной — прежняя останется привязанной, но списаний с неё больше не будет.
• Отказ от карты. Удаление снимает карту и в шлюзе, и в системе; если это была последняя активная, роль активной автоматически переходит к другой сохранённой карте.

​

Связанные страницы