> ## Documentation Index
> Fetch the complete documentation index at: https://whalescorp.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Операции с картами
> Этот документ кратко объясняет все основные операции с картами в Holders и то, как они влияют на карту.
# Типы карточных операций
## Поддерживаемые операции
1. **Открытие карты** — выпуск новой банковской карты и ее привязка к аккаунту клиента с назначением реквизитов и начального статуса, обычно `ACTIVE`.
2. **Блокировка карты** — жесткая остановка всех операций по карте без возможности разблокировки, обычно в случаях мошенничества, утраты данных или решения банка либо сервиса.
3. **Закрытие карты** — окончательное прекращение действия карты: по ней больше нельзя выполнять операции, она скрывается из интерфейса и не может быть восстановлена.
4. **Заморозка карты** — временная приостановка операций по карте, инициируемая клиентом или сервисом, с возможностью последующего "размораживания" и возврата карты в активный статус.
5. **Refund** — операция, при которой продавец или сервис возвращает ранее списанные с карты средства, полностью или частично, на тот же аккаунт.
6. **Перенос карты между аккаунтами** — отвязка карты от одного аккаунта и привязка к другому аккаунту того же пользователя с сохранением карточных реквизитов.
7. **Добавление карты в систему бесконтактной оплаты** — привязка карты к цифровому кошельку, например Apple Pay или Google Pay, с выпуском токена, что позволяет оплачивать покупки с устройства без прямого использования реквизитов карты.
## Неподдерживаемые операции
1. **Снятие наличных** — получение клиентом наличных в банкомате или у кассира с использованием средств аккаунта, к которому привязана карта. На текущий момент, по состоянию на 04.02.2026, в продукте не поддерживается.
2. **Перевыпуск карты** — выпуск новой банковской карты взамен существующей, например по истечении срока действия, при компрометации реквизитов или изменении персональных данных, с сохранением связи с клиентом и аккаунтом. По состоянию на 04.02.2026 эта функция не поддерживается. В качестве альтернативы пользователю предлагается открыть новую карту.
3. **Смена PIN-кода** — функция смены PIN доступна только для физических карт. Сейчас физические карты не поддерживаются, однако API Wallester предусматривает возможность смены PIN в будущем.
4. **Смена пароля 3D Secure** — в приложении Holders пользователь может просматривать и копировать пароль 3D Secure, который может понадобиться при онлайн-оплате. Функция изменения этого пароля сейчас не реализована.
# Открытие карты
Выпуск новой карты доступен в двух вариантах:
* выпуск одновременно с открытием нового аккаунта. Первая карта пользователя в сервисе выпускается бесплатно;
* выпуск для уже созданного аккаунта. Вторая и последующие карты выпускаются платно, стоимость составляет 7.92 EUR. Комиссия списывается с баланса клиента в момент подтверждения выпуска новой карты. Если на балансе недостаточно средств, выпуск откладывается до пополнения аккаунта на нужную сумму и выполняется после резервирования необходимых средств.
## Условия открытия новой карты
* соответствующие продукты доступны для резидентства клиента на момент создания карты;
* на балансе клиента достаточно средств для оплаты выпуска карты, кроме первой карты;
* профиль клиента успешно прошел процедуру KYC-верификации;
* не исчерпан лимит на выпуск карт для пользователя, до 50 карт, или для эмитента.
## Схема открытия карты
## Открытие карты в интерфейсе
1. В интерфейсе аккаунта нужно нажать на иконку `+` на серой карточке в блоке Cards.
2. В открывшемся меню выбрать нужный тип карточного продукта.
3. Ознакомиться с пользовательским соглашением и подписать его.
4. После создания карты в системе появится предложение добавить ее в систему бесконтактной оплаты.
5. Все данные выпущенной карты будут доступны на странице карты.
# Блокировка карты
Блокировка карты применяется в случаях, когда пользователь или банк-эмитент подозревают мошенничество или компрометацию реквизитов карты пользователя. Карта также может быть заблокирована банком-эмитентом при оплатах у запрещенных мерчантов, обычно после повторных нарушений.\
В отличие от заморозки, блокировка является необратимой операцией. Заблокированная карта остается видимой в интерфейсе приложения, однако все авторизации и списания по ней прекращаются, карта не может использоваться ни для онлайн-, ни для офлайн-платежей и не может быть добавлена в сервисы бесконтактной оплаты.
## Зачем использовать блокировку, если можно просто закрыть карту?
Блокировка используется как промежуточная мера для немедленной остановки операций в ситуациях, когда закрытие карты пока преждевременно или нецелесообразно. Основные сценарии:
* **Проведение расследований.**
Когда есть подозрение на мошеннические операции, спорные транзакции или проводятся проверки в рамках AML и санкционного compliance, важно сразу остановить операции до завершения расследования.
* **Технические и операционные требования.**
Закрытие карты в системе является необратимым действием и может повлиять на отчетность, архивирование данных и работу интеграций. Блокировка обеспечивает:
* немедленное отключение платежной функциональности;
* сохранение карты как объекта для хранения логов операций, проведения расследований и построения отчетности.
После применения блокировки карта остается в пользовательском интерфейсе, сохраняя доступ к истории транзакций и данным карты.
## Интерфейс
1. Чтобы заблокировать карту, пользователю нужно перейти на страницу карты и нажать кнопку Block.
2. Пользователь выбирает причину блокировки и подтверждает операцию.
# Закрытие карты
Любая карта, привязанная к аккаунту пользователя, может быть закрыта. Операция закрытия необратима и приводит к удалению карты из пользовательского интерфейса — доступ к ее данным для дальнейшего использования прекращается. Закрытию подлежат только карты со статусом blocked.
## Интерфейс
1. Пользователь нажимает кнопку Close card на странице заблокированной карты и подтверждает закрытие.
# Заморозка карты
Заморозка позволяет временно приостановить все списания и авторизации по выбранной карте. В отличие от блокировки, заморозка может быть в любой момент отменена клиентом. Заморозка может быть инициирована как самим клиентом, так и компанией Holders в случае вопросов или проблем, например при истечении срока действия пользовательских документов. Заморозка выполняется на странице карты аналогично процессу блокировки.
# Refund
Refund по карте — это операция, при которой продавец или сервис возвращает ранее списанные с карты средства, полностью или частично, на тот же аккаунт. Возврат не зависит от карты, которой была совершена операция; средства возвращаются на аккаунт клиента вне зависимости от статуса карты, будь то закрыта, перенесена или заблокирована.
# Перенос карты
Перенос карты между аккаунтами — это операция, при которой существующая карта отвязывается от одного пользовательского аккаунта и привязывается к другому аккаунту того же пользователя при сохранении тех же реквизитов карты.\
В рамках этой операции важно учитывать:
* все ранее завершенные транзакции и refund остаются в истории старого аккаунта;
* все новые авторизации и списания после переноса отражаются уже на новом аккаунте;
* refund по старым операциям должен зачисляться на тот аккаунт, который технически считается settlement-аккаунтом для этой карты на момент фактического clearing. Это поведение должно быть явно описано в business logic.
## Интерфейс
1. В интерфейсе целевого аккаунта, то есть того, на который нужно перенести карту, пользователь нажимает кнопку `+`, затем выбирает "Link a card from another account".
2. В открывшемся меню пользователь выбирает карту, которую хочет перенести.
# Добавление карты в системы бесконтактной оплаты
Карты можно добавлять в разные системы бесконтактной оплаты, например:
* [Apple Pay](https://www.apple.com/apple-pay/) — добавление [доступно прямо из кошелька](/ru/apple-pay-ui), в котором установлен Holders, либо вручную в приложении Apple Wallet.
* [Google Pay](https://pay.google.com/) — добавление [доступно прямо из кошелька](/ru/google-pay-ui), в котором установлен Holders, либо вручную в приложении Google Wallet.
* [Garmin Pay](https://www.garmin.com/en-US/p/pay) — добавление доступно вручную в приложении Garmin.
* [Samsung Pay](https://www.samsung.com/us/samsung-pay/) — добавление доступно вручную в приложении Samsung Pay.
* [Fitbit Pay](https://www.fitbit.com/global/us/technology/fitbit-pay) — добавление доступно вручную в приложении Fitbit.
* [Fidesmo Pay](https://fidesmo.com/consumer/fidesmo-pay/) — добавление доступно вручную в приложении Fidesmo.
***
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.