Payment Links を使用して iOS でデジタル商品の支払いを受け付ける

ユニバーサルリンクを使用すると、決済成功後に、決済用リンクをお使いのアプリにディープリンクできます。ユニバーサルリンクを設定するには、次の手順を行います。

1. ドメインに apple-app-site-association ファイルを追加します。
2. アプリに Associated Domains エンタイトルメントを追加します。
3. Checkout リダイレクト URL のフォールバックページを追加します。

関連ドメインを定義する

.well-known/apple-app-site-association でドメインにファイルを追加し、アプリで処理する URL を定義します。アプリ ID の前にチーム ID を付加します。チーム IDは、Apple Developer Portal のメンバーシップページにあります。

{
  "applinks": {

      "apps": [],
      "details": [
           {
             "appIDs": [ "A28BC3DEF9.com.example.MyApp1",
                         "A28BC3DEF9.com.example.MyApp1-Debug" ],
             "components": [
               {
                  "/": "/checkout_redirect*",
                  "comment": "Matches any URL whose path starts with /checkout_redirect"
               }
             ]
           }
       ]
   }
}

curl -I https://example.com/.well-known/apple-app-site-association

詳細については、関連ドメインのサポートに関する Apple のページを参照してください。

アプリに Associated Domains エンタイトルメントを追加する

1. アプリのターゲットの、Signing & Capabilities (署名とケイパビリティ) ウィンドウを開きます。
2. + ケイパビリティ をクリックし、関連ドメイン を選択します。
3. applinks:example.com のエントリーを Associated Domains リストに追加します。

ユニバーサルリンクの詳細については、Apple のユニバーサルリンクのドキュメントを参照してください。

iOS は、apple-app-site-association ファイルで定義された URL へのリンクをインターセプトしますが、リダイレクトでアプリを開くことができないケースが発生することがあります。

Payment Links は、カード支払いと Apple Pay にデフォルトで対応しています。ダッシュボードから追加の支払い方法を有効にできます。

URL パラメーターを使用すると、決済ページにその他の詳細情報を追加して、決済を効率化できます。URL パラメーターを使用して、決済ページの言語を変えたり、メールアドレスやプロモーションコードを事前入力したり、関連付けられたメタデータを添付して照合しやすくしたりできます。

決済を効率化し、消し込みに役立てるために、prefilled_email(または locked_prefilled_email) と client_reference_id を使用することをお勧めします。

以下は、prefilled_email と client_reference_id が指定されたリンクの例です。

https://buy.stripe.com/test_eVa3do41l4Ye6KkcMN?prefilled_email=jenny%40example.com&client_reference_id=id_123

アプリに決済ボタンを追加します。このボタンは以下を行います。

• 決済用リンクに prefilled_email と client_reference_id が事前入力されます。
• Stripe 上のオンライン決済ページを Safari で開きます。

購入が成功すると、Stripe は checkout.session.completed Webhook を送信します。Webhook イベントのペイロードでは、checkout.session object に client_reference_id があり、これをビジネスロジックに使用できます。たとえば、支払いをシステム内の特定の注文や顧客に関連付けるなどのビジネスロジックが記述可能です。

実装内容をテストするには、ダッシュボードまたは Stripe CLI を使用してイベントをモニタリングします。本番環境では、Webhook エンドポイントを設定して適切なイベントタイプに登録します。STRIPE_WEBHOOK_SECRET キーが不明な場合は、ダッシュボードで Webhook をクリックして表示します。

テスト

決済ボタンが機能することをテストするには、次の手順を実行します。

1. 決済ボタンをクリックすると、Stripe Checkout 支払いフォームにリダイレクトされます。
2. 4242424242424242
   のテストカード番号、3 桁のセキュリティコード、将来の有効期限日、および任意の有効な郵便番号を入力します。
3. 支払う をタップします。
4. checkout.session.completed Webhook が起動し、Stripe が取引についてサーバーに通知します。リダイレクトによってアプリへと戻されます。