> ## 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.

# Обзор Apple Pay

> Этот документ объясняет, что такое Apple Pay, какие пользовательские и региональные ограничения существуют, как работают In-app provisioning и его сертификация, а также как Apple Pay интегрирован и сертифицирован в Holders.

# Что такое Apple Pay

[Apple Pay](https://www.apple.com/apple-pay/) — это мобильный платежный сервис и цифровой кошелек [Apple Wallet](https://apps.apple.com/us/app/apple-wallet/id1160481993), разработанный [Apple Inc](https://www.apple.com/). Этот сервис позволяет выполнять бесконтактные платежи через устройства Apple, включая iPhone, iPad, Apple Watch и Mac.

# Возможные ограничения для пользователя

1. **Совместимые устройства**: [Apple Pay](https://www.apple.com/apple-pay/) доступен только на устройствах [Apple](https://www.apple.com/), таких как [iPhone](https://www.apple.com/iphone/), [iPad](https://www.apple.com/ipad/), [Apple Watch](https://www.apple.com/watch/) и [Mac](https://www.apple.com/mac/), которые поддерживают эту функцию.
2. **Поддерживаемые банки и карты**: не все финансовые организации и платежные карты совместимы с [Apple Pay](https://www.apple.com/apple-pay/). При заключении договора с банком-эмитентом бизнес-команда проверяет наличие поддержки этой технологии у конкретного банка.
3. **Региональные ограничения**: доступность [Apple Pay](https://www.apple.com/apple-pay/) зависит от географического региона. [Список поддерживаемых регионов](https://support.apple.com/ru-ru/102775).
4. **Лимиты транзакций**: банки-эмитенты могут устанавливать ограничения на максимальную сумму транзакций, проводимых через [Apple Pay](https://www.apple.com/apple-pay/).
5. **Кешбэк и программы лояльности**: отдельные эмитенты могут не предоставлять кешбэк или бонусы при оплате через [Apple Pay](https://www.apple.com/apple-pay/).
6. **Количество карт**: максимальное число карт, доступных пользователю в [Apple Wallet](https://apps.apple.com/us/app/apple-wallet/id1160481993), равно 12, но это значение может меняться, например, при привязке нескольких аккаунтов в приложении.

# In-app provisioning

Holders реализует продвинутую интеграцию с [Apple Pay](https://www.apple.com/apple-pay/) через технологию [In-app provisioning](https://developer.apple.com/documentation/passkit/apple_pay/setting_up_apple_pay). Эта технология позволяет добавлять платежную карту в [Apple Wallet](https://apps.apple.com/us/app/apple-wallet/id1160481993) напрямую из приложения на платформе [iOS](https://www.apple.com/ios/), что значительно упрощает процедуру подключения карты для пользователя и устраняет необходимость переходить в настройки [Apple Wallet](https://apps.apple.com/us/app/apple-wallet/id1160481993).\
Чтобы использовать технологию [In-app provisioning](https://developer.apple.com/documentation/passkit/apple_pay/setting_up_apple_pay), организация должна пройти обязательную сертификацию [Apple](https://www.apple.com/). [Apple](https://www.apple.com/) делегирует право сертификации аккредитованным организациям, таким как [Fime](https://www.fime.com/).\
Наличие [In-app provisioning](https://developer.apple.com/documentation/passkit/apple_pay/setting_up_apple_pay) не отменяет возможности ручного добавления карты в [Apple Wallet](https://apps.apple.com/us/app/apple-wallet/id1160481993) через интерфейс самого кошелька.

# Сертификация In-app provisioning

Чтобы реализовать функциональность [In-app provisioning](https://developer.apple.com/documentation/passkit/apple_pay/setting_up_apple_pay), компания должна выстроить партнерские отношения с каждым банком-эмитентом, карты которого планируется интегрировать в систему. Каждое финансовое учреждение проходит отдельную техническую проверку и сертификацию, чтобы подтвердить полную совместимость банковских систем с технологией [In-app provisioning](https://developer.apple.com/documentation/passkit/apple_pay/setting_up_apple_pay) и экосистемой [Apple Pay](https://www.apple.com/apple-pay/).\
**Процесс сертификации включает следующие этапы:**

1. Подача заявки на сертификацию.
2. Подписание соглашения о неразглашении, `NDA`, с сертифицирующей организацией.
3. Подписание договора и оплата услуг сертификации.
4. Согласование сроков сертификации. Процедуру тестирования проводит специалист аккредитованной компании в течение 5 рабочих дней.
5. Предоставление маркетинговых материалов в сертифицирующую организацию:
   1. [Apple Pay page on the application website](https://tonhub.com/apple-pay)
   2. [Application Video](https://developer.apple.com/documentation/passkit/apple_pay/setting_up_apple_pay) - демонстрационное видео процесса provisioning
   3. [Marketing Creatives](https://developer.apple.com/app-store/marketing/guidelines/) - материалы для соцсетей о внедрении [In-app provisioning](https://developer.apple.com/documentation/passkit/apple_pay/setting_up_apple_pay), при отсутствии масштабного запуска достаточно [Splash screen](https://developer.apple.com/design/human-interface-guidelines/launch-screen)

Тестирование проводится на устройствах iPhone, iPad и Apple Watch.\
После завершения тестирования:

1. Представитель аккредитованной организации готовит отчет для Apple, включая integration checklist и testing checklist.
2. Apple рассматривает результаты сертификации в течение 2 недель после подачи и назначает дату запуска, к которой функция должна быть удалена из whitelists и полностью готова к работе.

# Сертификация Holders

**Company that underwent certification:** [Walleexer s.r.o.](https://walleexer.com/)\
**Application that underwent certification:** [Tonhub](https://gettonhub.com/)\
**Partner bank:** [Wallester](https://wallester.com/)\
**Certificate date:** 20.08.2024\
**Certification partner:** [Fime](https://www.fime.com/)\
**Cost:** \$20,000 (certification cost) + \$5,000 (tokenization setup Wallester) = \$25,000.\
Настройка tokenization в Wallester включает конфигурацию платежной карты для интеграции со следующими цифровыми платежными системами. В каждой из них карта будет отображаться с корректными параметрами и настройками:

* [Apple Pay](https://www.apple.com/apple-pay/)
* [Google Pay](https://pay.google.com/)
* [Garmin Pay](https://www.garmin.com/en-US/p/pay)
* [Samsung Pay](https://www.samsung.com/us/samsung-pay/)
* [Fitbit Pay](https://www.fitbit.com/global/us/technology/fitbit-pay)
* [Fidesmo Pay](https://fidesmo.com/consumer/fidesmo-pay/)

# Верификация карты пользователем

После добавления карты в Apple Wallet Apple запускает процедуру верификации, чтобы подтвердить права пользователя на эту платежную карту. В некоторых случаях проверка выполняется автоматически, однако стандартный сценарий включает верификацию через код подтверждения, который отправляется по SMS на номер телефона, указанный пользователем при регистрации профиля в системе Holders.

<Info>
  **Important feature:** Apple Pay does not transmit the actual credit or debit card number when making transactions. Instead, the system generates a unique digital token that replaces the user's real card data. Each transaction is accompanied by the creation of an individual dynamic security code, which prevents the possibility of token reuse in case of compromise. This architecture ensures that payment documents display an alternative card number instead of the original one.
</Info>

## Статусы верификации карты в Apple

**Green** - карта проходит верификацию сразу, без дополнительных действий.\
**Yellow status** — чтобы завершить верификацию, пользователю нужно ввести одноразовый код подтверждения, OTP.\
**Orange status** — карта может быть верифицирована только вручную через партнерский банк.\
**Red** - карта не может быть верифицирована.

## Обработка карты в Orange Flow

Если карта в системе [Apple](https://www.apple.com/) получает orange status, пользователю будет предложено пройти верификацию, позвонив по номеру поддержки приложения Tonhub, сам звонок может быть платным.

<Info>
  Tonhub phone number (Switzerland) +41587880033.
</Info>

Сейчас по указанному номеру отвечает автоматизированная система, которая перенаправляет пользователя в онлайн-поддержку приложения. После обращения в Tonhub support через платформу Intercom оператор получает возможность провести верификацию карты в административной панели Wallester по установленной инструкции.

## Ответственность за передачу карты

В разделе 5.3.11 [Wallester Payment Service Agreement](https://wallester.com/private-account-card-agreement) указано следующее:

> "The Card must only be used by the Client. The Client must not authorise third parties to use the card, i.e., to make the Card or only the Card Data available to the third parties. The card must not be given to third parties as a gift, sold to third parties or otherwise transferred to third parties."

Это означает, что картой должен пользоваться только сам клиент, и он не имеет права разрешать третьим лицам использовать карту, передавать ее, дарить или продавать.\
Соответственно, любые действия, связанные с передачей карты другим лицам или предоставлением им права ею пользоваться, рассматриваются как нарушение условий соглашения с Wallester. Такие нарушения могут привести к санкциям в виде блокировки карты. В отдельных случаях, в зависимости от характера использования card data и намерений участников, подобные действия могут квалифицироваться как мошенничество, а это уже может повлечь уголовную ответственность в виде штрафов или лишения свободы.

# Внешний вид карты

Пользователи не могут самостоятельно менять дизайн карты в Apple Wallet. Дизайн карты в Apple Wallet задается банком или финансовой организацией, выпустившей карту. Каждый дизайн согласовывается эмитентом с платежной системой и добавляется в настройки карты после утверждения. Аналогичная ситуация и с названием банка, которое отображается на карте в Apple Wallet. Holders может менять или добавлять дизайны, но каждое изменение потребует согласования с VISA и дополнительных расходов.\
**Cost of adding a design:** 400 EUR\
**Cost of a minor change:** 100 EUR\
Незначительным изменением считается, например, смена номера телефона или логотипа на карте.\
Добавление дизайна в Apple Wallet происходит автоматически и не требует дополнительных согласований или оплаты.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.