ウォレットとApple Payの最新情報

ウォレットとApple Payの最新情報

ウォレットとApple Payの最新情報をご覧ください。AppやWebサイトでウォレットのオーダーをサポートする方法や、Identity Verification APIを使用して、ユーザーの年齢やIDを安全に検証する方法を紹介します。また、SwiftUIのPassKitサポートを紹介し、自動支払いを使用して、Apple Payエクスペリエンスを向上させる方法についても解説します。

リソース
関連ビデオ

WWDC23
- ウォレットとApple Payの新機能
ダウンロード

♪ 明るい音楽ヒップホップのミュージック♪ ♪ こんにちは私の名前はLaisと申します Davidと申しますウォレットおよびApple Payの今年新しくなった機能について説明します 2014年にApple Payを発表し店舗やオンラインそしてApp内で迅速かつ安全にプライベート決済を行うための新しいベンチマークを打ち立てましたそれ以降 Apple Payは世界中に広がっています Apple Payは現在72カ国と地域で利用可能で毎日100万件以上の取引が行われています本日はウォレットと Apple Payに興味深い新機能と APIを導入したことをお話しします Laisが詳しく説明しますありがとうございます David 本日は主要なアジェンダを見ていきますまず最初に簡単なアップデートの話をします一度の決済で複数の加盟店への支払いに対応する機能を追加しましたまたサブスクリプションなどの自動支払いへの対応も大幅に強化しています注文の追跡によりユーザーの購入後の体験をより充実させることができますそして最後に DavidがウォレットのIDによる本人認証について説明しますまずはいくつかの興味深い最新情報をお伝えします Tap to Pay on iPhoneは今年初めに発表され米国ではiOS 15.4に搭載されました Tap to Pay on iPhoneは安全でプライバシーが守られており簡潔に非接触型決済を行うことができますこれをAppに統合することでシームレスで安全な非接触型決済を簡単に実現できますこれにはApple Pay 非接触型クレジットカードデビットカードなどのデジタルウォレットが含まれます iPhoneにタップするだけで支払いが完了するため追加のハードウェアや決済端末は必要ありません macOS 13では Apple Payのエクスペリエンスを再設計しました昨年デザインを再設計した iOSのペイメントシートは大きな成功を収めましたが今年はmacOSでも同様の体験を提供します SwiftUIを使用してこれを実装することで iOSと同時に macOSにも新機能を搭載することができました本日ご紹介する Apple Payのすべての機能は Macにも対応しています新しいSwiftUI API を紹介します SwiftUIで構築されたAppで Add to Apple Walletや Apple Payのボタンを統合することがさらに簡単になりましたこれらの新しいAPIは書く必要があるコードの量を大幅に削減しますエアラインパスの追加をユーザーに促すボタンを追加する方法について見てみましょうまず最初にパスを作成します正常に読み込めなかった場合処理をする必要がありますこれはパスデータが不正であったり署名が適切でなかった場合などに生じる場合があります次にパスの配列で AddPassToWalletButtonを呼び出しますこの例では要素が 1つだけの配列ですが同じボタンに複数のパスを設定することができます結果はBoolとして送信されユーザーがパスを追加したかどうかに基づき Appに保存・ログするなどのアクションをトリガできますこの例ではそれをstate varに保存しますこれだけです最小値のセット内でボタンのサイズとスタイルをカスタマイズできますデフォルトのサイズは幅250、高さ50ですそれをより幅広く
またはより高くすることもできます
SwiftUIで Add to Apple Walletボタンを追加する方法について説明しました Pay with Apple Payボタンを追加する方法を見ていきましょうまず最初に PKPaymentRequest クラスを使用してペイメントリクエストを作成しそれに通常の設定を行いますそしてauthorizationChange メソッドを作成しますこれら2つが準備できたのでボタンを表示するコードを追加してみます PayWithApplePayButton の呼び出しを追加しラベル paymentRequestオブジェクト authorizationChange メソッドを送信します Apple Payが現在のデバイスに対応していない場合に処理するためにフォールバックビューを送信できます Add Passボタンのようにサイズやスタイルをカスタマイズできますすべてで17種類のラベルが用意されているためユースケースに合わせて支払いボタンをカスタマイズできます iOS・iPadOS・macOS watchOSで利用可能ですここからはマルチ決済について説明します iOS 16では同じ決済取引で異なる加盟店に対して複数のペイメントトークンを要求する機能を導入しますオンラインマーケットプレイス旅行予約チケット販売サービスなどに便利です例を見ていきましょう Allisonが旅行を計画していると想像してください旅行代理店のホームページにアクセスすると航空券ホテルレンタカーなど必要なものがすべて提供されています Allisonは合計500ドルを支払うだけです Allisonは旅行代理店にクレジットカードの全情報を提供します旅行会社がAllisonのクレジットカードに 500ドルを請求し関係各社に支払うと想像するかと思いますしかし一般的には旅行会社が各社にクレジットカード情報を伝え個別決済していますこれも機能しますが Allisonのプライバシーやセキュリティにとってクレジットカード情報を共有されるのはあまり良いことではありませんここで新たにマルチ決済用のAPIが登場し取引に関わる各加盟店のペイメントトークンを要求することが可能になりましたこのペイメントトークンを使って複数の企業がそれぞれ Allisonに承認された該当金額を請求することができます AllisonはApple Payが提供するプライバシーとセキュリティの利点を活用しながら旅行の予約と決済を行うことがが可能になりましたペイメントシートも更新され取引に関与したサブマーチャントの内訳をユーザーに表示しますユーザーは合計欄をタップすると支払サマリーに移動できますここでは決済取引に関わるすべての加盟店の内訳とそれぞれの加盟店に対する承認した金額を確認できます Appにマルチ決済を追加する方法について説明しますまず最初にPKPaymentRequest クラスを使用してペイメントリクエストを作成し通常の設定を行います次に合計金額など決済のためのサマリー項目を追加します次に新しいPKPaymentTokenContext クラスを使用して決済取引に関与するそれぞれの追加のマーチャントのペイメントトークンコンテキストを作成します各マーチャントの詳細とそれぞれについて承認する金額を記入してください最後にペイメントリクエストにペイメントトークンのコンテキストを設定しますすべてのペイメントトークンコンテキストの金額の合計はペイメントリクエスト自体の合計金額以下または同じであることを必ず確認してください Appでその加盟店のペイメントトークンをリクエストする際には常に同じ加盟店の同じ外部識別子を使用する必要があります WebでApple Payによるマルチ決済を導入する場合は Apple Pay JS APIのドキュメントをご確認ください次は自動支払いにおける改善点について見ていきます iOS 16ではウォレット Appから加盟店に設定した自動支払いを表示および管理できる機能を導入しています今回のリリースではサブスクや分割払い継続課金などの定期支払いと店舗カードの残高補充などの自動リロード支払いの 2種類の自動支払いに対応していますペイメントリクエストの際に自動支払いの設定をリクエストできる新しいAPIを導入しますユーザーのApple ID と連結した新しい種類のペイメントトークンである Apple Payマーチャントトークンを導入しより確実に継続的にユーザーに課金できるようにします Apple Payのマーチャントトークンがどのように役立つか詳しく見ていきましょう JulieがiPhoneの Apple Payを使ってブッククラブの会費を支払っているとしますブッククラブがペイメントリクエストをして Julieが支払いを承認するとブッククラブはペイメントトークンを受け取り毎月そのトークンを使い Julieに会費を請求しますこのペイメントトークンは決済を承認するために使用されたJulieのデバイスに接続されています Julieが新しいiPhoneを購入した場合はどうなりますか新しい自動支払い機能では Julieの決済ネットワークが対応している場合代わりにブッククラブが Apple Payのマーチャントトークンを受け取りますこのペイメントトークンは JulieのiPhoneではなく Apple IDと紐付けられており継続的な認証を確実に保証しますつまり JulieがiPhoneを機種変更したり今使っている携帯電話を解約した場合でもブッククラブは Julieに確実に月会費を請求し続けることができますこのようなApple Payでの決済に対応している場合は自動支払いを導入することでユーザーに確実に継続して請求することができサービスに支障をきたさないようにもできます今回のリリースで対応する最初の自動支払いの種類は定期支払いです定期支払いは毎週・毎月・毎年など定期的なスケジュールで課金される固定または変更できる金額設定がありますこれらの決済は指定した日に終了することもキャンセルされるまで継続することも可能ですトライアル期間や導入期間もサポートしますサブスク分割払い定期的課金などの用途に最適な決済方法です自動支払いを使って Appで定期支払いを設定する方法を見ていきましょう PKRecurringPaymentSummaryItem クラスを使用して定期支払いの金額と期間を指定することから説明します定期支払いには通常の請求期間だけでなく導入期間やトライアル期間を指定することができます startDateおよびendDate プロパティを使用してトライアル期間の終了日と通常の課金期間の開始日を示すことができます次に新しいPKRecurringPaymentRequest クラスを使用して定期支払いリクエストを作成します決済の説明定期的な請求期間およびユーザーが定期支払いの方法を更新または削除するウェブページの管理URLを提供しますオプションでトライアル課金期間や課金契約テキストを用意することでユーザーに決済条件を理解してもらいやすくなりますそしてオプションでトークン通知URLを指定し決済用Apple Pay マーチャントトークンが発行された場合サーバーがライフサイクル通知を受け取ることが可能です例えばカード発行会社やユーザーがトークンを削除した場合に通知を受け取ることができますマーチャントトークンのライフサイクル通知に関する詳細は Apple Pay Merchant Token Management APIのドキュメントを参照してください paymentRequest オブジェクトに定期支払いリクエストを設定しますサマリー項目に関する簡単な留意点として定期支払いはペイメントリクエストのサマリー項目に自動的に追加されることはありませんサマリー項目の配列に手動でアイテム項目を追加してくださいペイメントリクエストの合計はユーザーに請求される最初の金額ですこの例では合計がトライアル期間中の金額を表示するように設定されていますペイメントシートにはユーザーへの定期支払いの詳細が表示されユーザーは請求内容セクションをタップして詳細を確認することができます今回のリリースでサポートする 2つ目の種類の自動支払いである自動リロード決済について説明しますこの決済により残高が一定の基準額を下回る際は自動的に一定の金額が上乗せされます自動リロード決済は店舗カードのチャージやプリペイド残高の管理などに最適です自動リロード決済の設定をリクエストするには新しいPKAutomatic ReloadPaymentSummaryItemクラスを使用してリロード額と閾値を指定するところから始めます新しいPKAutomatic ReloadPaymentRequest クラスを使用して自動リロード決済リクエストを作成し定期支払いのように決済の説明請求書および管理URLを提示しますオプションで課金契約文章とトークン通知URLを指定できますそしてペイメントリクエストオブジェクトに自動リロード決済を設定します繰り返しますが自動リロード決済をサマリー項目に含め請求合計金額を適切に設定してくださいウェブ上でApple Payによる自動支払いをする場合は Apple Pay JS APIのドキュメントをご確認くださいここで自動リロード決済がユーザーのペイメントシートにどのように表示されるのかを説明します Appで自動支払いをする際にユーザーに最高の体験を提供するために留意していただきたいことをいくつかご紹介します自動支払いのサマリー項目はシステムにより追加されないため気をつけてください合計請求金額はユーザーが最初に請求される金額です課金規約の文章は短くすることが適切ですペイメントシートには最初の 500文字だけが表示されます課金契約の文章はユーザーの通常の課金契約や法的契約に置き換わるものではありません各地域の定期支払いに関する法律に準拠するかどうかは皆さま次第ですユーザーに提示する法的契約書がある場合それはペイメントシートの前にお客様に提示するべきものです 1回の取引でリクエストできる自動支払いの種類は 1つだけですマルチ決済では自動支払いはご利用いただけません決済用に発行された Apple Payマーチャントトークンのライフサイクル通知を受け取りたい場合必ずトークン通知URLを指定して Apple Pay Merchant Token Management APIをサーバーに導入してくださいこれらの新しいAPIと Apple Payのマーチャントトークンの利点を気に入っていただけると思います自動支払いを採用するパートナー企業の一部をご紹介します Apple Pay マーチャントトークンは American Express・Discover Mastercard・Visaに対応し将来的に他の決済ネットワークにも対応する予定です購入後の体験を充実させるために次に注文の追跡機能を導入しました iOS 16の新機能である注文の追跡は参加加盟店への注文を追跡できますウォレット内でアクティブな注文最近完了した注文過去の注文の概要を直感的に把握できるようになりましたあるベーカリー商品の注文が 1件現在処理中になっています注文がまだ処理中ですが後ほど戻って確認します今はPet Avenueで私の猫のためにおもちゃやアクセサリを購入したいと思います Apple Payで購入することを選択しました決済承認してすぐにウォレットにその注文を追跡するための通知が届きましたその通知から注文に関する詳細現在の状況が確認できます配送や追跡情報を含む注文の情報が確認でき注文したアイテムのリストも確認できます下記にはPet Avenueの連絡先や決済情報の確認 Pet Avenue Appに戻るといった複数の選択肢があります Pet Avenueは注文処理が本当に早くすぐに商品を発送したと想像してください Pet Avenueは発送してすぐに現在確認できる情報を更新しました「発送済み」に状態が変更されたことを確認でき 6月10日に到着予定ということも確認できます配送におけるカスタムメッセージや追跡情報も共有できます私のベーカリー商品のことを覚えていますかちょうど受け取り準備ができたと通知が来ました確認しましょう受け取り設定でベーカリー商品を注文していました受け取り準備ができたようです Bake My Breath Awayは受け取り画面受け取り説明到着した物を受け取るバーコードを提示します Apple Payでシームレスに注文の追跡を確認できました注文の追跡をどのようにユーザーのエクスペリエンスに統合していくのか見ていきましょう注文の追跡について見ていくにはまず最初にディベロッパアカウントの Order Type IDを作成する必要があります Order Type IDはエンティティとして組織を識別し注文情報を提示します複数のOrder Type ID を登録でき例えば複数の加盟店に代わって注文情報を提供します Order Type ID Certificateも作成しますその認証情報を使用して注文パッケージの構築や注文を更新します注文は注文パッケージとして割り当てられます注文パッケージには注文のメタデータや情報すべて含まれます配送受け取りオーダーフルフィルメントなど幅広いシナリオで表示されます注文パッケージにはロゴやラインアイテムなどの画像も含まれます。ローカライゼーションを追加することで多様なユーザーに対応することも可能ですすべての注文パッケージはそのオリジンを確認するために暗号化された署名が必要ですすべてが揃ったところで注文パッケージを展開用に圧縮しますこのセッションに付随する注文パッケージのサンプルを確認してください注文パッケージに関する詳細につきましてはデベロッパードキュメントを確認ください Apple Payでシームレスにウォレットに注文を追加しますユーザーが決済を承認した際に Appまたはホームページで決済情報を受け取りサーバーへ処理するために送られます決済情報が正常に処理されるとサーバーは注文といくつかメタデータを作成しますサーバーはAppやホームページに結果を含めた注文についての詳細を返します注文の詳細によりデバイスでサーバーから注文を非同期リクエストすることができますサーバーはデバイスに注文パッケージを返しますサーバーは注文を作成する際に Order Type IDの名前空間内で固有のOrder ID を割り当てますサーバーに安全性のある認証トークンを生成することも必要ですこれは注文の詳細の一部でもある共有された秘密ですデバイスは注文をリクエストした際にデバイス自体を認証するためトークンを使用します決済認証の結果を返す例を見ていきましょうユーザーが決済を認証した際に Appは決済情報をサーバーへ送り注文を作成するよう要求しますサーバーの結果が成功を示しているかどうかを確認しサーバーから返されたエラーを処理しますサーバーが成功を示した場合適切な認証結果で決済を完了してください注文の詳細で決済の認証結果を返すにはまず初めにサーバーの結果から抽出する必要があります Order Type ID Order ID サーバーへのURL および認証トークンを含む PKPaymentOrderDetails オブジェクトを作成します PKPaymentOrderDetails オブジェクトを PKPaymentAuthorizationResultの新しいorderDetailsプロパティに割り当てますそれだけですウェブ上で注文の詳細による決済を完了することもできます以前と同様にサーバーの結果から注文の詳細を抽出します決済を完了するデータに注文内容を記載してください注文を更新するために自動更新のサポートを示す注文パッケージを作成します注文が追加されるとデバイスは更新するためにそれに登録しますサーバーは登録に関する店舗情報を保管する必要があります後ほどサーバーが注文を更新する際に登録情報を使用して更新するために登録したデバイスを示しますデバイスがプッシュ通知を受け取るとサーバーから注文リクエストを再度行うことができますサーバーは更新した注文パッケージをデバイスに返しますユーザーと皆さまだけがそれらが注文されたことを知る必要があります注文の追跡を非公開で設計しています注文情報は直接デバイスとサーバー間でやり取りされます iCloudを介して注文が同期された場合エンドツーエンドで暗号化されています最高のカスタマーエクスペリエンスを提供するためにこれらのプラクティスを実施してください Appと提供する注文を関連付けます Appが通知を配信しインストールされた場合注文の追跡通知は無効にできますこれにより重複した通知を防ぐことができますユーザーの好みに関する知識を利用して適切なローカライゼーションだけを提供します注文パッケージのサイズには気をつけてください小さいサイズを維持するようにして高いネットワークコストを削減してください注文を更新する際に更新するために登録したデバイスの通知を促しますウォレット内の注文は注文の\実際の状態と一致している必要があります注文の追跡のためにHIGを確認することも忘れないでくださいプラットフォームは注文の追跡の統合をより簡潔に実施できます秋までに Shopify Narvar Routeが注文の追跡に対応することを発表します注文の追跡に対応するプラットフォームが次月に増えますので注目していてください注文の追跡はユーザーにとって購入後の体験を強化する最適な方法です自動更新によりユーザーは注文の状態について常に最新のものを確認できますユーザーはこの体験をきっと喜ぶと思います皆さまが受けた注文で活用されることを楽しみにしていますここからは Davidに代わりますありがとうございます Lais! iOS 16でのウォレットのIDを追加する新しい機能について話していきたいと思います今年初めにiOS 15.4のウォレット内にIDを搭載しました米国の該当する州のユーザーは運転免許証や州IDをウォレットに追加できますウォレット内のIDはユーザーの物理的IDと同じ発行機関によって発行されています米国では各州のDepartment of Motor Vehicles それに相当する組織が該当します iOS 16では Appや App Clipがユーザーの年齢や本人確認を行うためにウォレット内のIDに情報を要求できる新しいAPIが追加されました Appは情報をリクエストしてユーザーはリクエストを確認し承認しますその後Appは復号化および検証のためサーバーにレスポンスを送りますユーザーIDからデータ要素の数をリクエストできますこれらには氏名住所生年月日顔写真発行機関身分証明書の番号と有効期限運転免許証の種類（該当する場合）などが含まれます IDのユースケースとして非常に一般的なのは年齢確認です物理的なIDの場合生年月日を見ます生年月日は年齢を確認するためだけの必要な情報よりも多くの情報を明確にします私の年齢を確認する場合実際に生まれた日や年年齢を正確に知る必要はありません十分な年齢に達しているかどうかだけを知る必要がありますウォレット内のIDで直接その質問に回答することができます Appはユーザーが特定の年齢以上であるかどうかを示すブール値のデータ要素を要求することができ完全な生年月日を確認するよりもプライバシーを保護する方法で年齢認証ができます AppがAPIを呼び出すとどんな情報をリクエストしたかがシートに表示されますその情報を保存する意図があるかどうか保存する期間も表示されますこれによりユーザーは情報を Appと共有するかどうか十分な情報を得た上で判断することができます Face IDやTouch IDを使って相手が明確に承認するまで情報が共有されることはありませんあなたが受け取るレスポンスにはリクエストした要素だけが含まれています物理的なIDカードをスキャンするなどの他の本人認証の仕組みでは IDに記載されている内容をすべて共有することになりますウォレット内のIDにより必要な情報だけを限定して共有することでユーザーにとってよりプライバシーが守られサーバーで安全に保管するべき機密情報の量も減らすことができますこのレスポンスには IDの発行元が署名しているためその情報が本物であることを簡単に確認することができます発行機関はIDを作成しますが APIを呼び出す時点では関与しませんユーザーが自身の情報をいつ誰と共有したかを知ることはできません APIを利用するにはディベロッパアカウントを介してエンタイトルメントをリクエストする必要がありますマーチャントIDや暗号化証明書を設定する必要がありますこのプロセスは Apple PayでApp内決済の設定をする際にとても似ています IDと認証の活用について後ほど話したいと思いますここからは検証フローについて話していきますハイレベルで 4つのステップで構成されていますまず最初にAppはPassKit フレームワークでAPIを起動してリクエストしている情報を特定しますシステムはシートを表示してユーザーにリクエストを承認することを促しますリクエストが承認されると Appは暗号化された応答を受け取ります Appは復号化や検証を行うためにサーバーに応答を送りますまず最初にPassKitにAPIを使用する方法について話します AppがSwiftUIする場合 Appの VerifyIdentityWithWalletButton SwiftUIビューを使用する必要がありますボタンを押すと本人確認フローが起動するボタンが表示されます Pay with Apple Payや Add Pass to Walletボタンを追加するようにウォレットボタンによる個人認証の検証はAPIを使用するすべてのAppで馴染みのある一貫した体験を提供します 4つの異なるラベルから選択してユースケースに適したボタンを表示できます利用可能なスペースに応じて 1行および複数行のバージョンを自動的に切り替えますボタンを作成する際に PKIdentityRequestオブジェクトを指定する必要がありますそれにはリクエストしたい情報とその返送方法が記述されていますその作成方法について見ていきましょう探しているデータ要素を記述した PKIdentityDrivers LicenseDescriptor を作成することから始めます addElements メソッドを使用してリクエストしたい要素とその要素を保存するかどうかを指定します addElementsメソッドを複数回起動することで保管するため意図の異なる要素セットを指定できますこの例では２回呼び出していますまず最初に「最低でも18歳」要素を追加しそれは保存されることはありません再度addElements メソッドを呼び出しユーザー名苗字顔写真を要求しておりこれらはすべて最大30日間保存可能です記述子はその後 PKIdentityRequestに入ります次のステップは使用するマーチャント識別子を特定することですマーチャント識別子は暗号化認証を示しそれによりAPI応答は暗号化されますディベロッパアカウントを介してマーチャント識別子と暗号化認証で構成します APIから受け取るレスポンスに紐づく nonceを指定する必要があります応答の再送を防止し特定のユーザーセッションに結びつけるために使用される重要なセキュリティ機能です nonceをどのように管理するかはご自身のセキュリティ要件に基づき決定してください多くの場合これはサーバーからです後ほどサーバーは nonceが有効であることを強化することに対応しますこれらのプロパティを設定することで PKIdentityRequest がありますこれからはボタンについて振り返ります個人認証が有効の場合 Appにボタンが表示されタップするとリクエストによる個人認証フローが開始されます個人認証が有効でない場合指定したフォールバックビューが代わりに表示されます例えばiPhoneにウォレットのIDがない場合これは発生しますフォールバックビューを使用して個人を認証する他の方法を提供します個人認証が有効だったとしてユーザーはボタンをタップしますシステムはリクエストによりシートを表示しそれにはリクエストした要素やそれらを保管の意図が含まれますユーザーはFace IDまたは Touch IDでリクエストを承認したり承認なしにシートを閉じることができますコードはリクエストの結果を含む結果のオブジェクトを受け取りますリクエストが承認されると成功結果を受け取りますこれは暗号化応答を含む PKIdentityDocument オブジェクトによるものであり Appはサーバーに復号化や認証のために送信しますリクエストが成功しなかった場合失敗の結果を受け取ります失敗の最も共通の原因はリクエストが承認されないことでありキャンセルされたエラーを受ける場合に発生しますそれは VerifyIdentityWithWalletButtonであり APIのSwiftUI バージョンですそれを使用してボタンを表示し個人認証フローを起動しウォレットのIDから情報をリクエストします Appで SwiftUIを使用しない場合 PKIdentityButtonや PKIdentityAuthorization Controllerクラスを使用して同じことを完了することができます今まで情報をリクエストしユーザーはリクエストを承認し Appは暗号化応答をサーバーに送信してきました次にサーバーが応答を復号化および検証するためにすべきことについて話していきますこのトピックでは簡潔に概要を説明するだけなので詳しくはディベロッパドキュメントを確認してください対応形式はいくつかの国際基準を用いるためそれらについて理解することを強く推奨します受け取る応答データは CBORで暗号化されたエンベロープにあります CBORはRFC 8949で定義されたデータ形式です JSONに類似していますがオブジェクトをエンコードするためにバイナリデータを使用します暗号化エンベロープは復号化処理に必要なメタデータを含んでおり暗号化データ自体も同時に含んでいます HPKEを使用してデータは暗号化されそれはRFC 9180で定義された暗号スキームになりますサーバーは秘密鍵を使用してこのデータを復号化します復号化するとmdoc応答オブジェクトを取得します mdoc応答はモバイル運転免許証および州IDのISO規格である ISO 18013 part 5に定義されています mdoc応答オブジェクトはリクエストしたデータ要素を含みます応答が本物であることを確認するためにサーバーが検証するべき多くのセキュリティ機能が含まれていますサーバー自身が復号化を行い検証します Appleサーバーや発行機関のサーバーはどちらも関与しません復号化と応答の検証について話す前にセッショントランスクリプトについて話す必要がありますこれは応答ペイロードと特定のAppの特定のリクエストを結ぶ CBOR構造ですサーバーはこの構造を構築し復号化および検証の際に使用する必要がありますセッショントランスクリプトは先ほどPKIdentityRequestで使用したものと同じ nonceやマーチャントIDを含みますディベロッパチームのチームIDと暗号化証明書の公開鍵の SHA256ハッシュも含みますセッショントランスクリプトを構築する際サーバーは使用した入力がすべて有効であるか確認する必要があります nonceはすでに使用されておらず現在のユーザーと結びついている必要があります他の値はディベロッパアカウントの内容と一致している必要がありますここからは暗号化データの復号化について話します作成したばかりのセッショントランスクリプトが暗号化エンベロープのメタデータと同様に必要になります秘密鍵も必要ですこれは先ほどディベロッパアカウントで設定した証明書に対応する秘密鍵ですユーザー情報の守秘義務を守るために秘密鍵は常に非公開であることを確認してくださいサーバーに保存して守り Appには保存しないでください秘密鍵が漏洩した場合は直ちにディベロッパアカウント証明書を失効させてください暗号化データの復号化後 2つの暗号署名とリクエストされたデータ要素を含む mdoc応答オブジェクトを受け取りますデータ要素を使用する前に mdoc応答でどちらの署名も確認する必要がありますまず初めに発行者の署名を確認しますこれはユーザーIDの発行機関の署名ですこの署名を確認することで応答のデータが本当の発行機関のものであり改ざんされていないことを検証しますその署名が有効であるかを確認するだけでなく信頼できる発行機関の署名であるかも確認する必要がありますウォレットのIDを使用した発行機関の証明書についての詳細はドキュメントを確認してください次にデバイスの署名を検証する必要がありますこの署名はユーザーのiPhoneの Secure Elementの鍵によって作成されましたそれは受け取った応答が発行機関がもともと IDを発行した iPhoneと同じものであることを証明するものですここではセッショントランスクリプトを発行機関の署名による情報と同時に再度使用する必要がありますこれでリクエストしたデータ要素を使用する準備が整いましたこれらの要素を発行機関およびデバイスの署名の検証なしに絶対に使用しないでくださいそうしなければ受け取ったデータが本物かどうかわからないからですこれらのステップは完了しましたこれで完了です Appは情報をリクエストしサーバーは応答を復号化および検証しましたウォレットにIDがない場合どのように実装をテストするのか疑問を持つかと思いますこれについてはいくつかメカニズムがありますまず初めに iOS シミュレータでテストできますそこではAPIが mock応答を返しますこの応答は実際のものと類似していますが実際の署名が不足しています同様にテストプロファイルを使用して iPhoneのウォレットに IDがない場合でさえも iPhoneに実際にmock応答を受け取ることができますこれについての詳細はドキュメントをご確認くださいサーバーはこれらの mock応答を決して本物のように処理してはいけませんので注意してくださいサーバーの実装に役立つようにドキュメントには応答例とそれを復号化および検証するために必要なものがすべて含まれています iOS 16ではウォレットのIDで個人認証ができるようになりました AppでAPIを使用する方法やサーバーで応答を処理する方法や実装をテストする方法について話しました今年はウォレットおよびApple Payにたくさんの新しい機能を導入しましたこれらにはマルチ決済や自動支払いの改善や注文の追跡個人認証が含まれます詳細につきましてはデベロッパドキュメントを確認くださいご視聴ありがとうございました素晴らしいWWDCを! ♪

@State var addedToWallet: Bool

@ViewBuilder private var airlineButton: some View {
    if let pass = createAirlinePass() {
        AddPassToWalletButton([pass]) { added in
            addedToWallet = added
        }
        .frame(width: 250, height: 50)
        .addPassToWalletButtonStyle(.blackOutline)
    } else {
        // Fallback
    }
}

3:40 - PayWithApplePayButton

// Create a payment request
let paymentRequest = PKPaymentRequest()
// ...

// Create a payment authorization change method
func authorizationChange(phase: PayWithApplePayButtonPaymentAuthorizationPhase) { ... }

PayWithApplePayButton(
    .plain,
    request: paymentRequest,
    onPaymentAuthorizationChange: authorizationChange
) {
    // Fallback
}
.frame(width: 250, height: 50)
.payWithApplePayButtonStyle(.automatic)

6:34 - Multi-merchant payments

// Create a payment request
let paymentRequest = PKPaymentRequest()
// ...

// Set total amount
paymentRequest.paymentSummaryItems = [
    PKPaymentSummaryItem(label: "Total", amount: 500)
]

// Create a multi token context for each additional merchant in the payment
let multiTokenContexts = [
    PKPaymentTokenContext(
        merchantIdentifier: "com.example.air-travel",
        externalIdentifier: "com.example.air-travel",
        merchantName: "Air Travel",
        merchantDomain: "air-travel.example.com",
        amount: 150
    ),
    PKPaymentTokenContext(
        merchantIdentifier: "com.example.hotel",
        externalIdentifier: "com.example.hotel",
        merchantName: "Hotel",
        merchantDomain: "hotel.example.com",
        amount: 300
    ),
    PKPaymentTokenContext(
        merchantIdentifier: "com.example.car-rental",
        externalIdentifier: "com.example.car-rental",
        merchantName: "Car Rental",
        merchantDomain: "car-rental.example.com",
        amount: 50
    )
]
paymentRequest.multiTokenContexts = multiTokenContexts

10:14 - Automatic Payments - Recurring payment request

// Specify the amount and billing periods
let regularBilling = PKRecurringPaymentSummaryItem(label: "Membership", amount: 20)

let trialBilling = PKRecurringPaymentSummaryItem(label: "Trial Membership", amount: 10)

let trialEndDate = Calendar.current.date(byAdding: .month, value: 1, to: Date.now)
trialBilling.endDate = trialEndDate
regularBilling.startDate = trialEndDate

// Create a recurring payment request
let recurringPaymentRequest = PKRecurringPaymentRequest(
    paymentDescription: "Book Club Membership",
    regularBilling: regularBilling,
    managementURL: URL(string: "https://www.example.com/managementURL")!
)
recurringPaymentRequest.trialBilling = trialBilling

recurringPaymentRequest.billingAgreement = """
50% off for the first month. You will be charged $20 every month after that until you cancel. \ You may cancel at any time to avoid future charges. To cancel, go to your Account and click \ Cancel Membership.
"""

recurringPaymentRequest.tokenNotificationURL = URL(
    string: "https://www.example.com/tokenNotificationURL"
)!

// Update the payment request
let paymentRequest = PKPaymentRequest()
// ...
paymentRequest.recurringPaymentRequest = recurringPaymentRequest

// Include in the summary items
let total = PKRecurringPaymentSummaryItem(label: "Book Club", amount: 10)
total.endDate = trialEndDate
paymentRequest.paymentSummaryItems = [trialBilling, regularBilling, total]

12:39 - Automatic Payments - Automatic reload payment request

// Specify the reload amount and threshold
let automaticReloadBilling = PKAutomaticReloadPaymentSummaryItem(
    label: "Coffee Shop Reload",
    amount: 25
)
reloadItem.thresholdAmount = 5

// Create an automatic reload payment request
let automaticReloadPaymentRequest = PKAutomaticReloadPaymentRequest(
    paymentDescription: "Coffee Shop",
    automaticReloadBilling: automaticReloadBilling,
    managementURL: URL(string: "https://www.example.com/managementURL")!
)

automaticReloadPaymentRequest.billingAgreement = """
Coffee Shop will add $25.00 to your card immediately, and will automatically reload your \
card with $25.00 whenever the balance falls below $5.00. You may cancel at any time to avoid \ future charges. To cancel, go to your Account and click Cancel Reload.
"""

automaticReloadPaymentRequest.tokenNotificationURL = URL(
    string: "https://www.example.com/tokenNotificationURL"
)!

// Update the payment request
let paymentRequest = PKPaymentRequest()
// ...
paymentRequest.automaticReloadPaymentRequest = automaticReloadPaymentRequest

// Include in the summary items
let total = PKAutomaticReloadPaymentSummaryItem(
    label: "Coffee Shop",
    amount: 25
)
total.thresholdAmount = 5
paymentRequest.paymentSummaryItems = [total]

19:17 - Order Tracking (swift)

func onAuthorizationChange(phase: PayWithApplePayButtonPaymentAuthorizationPhase) {
    switch phase {
    // ...
    case .didAuthorize(let payment, let resultHandler):
        server.createOrder(with: payment) { serverResult in
            guard case .success(let orderDetails) = serverResult else { /* handle error */ }
            let result = PKPaymentAuthorizationResult(status: .success, errors: nil)
            result.orderDetails = PKPaymentOrderDetails(
                orderTypeIdentifier: orderDetails.orderTypeIdentifier,
                orderIdentifier: orderDetails.orderIdentifier,
                webServiceURL: orderDetails.webServiceURL,
                authenticationToken: orderDetails.authenticationToken,
            )
            resultHandler(result)
        }
    }
}

20:13 - Order Tracking (JS)

paymentRequest.show().then((response) => {
    server.createOrder(response).then((orderDetails) => {
        let details = { };
        if (response.methodName === "https://apple.com/apple-pay") {
            details.data = {
                orderDetails: {
                    orderTypeIdentifier: orderDetails.orderTypeIdentifier,
                    orderIdentifier: orderDetails.orderIdentifier,
                    webServiceURL: orderDetails.webServiceURL,
                    authenticationToken: orderDetails.authenticationToken,
                },
            };
        }
        response.complete("success", details);
    });
});

27:05 - VerifyIdentityWithWalletButton 2

@ViewBuilder var verifiyIdentityButton: some View {
    VerifyIdentityWithWalletButton(
        .verifyIdentity,
        request: createRequest(),
    ) { result in
        // ...
    } fallback: {
        // verify identity another way
    }
}

27:18 - Create a PKIdentityRequest

func createRequest() -> PKIdentityRequest {
    let descriptor = PKIdentityDriversLicenseDescriptor()
    descriptor.addElements([.age(atLeast: 18)],
                            intentToStore: .willNotStore)
    descriptor.addElements([.givenName, .familyName, .portrait],
                            intentToStore: .mayStore(days: 30))

    let request = PKIdentityRequest()
    request.descriptor = descriptor
    request.merchantIdentifier = // configured in Developer account
    request.nonce = // bound to user session
}

27:19 - VerifyIdentityWithWalletButton 3

@ViewBuilder var verifiyIdentityButton: some View {
    VerifyIdentityWithWalletButton(
        .verifyIdentity,
        request: createRequest(),
    ) { result in
        // ...
    } fallback: {
        // verify identity another way
    }
}

29:37 - VerifyIdentityWithWalletButton 4

@ViewBuilder var verifiyIdentityButton: some View {
    VerifyIdentityWithWalletButton(
        .verifyIdentity,
        request: createRequest(),
    ) { result in
        switch result {
        case .success(let document):
            // send document to server for decryption and verification
        case .failure(let error):
            switch error {
            case PKIdentityError.cancelled:
                // handle cancellation
            default:
                // handle other errors
            }
        }
    } fallback: {
        // verify identity another way
    }
}

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。

クエリの送信中にエラーが発生しました。インターネット接続を確認して、もう一度お試しください。

リソース

関連ビデオ

WWDC23