Возможности Apple Pay в Xamarin.iOS

Добавление возможностей в приложения часто требует дополнительной подготовки. Это руководство описывает процесс настройки, необходимый для добавления поддержки возможностей Apple Pay.

Технология Apple Pay позволяет пользователям оплачивать физические товары при помощи своего устройства iOS. Этот раздел описывает процесс создания всех компонентов, необходимых для Apple Pay в центре разработчика Apple.

При подготовке нового приложения в центре разработчика необходимо выполнить три операции:

  1. Создать ИД продавца.
  2. Создать ИД приложения с возможностями Apply Pay и добавить в него ИД продавца.
  3. Создать сертификат для ИД продавца.

Ниже описывается процедура выполнения этих операций:

Создание ИД продавца

ИД продавца используется для указания Apple Pay, что вы можете принимать платежи, ИД передается в метод PassKit PaymentRequest и используется в назначении Apple Pay:

  1. Откройте Центр разработчика Apple и перейдите к разделу "Сертификаты, Идентификаторы и Профили":

    Developer Center Merchant ID selection

  2. В разделе Идентификаторы выберите элемент ИД продавцов и затем выберите + для добавления ИД продавца:

  3. Заполните форму, изображенную ниже, с новым описанием и идентификатором. Описание делает идентификатор более понятным и может быть изменено позднее. Идентификатор должен быть уникальным для вас и начинаться со строки merchant. Корпорация Apple рекомендует использовать идентификатор в следующем формате: merchant.com.[Your-App-Name]:

    New Merchant ID details

  4. Подтвердите сведения и зарегистрируйте идентификатор:

    Merchant ID confirmation

Создание ИД приложения с возможностями Apple Pay, включающее ИД продавца

  1. В Центре разработчика нажмите ИД приложений в разделе Идентификаторы:

    Select App ID in Developer Center

  2. Нажмите кнопку + для добавления ИД приложения:

    Add new App ID button

  3. Введите имя для ИД приложения и понятный идентификатор приложения:

    App ID details screen

  4. В "Службах приложений" выберите Apple Pay:

    App Services Apple Pay

  5. Нажмите кнопку Continue (Продолжить), а затем кнопку Register (Зарегистрировать). Обратите внимание, что в окне подтверждения параметр Apple Pay будет отмечен как "Настраиваемый" при помощи желтого символа:

    Confirmation Screen for Apple Pay

  6. Вернитесь к списку ИД приложений и выберите только что созданный идентификатор:

    Edit App ID

  7. Прокрутите вниз до конца этого расширенного раздела и нажмите Изменить.

  8. Прокрутите список вниз до Apple Pay и нажмите кнопку Изменить:

    Edit Apple Pay App ID details

  9. Выберите ИД продавца для использования с этим ИД приложения и нажмите Продолжить:

    Select Merchant ID to use for App ID

  10. Проверьте правильность выбора ИД продавца и нажмите Назначить:

    Confirmation Screen

Этот ИД приложения теперь можно использовать для создания или повторного создания профиля подготовки, как описано в руководстве Работа с возможностями.

Создание сертификата для ИД продавца

Сертификат требуется компании Apple для шифрования конфиденциальной информации, связанной с платежом. Каждый ИД продавца должен иметь свой собственный сертификат.

Для создания сертификата выполните следующее:

  1. Выберите ИД продавца, созданный ранее, и нажмите Изменить:

    Edit Merchant ID dialog

  2. В окне "Настройка ИД продавца iOS" нажмите Создать сертификат:

    Create payment processing certificate

  3. Ответьте на следующий вопрос:

    address if payments will be processed exclusively in China

  4. На этом этапе появится подтверждение на создание запроса подписи сертификата:

    Creating a certificate signing request

    Внимание

    Если вы пользуетесь услугами поставщика платежных услуг для Apple Pay, такими как JudoPay или Stripe, они могут предоставить вам правильно сформированный CSR-файл, который можно использовать на этом шаге. Сведения о запросе этого файла можно найти на веб-сайте Stripe. Для создания своего собственного CSR-файла выполните шаги 5–8 ниже. Если у вас уже есть CSR-файл, перейдите к шагу 9.

  5. Откройте приложение keychain Access и перейдите к помощнику > по сертификату keychain Access > Запросить сертификат из центра сертификации:

    Create a CSR using keychain on a Mac

  6. Введите ваш адрес электронной почты и имя закрытого ключа, поле "Адрес эл. почты ЦС" оставьте пустым, выберите параметр Сохранить на диск и установите флажок Позвольте мне указать сведения о паре ключей:

    Certificate information dialog

  7. Сохраните CSR-файл в удобное расположение:

    Saving CSR to local machine

  8. В окне "Сведения о паре ключей" установите Размер ключа в 256 бит, а Алгоритм — в ECC и нажмите Продолжить:

    Enter key pair information dialog

  9. Откройте Центр разработчика и нажмите Продолжить для отправки CSR-файла:

    Prepare to upload CSR to developer center

  10. Нажмите кнопку " Выбрать файл..." , чтобы выбрать CSR и нажмите кнопку "Продолжить ", чтобы отправить ее на портал разработчика:

    Upload CSR to developer center

  11. После создания сертификата загрузите его и дважды щелкните на нем для установки в вашу связку ключей.

Дополнительные сведения по использованию Apple Pay см. в следующем руководстве:

Next Steps

Ниже перечислены дополнительные действия, которые необходимо выполнить:

  • Используйте в приложении пространство имен платформы.
  • Добавьте необходимые назначения к вашему приложению. Подробные сведения о необходимых назначениях и об их добавлении см. в руководстве Работа с назначениями.
  • Убедитесь, что в Подписывании пакета iOS приложения параметр Настраиваемые назначения установлен в Entitlements.plist. Эта настройка не устанавливается по умолчанию для сборок отладки и симулятора iOS.

Если вы столкнулись с проблемами при работе со службами приложений, обратитесь к разделу Устранение неполадок основного руководства.