Статусы карты

Редактировал(а) Татьяна Брыкова 2025/12/15 10:26

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

Статус карты Новая

В статусе «Новая» карты можно выпустить заданием на выпуск, если в задании снять значение «Активировать карты».

1706012443949-316.png

Рис. Параметр «Активировать карты» со значением Нет в Задании на выпуск карт

В данном статусе по карте невозможны ручные операции начисления. Первая транзакция с чеком по карте переводит карту в статус «Активная». Такой транзакцией может быть даже регистрация мягкого чека.

1706012917808-449.png

Рис. Карты со статусом «Новая»

Статус карты Активная

В статусе «Активная» карты можно выпустить заданием на выпуск, если в задании на выпуск указано значение «Активировать» (данное значение проставляется в задании по умолчанию).

1706012986420-423.png

Рис. Параметр «Активировать карты» со значением Да в Задании на выпуск карт

В данном статусе по карте возможны все операции с начислением и списанием баллов, а также предоставление скидок.

1706013046114-766.png

Рис. Карты со статусом «Активная»

Есть возможность импорта контактов в систему из внешнего файла при котором происходит создание соответствующих контактов и прикрепление к контактам карт со статусом «Активная» (в доработке).

Статус карты Заблокирована

В статусе «Заблокирована» по карте невозможно совершить операции начисления и списания баллов, а также воспользоваться скидками. При совершении транзакции по такой карте будет возвращена ошибка, что операция запрещена по статусу карты.

Для обычной блокировки карты необходимо на форме карты нажать кнопку «Заблокировать». Необходимо иметь в виду, что воспользоваться баллами по заблокированной через эту кнопку карте можно в том случае, если у контакта есть вторая карта в статусе «Активная», или же заблокированная карта входит в мастер-счёт наряду с активными картами. То есть при совершении операции по активной карте могут быть списаны баллы с другой заблокированной карты этого контакта или мастер-счёта, если активная и заблокированная карта входят в этот мастер-счёт.

1706013528333-408.png

Рис. Блокировка карты

После этого система запросит подтверждение необходимости блокировки карты.

1706013584258-672.png

Рис. Подтверждение блокировки карты

1706013629036-570.png

Рис. Карта со статусом «Заблокирована»

Однако в системе есть возможность заблокировать карту так, чтобы нельзя было воспользоваться баллами по данной карте, в том числе при совершении операции по другой активной карте контакта или мастер-счета, в который входит эта заблокированная карта. Для такой особой блокировки необходимо нажать на форме карты кнопку «Заблокировать по ФРОД».

1706013680830-440.png

Рис. Блокировка карты по ФРОД

После этого система так же запросит подтверждение необходимости блокировки карты.

1706013706047-158.png

Рис. Подтверждение блокировки карты по ФРОД

После блокировки карты по ФРОД у нее меняется не только статус на «Заблокирована», но и состояние на «Заблокирована по особым обстоятельствам».

1714635639895-654.png

Рис. Статус и состояние карты после блокировки карты по ФРОД

При необходимости вернуть карту в состояние Активная или Новая после блокировки по фроду, помимо изменения статуса карты по кнопке "Активировать"/«Новая» обязательно требуется поменять значение в поле "Состояние" на соответствующее статусу карты.

1714636282549-687.png

Рис. Изменение значения в поле "Состояние" при смене статуса карты после блокировки по фроду

В противном случае, если состояние карты останется "Заблокирована по особым обстоятельствам" при статусе карты Активная/Новая, начисления и списания по карте будут невозможны.

Если карта заблокирована по ФРОД и включена партнерская настройка Loyalty.Interface.BlockingCouponsWhenCardBlocked.TurnOn, то все купоны, связанные с блокируемой картой и непосредственно с контактом карты - гасятся. Купоны, связанные с другими картами контакта, остаются непогашенными. Параметр "Максимальное количество по выпуску" в записи выпуска купонов «Для продажи в ЛК», увеличивается на количество погашенных купонов данного выпуска. Купоны других выпусков, не для продажи, не добавляются к лимиту выпуска.

При настройке выпуска купонов необходимо предусмотреть, чтобы маски шаблонов были указаны так, чтобы заведомо было возможно увеличение лимита выпуска. Если выпуск невозможен по причине того, что завершились свободные номера по маске, лимит будет увеличен, но выпуск купонов не произойдет. При обратной активации карты – погашенные при блокировке купоны не будут активированы.

Блокировать карту по фроду возможно не только вручную.

Система блокирует карты при превышении лимитов по количеству чеков или географической активности. Для этого предусмотрены следующие настройки:

  • Loyalty.Processing.LimitsCard.ToBlock.DailyNumberPurchases - суточное (по серверному времени) количество фискальных чеков, после достижения которого происходит блокировка карты, по которой количество чеков достигнуто. Отсутствие настройки, а также пустое значение означает отсутствие лимита. Значение по умолчанию – ПУСТО.

С помощью партнерских настроек блокируются карты, если совершено N покупок по разным регионам магазина за последние М минут:

Ежедневным джобом запускается процедура очистки записей таблицы при процессинге чека, если включена партнерская настройка Loyalty.Processing.LimitsCard.ToBlock.NumberRegionOverTime.Purchases. Очищаются записи таблицы старше М минут (по дате процессинга чека). Значение М берется из настройки Loyalty.Processing.LimitsCard.ToBlock.NumberRegionOverTime.MinutesNumber, по умолчанию 30.

При срабатывании каждой из настроек антифрода меняется статус карты на "Заблокирована", а состояние карты на:

Важно исключать из блокировки офлайн-чеки, содержащие расширенный атрибут Offline. Это необходимо, чтобы не блокировать чеки, которые уже фактически обработаны на кассе и передаются в офлайн-режиме.

Ключ расширенного атрибута чека задается настройкой Loyalty.Processing.LimitsCard.ToBlock.Purchases.Exceptions.ChequeEA.  Если настройка равна Offline и у чека есть расширенный атрибут с наименованием Offline, то он будет исключаться из расчета количества чеков для блокировки.

Исключения действуют для лимитов, установленных настройками:

Loyalty.Processing.LimitsCard.ToBlock.DailyNumberPurchases

Loyalty.Processing.LimitsCard.ToBlock.NumberRegionOverTime.Purchases

Не подлежит автоматической блокировке по правилам антифрода, независимо от интенсивности или географического распределения транзакций, карты, идентификатор которых входит хотя бы в один из списков, указанных внешним идентификатором в настройке Loyalty.Processing.LimitsCard.ToBlock.WhiteList 

Т.е., если значение партнерской настройки равно перечню списков карт через ;  без пробелов, которые существует в системе и активны, тогда карты которые входят хотя бы в один из списков, не блокируются при срабатывании настроек антифрода:

Если настройки нет, она не активна, пуста или  содержит внешние идентификаторы не существующих списков карт  или неактивных списков карт, то карта блокируется по фроду по стандартному процессу.

Статус карты Закрыта

В статусе «Закрыта» по карте невозможно совершить операции начисления и списания баллов, а также воспользоваться скидками. При совершении транзакции по такой карте будет возвращена ошибка, что операция запрещена по статусу карты. Однако воспользоваться баллами закрытой карты можно в том случае, если у контакта есть вторая карта в статусе «Активная», или же закрытая карта входит в мастер-счёт наряду с активными картами. В этом случае операция должна совершаться с использованием активной карты. С точки зрения операций данный статус не отличается от статуса «Заблокирована». Но в данный статус нельзя карту перевести вручную, только посредством автоматических процессов с картами. Также только из данного статуса можно перевести карту в статус «Завершена», если не совершается операция замены карты.

1707481605347-832.png

Рис. Карта со статусом «Закрыта»

Смена статуса карты на «Закрыта» через Личный кабинет

Участник ПЛ может самостоятельно перевести карту в статус «Закрыта» в личном кабинете мобильного приложения, не обращаясь в Контакт Центр. Это полезно в случаях, когда, например, по условиям ПЛ существует ограничение на количество пластиковых карт для одного пользователя, и чтобы привязать новую карту, необходимо отвязать/закрыть старую карту.

Закрытие карты через личный кабинет самостоятельно или при помощи чат-бота осуществляется через метод API ODATA POST Card/Close.

Находясь в ЛК в разделе Карты, пользователь выбирает карту, которую хочет закрыть. Для успешного закрытия карта должна быть в активном статусе, в Типе закрываемой карты снят запрет на закрытие через личный кабинет.

1744879999976-545.png

Рис. Признак на Типе карт, который запрещает закрытие карты через личный кабинет

Если поле активировано (значение=1), то запрещено менять статус карты через ЛК, если выключено, то запрет снимается.

Все активные бонусы и бонусы, которые еще не начали действовать, с закрываемой карты переносятся на другую карту пользователя в статусе "Активна". В случае наличия у контакта нескольких активных карт, выбор карты-реципиента для переноса бонусов осуществляется по следующей логике:

  • Выбирается карта с последней датой покупки.
  • При равенстве дат выбирается карта с максимальным числом покупок.
  • При равенстве числа покупок выбирается карта с более поздней датой привязки к контакту.

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

В случае возврата по которому был применен купон, для возобновления действия купона и последующей привязке к активной карте должны быть выполнены следующие условия:

  • Полный возврат чека (всех позиций), при частичном возврате – погашенный купон не активируется
  • Купон привязан к карте, указанной в чеке возврата.
  • Идентификатор чека, при котором был создан купон, соответствует референсу чека в чеке возврата.
  • Дата возврата <  даты окончания действия купона.

В иных случаях, примененный купон при возврате по закрытой карте, не привязывается к активной карте.

Если перенос баллов невозможен, возвращаются ошибки - «Невозможно выполнить операцию для данного типа карты» или «Невозможно перенести баллы на другую карту».

Если перенос прошёл успешно, статус карты меняется на «Закрыта», на форме Карты в поле «Состояние» карте присваивается значение «Закрыта через Личный кабинет».

1744880157316-486.png

Рис. Состояние карты, закрытой через личный кабинет.

Статус карты Завершена

В статусе «Завершена» по карте невозможны никакие операции. В статус завершена карта попадает автоматически из статуса «Закрыта» или ручной операцией замены карты. Впрочем, не всегда карта из статуса «Закрыта» может попасть в статус «Завершена»: если на карте есть активные баллы и системная настройка Loyalty.CardManagement.Processes.ExpirationType не включена, то карта никогда не изменит статус на «Завершена». Если данная системная настройка включена, то после того как карта изменила статус, все активные баллы с неё списываются (для списания в системе необходимо завести правило автосписания баллов). Следует иметь в виду, если карта переходит в статус «Завершена», но по ней есть баллы, которые ещё не начали действовать, то эти баллы никогда уже не будут активированы.

1706013992020-708.png

Рис. Карта со статусом «Завершена»

Статус карты Продана

Статус «Продана» получает карта лояльности при продаже на кассе.  Продаваемая карта изначально имеет статус «Новая». По продаваемой карте проводится чек. Чек содержит позицию "Карта лояльности". По чеку могут быть начислены баллы. Скидки по первому чеку не предоставляются. После проведения чека, карта изменяет статус на «Продана».

1707481761840-406.pngРис. Карта со статусом «Продана»

Если партнерская настройка  Loyalty.Processing.EnableCardStatusSale установлена в одно из значений 1, или y, или Y, то при первой покупке по карте в статусе «Новая» она переходит в статус «Продана». 

Если включена настройка Loyalty.Processing.EnableCardStatusSale, то:

  • При обработке запроса софт чека, статус карты не меняется. Если статус карты «Новая», то он таким и остается.
  • При удачной обработке фискального чека проверяется, что по карте не было других покупок. Если это так, то статус карты меняется на «Продана». Если по карте уже были другие покупки, то ее статус не меняется и остается «Новая».
  • Если по карте в статусе «Новая» приходит запрос мягкого чека с PaidByBonus>0, то возвращать ошибку 81400, процессинг чека не останавливать.
  • Если по карте в статусе «Новая» приходит запрос фискального чека с PaidByBonus>0, то возвращать ошибку 80420.
  • Если после совершения покупки, в результате которой выполнено изменение статуса, выполнен rollback этой покупки, то статус возвращается к прежнему и становится «Новая».
  • Для привязки карты допускаются карты в статусе «Продана». При этом в случае успешной привязки карты, ее статус меняется на «Активная».

Операции со статусами карт

С помощью настроечной таблицы статусов карт (configure.card_status) для запроса BonusRequest  есть возможность устанавливать особые разрешения на операции с различными статусами карт для каждого партнера. Например,  в системе  списание баллов с карт в статусе Новая запрещено, но для для Партнера1 с помощью разработчика на проекте может быть создана особая настройка, в которой можно разрешить списание баллов с карт в этом статусе. В результате для Партнера1 списание баллов с карт в статусе Новая по запросу Pos-сервиса BonusRequest будет разрешено. Для остальных партнеров, без соответствующей настройки, будут применяться общие разрешения: списание баллов с карт в статусе Новая запрещено.