Apple Pay 実装手順
お客様が当サービスにおいて Apple Pay® を開発するために必要な準備やテストに関する情報です。
Apple® の提供するサービスを直接利用する部分において、Appleの仕様は予告なく変更される可能性があります。
- Appleの提供するAPI・各種ツールおよび規約に関するドキュメントは、
Appleの公式ドキュメントを必ずご確認ください。 - Apple Pay のロゴ利用、ボタンデザイン、決済時の表示メッセージについては、
Appleの定めるブランドガイドラインに沿って実装してください。
詳細は「Apple Pay on the Web」ドキュメントのデザインガイドを参照してください。
Apple Payを利用するために必要な手続きと開発の一覧
PGマルチペイメントサービスでApple Payを利用するにあたり、システム面で必要な手続きや開発事項は以下の通りです。
Apple Payの組み込みに必要な手続き・開発項目は、iOSアプリ実装とWebブラウザ実装で異なります。
| No | 作業項目 | 作業する場所 | iOSアプリ 実装 | Webブラウザ 実装 |
|---|---|---|---|---|
| 1 | Apple Developer Programへの登録 | Apple Developer | ✓ | ✓ |
| 2 | Merchant ID作成 | Apple Developer | ✓ | ✓ |
| 3 | Apple Pay Certificateの取得 | Apple Developer | ✓ | ✓ |
| 4 | Apple Pay Certificateの設定 | PGマルチペイメントサービス 管理画面 | ✓ | ✓ |
| 5 | ドメイン認証 | Apple Developer | ✓ | |
| 6 | Merchant ID Certificateの取得 | Apple Developer | ✓ | |
| 7 | セッション開始処理の実装 | 加盟店様の開発 | ✓ | |
| 8 | iOSアプリの開発 | 加盟店様の開発 | ✓ | |
| 9 | Apple Payトークン取得処理の実装 | 加盟店様の開発 | ✓ | ✓ |
| 10 | PGマルチペイメントサービスAPI呼び出しの実装 | 加盟店様の開発 | ✓ | ✓ |
Apple Developer Programへの登録
対象：iOSアプリ実装・Webブラウザ実装
Apple Developer Program にサインアップし、有償のメンバーシップに登録してください。
すでに条件を満たす Apple ID をお持ちの場合は、そちらを利用できます。
PGマルチペイメントサービスのために新規のDeveloperプログラム加入は不要です。
Merchant ID作成
対象：iOSアプリ実装・Webブラウザ実装
Apple Developer にて Merchant ID を取得してください。
作成手順の詳細は、Apple Pay Payment Processing Certificate の作成・登録手順を参照してください。
Apple Pay Certificate の取得
対象：iOSアプリ実装・Webブラウザ実装
Apple Payで利用する証明書を取得します。
取得の過程で、秘密鍵／公開鍵ペアの生成 を要求されます。
秘密鍵を紛失しないよう十分ご注意ください。
Apple Payをご利用になる際に、取得した証明書と秘密鍵のペアが必要です。
作成手順の詳細は、Apple Pay Payment Processing Certificate の作成・登録手順を参照してください。
Apple Pay Certificate の設定
対象：iOSアプリ実装・Webブラウザ実装
PGマルチペイメントサービスのショップ管理画面にて、前項で取得した証明書と秘密鍵のペアをアップロードします。
鍵ペアは PKCS12形式 にまとめ、エクスポートパスワード を設定してください。
登録手順の詳細は、Apple Pay Payment Processing Certificate の作成・登録手順を参照してください。
テスト環境でテスト用トークンを利用する場合、管理画面へのキーペアのアップロードは不要です。
ドメイン認証
対象：Webブラウザ実装
加盟店様のドメイン（Apple Payボタンを含む画面が表示されるドメイン）を、Apple Developer でドメイン認証してください。
SafariでApple Payのセッションを開始する際、このドメインが認証済みでないとセッションを開始できません。
Merchant ID Certificate の取得
対象：Webブラウザ実装
Merchant ID Certificate は、Apple Payのセッション開始をAppleに要求する際、加盟店様の身元認証として利用される証明書です。
Apple Pay Certificate（決済データの暗号化に使用）とは別の証明書です。
それぞれ個別に取得が必要です。
セッション開始処理の実装
対象：Webブラウザ実装
Webブラウザ上でセッションを開始するには、加盟店様サーバーからAppleの指定するURLを呼び出す必要があります。
この呼び出し処理を実装してください。
iOSアプリの開発
対象：iOSアプリ実装
加盟店様の提供する iOS アプリケーションに、Apple Pay の実装を行ってください。
Apple Payトークン取得処理の実装
対象：iOSアプリ実装・Webブラウザ実装
実装方法の詳細はApple Payトークン取得 実装サンプルを参照してください。
ユースケースにより、使用するApple Payトークンの種類（DPAN/MPAN）が異なります。
詳細はApple Payトークンを参照してください。
Payment Requestオブジェクトの設定値
iOSアプリまたはWebブラウザで PaymentToken を取得する際、以下の項目を設定してください。
| No | 項目 | 設定値 |
|---|---|---|
| 1 | supportedNetworks | 加盟店様のApple Payカード会社契約に基づき、利用可能なブランドを設定してください。 |
| 2 | merchantCapabilities | Webブラウザの場合：supports3DS、アプリの場合： PKMerchantCapability.Capability3DS を設定してください。 |
| 3 | currencyCode | JPY（日本円）のみ利用可能です。 |
PGマルチペイメントサービスAPI呼び出しの実装
対象：iOSアプリ実装・Webブラウザ実装
PGマルチペイメントサービスの 決済API を実装してください。