Xamarin.iOS에서 Apple Pay 기능Apple Pay Capabilities in Xamarin.iOS

애플리케이션에 기능을 추가하려면 흔히 추가 프로비전 설정이 필요합니다. 이 가이드에서는 Apple Pay 기능에 필요한 설정을 설명합니다.Adding capabilities to an application often requires additional provisioning setup. This guide explains the setup needed for Apple Pay capabilities.

Apple Pay를 사용하면 사용자의 iOS 디바이스를 통해 실제 상품을 구입할 수 있습니다.Apple Pay enables users to pay for physical goods via their iOS device. 이 섹션에서는 Apple Developer Center에서 Apple Pay에 필요한 모든 구성 요소를 생성하는 방법을 설명합니다.This section describes how to create all necessary components required for Apple pay in the Apple Developer Center.

개발자 센터를 통해 새 앱을 프로비전할 때 수행해야 하는 단계는 세 가지입니다.When provisioning a new app through the developer center, there are three steps that need to be taken:

  1. 가맹점 ID를 만듭니다.Create a Merchant ID.
  2. Apply Pay 기능으로 Apply ID를 만들어서 가맹점을 추가합니다.Create an App ID with the Apply Pay capability and add the merchant to it.
  3. 가맹점 ID에 대한 인증서를 생성합니다.Generate a certificate for the Merchant ID.

아래 단계는 위의 항목을 만드는 과정을 안내합니다.The steps below will guide you through creating the above items:

가맹점 ID 만들기Create Merchant ID

가맹점 ID는 지불을 수락할 수 있음을 Apple Pay에 알리는 데 사용되며 PassKit의 PaymentRequest 메서드로 전달되어 Apple Pay 자격에 사용됩니다.A Merchant ID is used to let Apple Pay know that you can accept payments, and is passed to PassKit’s PaymentRequest method and used in the Apple Pay entitlement:

  1. Apple Developer Center로 이동하여 Certificates, Identifier, and Profiles(인증서, 식별자 및 프로필) 섹션으로 이동합니다.Browse to the Apple Developer Center and go to the Certificates, Identifier, and Profiles section:

    개발자 센터에서 가맹점 ID 선택

  2. 식별자 아래에서 가맹점 ID를 선택한 다음, + 를 선택하여 새 가맹점 ID를 만듭니다.Under Identifiers, select Merchant IDs, and then select the + to create a new merchant ID:

  3. 아래 설명된 양식에 새로운 설명과 식별자를 입력합니다.Fill out the form, illustrated below, with a new description and identifier. 설명을 통해 ID를 식별할 수 있고 나중에 변경할 수 있습니다.The description makes the ID identifiable to you and can be changed later. 식별자는 고유해야 하며  merchant 문자열로 시작해야 합니다.The identifier must be unique to you, and it must start with the string merchant. 식별자는 다음과 같은 형식을 사용하는 것이 좋습니다. merchant.com.[Your-App-Name]Apple recommends that the identifier be in the following format: merchant.com.[Your-App-Name]:

    새 가맹점 ID 세부 정보

  4. 세부 정보를 확인하고 ID를  등록 합니다.Confirm the details, and Register your ID: 

    가맹점 ID 확인

가맹점 ID가 포함된 Apple Pay 기능으로 앱 ID 만들기Create an App ID with the Apple Pay capability that includes the Merchant ID

  1. 개발자 센터에서 식별자 아래 앱 ID를 클릭합니다.In the Developer Center click on App IDs under Identifiers:

    개발자 센터에서 앱 ID 선택

  2. + 단추를 선택하여 새 앱 ID를 추가합니다.Select the + button to add a new App ID:

    새 앱 ID 추가 단추

  3. 앱 ID의 이름을 입력하고 Explicit App ID(명시적 앱 ID)를 지정합니다.Enter a Name for the App ID and give it an Explicit App ID:

    앱 ID 세부 정보 화면

  4. App Services 아래에서 Apple Pay를 선택합니다.Under App Services, select Apple Pay:

    App Services Apple Pay

  5. 계속등록을 차례로 선택합니다.Select Continue and then Register. 확인 화면에 Apple Pay가 노란색 기호로 선택된 구성 가능과 함께 표시됩니다.Note that on the confirmation screen Apple Pay will display with Configurable selected, with a yellow symbol:

    Apple Pay에 대한 확인 화면

  6. 앱 ID 목록으로 돌아가서 방금 만든 항목을 선택합니다.Return to the list of App IDs and select the one you have just created:

    앱 ID 편집

  7. 펼쳐진 섹션의 맨 아래로 스크롤하여 편집을 클릭합니다.Scroll down to the bottom of this expanded section and click Edit.

  8. 목록을 Apple Pay까지 아래로 스크롤하여 편집 단추를 클릭합니다.Scroll down the list to Apple Pay and click the Edit button:

    Apple Pay 앱 ID 세부 정보 편집

  9. 이 앱 ID와 함께 사용할 가맹점 ID를 선택하고 계속을 클릭합니다.Select the Merchant ID to use with this App ID, and click Continue:

    앱 ID에 사용할 가맹점 ID 선택

  10. 가맹점 ID 할당을 확인하고 할당을 누릅니다.Confirm the Merchant ID assignments, and press Assign:

    확인 화면

기능 사용 가이드의 설명에 따라, 이 앱 ID를 사용하여 새 프로비전 프로필을 생성하거나 다시 생성할 수 있습니다.This App ID can now be used to generate, or to re-generate, a new provisioning profile, as described in the Working with Capabilities guide.

가맹점 ID에 대한 인증서 만들기Create a Certificate for your Merchant ID

인증서는 Apple에서 트랜잭션과 관련된 중요한 데이터를 암호화하는 데 필요합니다.A certificate is required by Apple to encrypt sensitive data associated with the transaction. 각각의 가맹점 ID에는 고유의 인증서가 있어야 합니다.Each Merchant ID created must have its own certificate.

인증서를 만들려면 다음 단계를 수행합니다.To create a certificate, follow the steps below:

  1. 위에서 만든 가맹점 ID를 선택하고 편집을 누릅니다.Select the Merchant ID that was created above and press Edit:

    가맹점 ID 편집 대화 상자

  2. iOS 가맹점 ID 설정 화면에서 인증서 만들기를 클릭합니다.On the iOS Merchant ID Settings screen, click Create Certificate:

    결제 처리 인증서 만들기

  3. 다음 질문에 답변합니다.Answer the following question:

    결제가 중국에서 단독으로 처리되는 경우 알리기

  4. 이 지점에서 _인증서 서명 요청_을 생성하라는 메시지가 표시됩니다.At this point you will be prompted to create a certificate signing request:

    인증서 서명 요청 만들기

    중요

    JudoPay 또는 Stripe와 같은 Apple Pay에 제공되는 결제 서비스 업체를 사용하는 경우, 해당 업체가 이 시점에서 사용할 수 있는 올바른 형식의 CSR을 제공할 수 있습니다.If you are using a payment provider for Apple Pay, such a JudoPay or Stripe, they can provide you with a properly formatted CSR that you can use at this point. 요청에 대한 자세한 내용은 JudoPayStripe 사이트를 참조하세요.Information on requesting this is found on the JudoPay and Stripe sites. 자체 CSR을 만들려면 아래 5-8단계를 수행합니다.To create your own CSR, follow the steps 5-8 below. CSR이 있으면 9단계로 이동합니다.Once you have a CSR go to step 9.

  5. Keychain Access(키 집합 액세스) 애플리케이션을 열고 Keychain Access(키 집합 액세스) > Certificate Assistant(인증서 도우미) > Request a Certificate from a Certificate Authority(인증 기관의 인증서 요청) 으로 이동합니다.Open the Keychain Access application, and browse to Keychain Access > Certificate Assistant > Request a Certificate from a Certificate Authority:

    Mac에서 키 집합을 사용하여 CSR 만들기

  6. 이메일 주소를 입력하고, 개인 키의 이름을 입력하고, CA Email Address(CA 이메일 주소)를 비워두고, 디스크에 저장 옵션과 Let me specify key pair information(키 쌍 정보 직접 지정)을 차례로 선택합니다.Enter your email address, enter a name for the private key, leave CA Email Address empty, select the Save to Disk option, and select Let me specify key pair information:

    인증서 정보 대화 상자

  7. CSR을 편리한 위치에 저장합니다.Save the CSR to a convenient location:

    CSR을 로컬 컴퓨터에 저장

  8. Key Pair information(키 쌍 정보) 화면에서 키 크기256비트로 설정하고 알고리즘ECC로 설정한 다음, 계속을 클릭합니다.In the Key Pair information screen, set Key Size to 256 bits and Algorithm to ECC and click Continue:

    키 쌍 정보 입력 대화 상자

  9. 개발자 센터에서 계속을 클릭하여 CSR을 업로드합니다.On the Developer Center, click Continue to upload the CSR:

    개발자 센터에 CSR 업로드 준비

  10. 파일 선택... 클릭하여Click Choose File… CSR을 선택하고 계속을 눌러서 개발자 포털에 업로드합니다.to select the CSR and press Continue to upload it to the developer portal:

    개발자 센터에 CSR 업로드

  11. 인증서가 생성되면 다운로드하고 두 번 클릭하여 키 집합에 설치합니다.Once the certificate has been generated, download it and double click on it to install it to your keychain.

Apple Pay 사용에 대한 자세한 내용은 다음 가이드를 참조하세요.For more information on using Apple Pay, refer to the following guide:

다음 단계Next Steps

아래 목록에는 필요할 수도 있는 추가 단계가 설명되어 있습니다.The list below describes additional steps that may need to be taken:

  • 앱에서 프레임워크 네임스페이스를 사용합니다.Use the framework namespace in your app.
  • 앱에 필요한 자격을 추가합니다.Add the required entitlements to your App. 필요한 자격 및 추가 방법에 대한 자세한 내용은 자격 사용 가이드를 참조하세요.Information on the entitlements required and how to add them is detailed in the Working with Entitlements guide.
  • 앱의  iOS 번들 서명에서  사용자 지정 자격Entitlements.plist로 설정되어 있는지 확인합니다.In the App's iOS Bundle Signing, ensure that the Custom Entitlements is set to Entitlements.plist. 이 설정은 디버그 및 iOS 시뮬레이터 빌드에 대한 기본 설정이  아닙니다 . This is not the default setting for Debug and iOS Simulator builds.

앱 서비스에 문제가 발생하면 주 가이드의 문제 해결 섹션을 참조하세요.If you encounter issues with app services, refer to the Troubleshooting section of the main guide.