> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# デジタルウォレット

> Apple Pay、Google Pay、Amazon Pay、Cash App Pay、RevolutPay を受け入れ、ワンタップで高速かつ安全なチェックアウトを実現します。セットアップ、ドメイン認証、テストについて学びましょう。

デジタルウォレットを利用すると、顧客は端末に保存された決済手段を使ってワンタップで支払えます。コンバージョン率の向上、トークン化による強化されたセキュリティ、簡略化されたチェックアウト体験を提供します。

## サポートされているウォレット

| ウォレット            | 対応地域         | 通貨  | サブスクリプション | 設定に必要なこと |
| :--------------- | :----------- | :-- | :-------: | :------- |
| **Apple Pay**    | グローバル（インド除く） | 全通貨 |     対応    | ドメイン認証   |
| **Google Pay**   | グローバル（インド除く） | 全通貨 |     対応    | 不要       |
| **Amazon Pay**   | グローバル（インド除く） | USD |    非対応    | 不要       |
| **Cash App Pay** | 米国のみ         | USD |    非対応    | 不要       |
| **RevolutPay**   | グローバル        | GBP |    非対応    | 不要       |

<Warning>
  **PayPal サポート一時停止：** PayPal は新規取引で一時的に利用できません。
</Warning>

## Apple Pay

Apple Pay では、Apple Wallet に保存したカードを使用し、Face ID または Touch ID で認証することで支払いができます。

### 要件

* **対応デバイス：** iOS 17 以上、iPadOS 17 以上、macOS 上の Safari 17 以上
* **プロトコル：** HTTPS が必須
* **ドメイン：** Apple による認証が必要

### ドメイン認証

<Steps>
  <Step title="Download the domain association file">
    [Apple Pay ドメイン関連ファイル](https://checkout.dodopayments.com/.well-known/apple-developer-merchantid-domain-association)をダウンロードします。
  </Step>

  <Step title="Host the file on your domain">
    次の場所にサーバーへアップロードしてください:

    ```
    https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association
    ```

    このファイルはリダイレクトなしでアクセス可能で、`Content-Type: application/octet-stream` または `text/plain` で提供されている必要があります。
  </Step>

  <Step title="Request activation">
    [support@dodopayments.com](mailto:support@dodopayments.com) 宛に以下を記載してメールを送信してください:

    * 本番環境のドメイン（例: `https://yourdomain.com`）
    * ファイルがホストされていることの確認

    確認後、1〜2営業日以内に Apple Pay を有効化します。
  </Step>

  <Step title="Test the integration">
    確認後の手順:

    1. Apple デバイスでチェックアウトを開く
    2. Apple Pay ボタンが表示されることを確認
    3. テスト取引を完了させる
  </Step>
</Steps>

<Warning>
  ドメイン認証が完了するまで、チェックアウトに Apple Pay は表示されません。ローンチ時の計画にこの点を織り込みましょう。
</Warning>

### 設定

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['apple_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});
```

## Google Pay

Google Pay では、Google アカウントに保存したカードを利用し、組み込みの不正防止機能とともに支払いができます。

### 要件

* **対応ブラウザ：** Chrome（デスクトップ/モバイル）、Safari、Firefox
* **対応デバイス：** Google Pay アプリがインストールされた Android デバイス
* **設定：** Chrome で「サイトが支払い方法を確認できるようにする」を有効にする

### 設定

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['google_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});
```

<Info>
  Google Pay にはドメイン認証は不要です — アカウントが有効になれば自動的に利用可能です。
</Info>

## Amazon Pay

Amazon Pay では、Amazon アカウントの資格情報と保存された支払い方法を使って、慣れ親しんだチェックアウト体験を提供します。

### 制限事項

* **通貨：** USD のみ
* **サブスクリプション：** 非対応
* **対応地域：** インドでは利用不可

### 設定

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['amazon_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});
```

## Cash App Pay

Cash App Pay は、個人間送金で人気のある Cash App を通じて支払いを可能にします。米国のユーザーに最適です。

### 制限事項

* **対応地域：** 米国のみ
* **通貨：** USD のみ
* **サブスクリプション：** 非対応

### 設定

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['cashapp', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});
```

## RevolutPay

RevolutPay は、既存の Revolut 残高または連携カードを活用し、世界中の Revolut ユーザーに対して高速でシームレスな支払いを提供します。

### 制限事項

* **通貨：** GBP のみ
* **サブスクリプション：** 非対応

### 設定

```javascript theme={null}
const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'prod_123', quantity: 1 }],
  allowed_payment_method_types: ['revolut_pay', 'credit', 'debit'],
  return_url: 'https://example.com/success'
});
```

## テスト

### Apple Pay のテスト

<Steps>
  <Step title="Use test mode">
    Dodo Payments ダッシュボードでテストモードを有効にします。
  </Step>

  <Step title="Add a card to Apple Wallet">
    Apple Wallet に実在のカードを追加してください。テストモードではカードに請求は発生しません。
  </Step>

  <Step title="Complete test purchase">
    Apple デバイスでチェックアウトを開き、Apple Pay フローを完了させます。
  </Step>
</Steps>

<Warning>
  Apple Pay では HTTPS が必要です。適切な SSL を設定していないと `localhost` には表示されません。
</Warning>

### Google Pay のテスト

<Steps>
  <Step title="Join the test card group">
    [Google Pay テストカードグループに参加する](https://groups.google.com/g/googlepay-test-mode-stub-data)ことで、テストカードが自動的にウォレットに追加されます。
  </Step>

  <Step title="Enable test mode">
    Dodo Payments のテスト API キーを使用してください。
  </Step>

  <Step title="Complete test purchase">
    Google Pay でテストカードの1つを選び、取引を完了させます。
  </Step>
</Steps>

### Amazon Pay と Cash App Pay

テスト API キーを使用し、標準のチェックアウトフローに従ってください。テスト取引は実際の請求なしにシミュレートされます。

## SDK サポート

### Web SDK

すべてのデジタルウォレットは次の環境で完全にサポートされています:

* Overlay Checkout
* Inline Checkout
* 直接 API 統合

### モバイル SDK

<Warning>
  **React Native の制限：** React Native SDK では Apple Pay、Google Pay、Cash App Pay、UPI は **現在サポートされていません**。これらの手段を必要とするモバイルアプリでは、Web ベースのチェックアウトオーバーレイを使用してください。
</Warning>

ネイティブモバイルサポートを実現するには、次を検討してください:

* WebView でチェックアウトを開く
* ウェブコンテキストで [Overlay Checkout](/developer-resources/overlay-checkout) を使用する
* プラットフォームネイティブの Apple Pay / Google Pay SDK を別途実装する

## ベストプラクティス

<AccordionGroup>
  <Accordion title="Prioritize wallets on mobile">
    モバイルユーザーは Apple Pay と Google Pay を期待しています。モバイルチェックアウトではこれらのオプションを目立つ場所に表示しましょう。
  </Accordion>

  <Accordion title="Complete domain verification early">
    Apple Pay にはドメイン認証が必要です。ローンチ当日まで待たず、開発中にプロセスを開始してください。
  </Accordion>

  <Accordion title="Always include card fallbacks">
    すべての顧客がデジタルウォレットを持っているわけではありません。常に `credit` と `debit` を許可された支払い方法に含めてください。
  </Accordion>

  <Accordion title="Test on real devices">
    シミュレータではウォレットの挙動を完全に再現できません。ローンチ前に実際の iOS および Android デバイスでテストしてください。
  </Accordion>

  <Accordion title="Handle wallet unavailability gracefully">
    ウォレットが利用できない場合（対応デバイスではない、カードが保存されていない等）、他の支払いオプションが表示されるようにしてください。
  </Accordion>
</AccordionGroup>

## トラブルシューティング

<AccordionGroup>
  <Accordion title="Apple Pay button not appearing">
    **確認事項：**

    1. Dodo Payments とドメイン認証済みか？
    2. HTTPS を使用しているか？
    3. デバイスは iOS 17+ / Safari 17+ / iPadOS 17+ か？
    4. 顧客の Apple Wallet にカードがあるか？
    5. `apple_pay` が `allowed_payment_method_types` に含まれているか？

    **解決策：** ドメイン認証を完了し、HTTPS を確保してください。本物の Apple デバイスでテストしてください。
  </Accordion>

  <Accordion title="Google Pay button not appearing">
    **確認事項：**

    1. Chrome または互換性のあるブラウザを使用しているか？
    2. 顧客の Google Pay にカードがあるか？
    3. Chrome の設定「サイトが支払い方法を確認できるようにする」が有効か？
    4. `google_pay` が `allowed_payment_method_types` に含まれているか？

    **解決策：** ブラウザの互換性と顧客の Google Pay 設定を確認してください。
  </Accordion>

  <Accordion title="Wallet payment failed">
    **よくある原因：**

    * ウォレット内のカードが期限切れまたは無効
    * 銀行が取引を拒否
    * ネットワーク接続の問題

    **解決策：** 顧客にウォレット内のカードを確認させるか、別の支払い方法を試してください。
  </Accordion>

  <Accordion title="Wrong device type">
    デジタルウォレットは互換性のあるデバイスでのみ表示されます:

    * Apple Pay：Apple デバイスのみ
    * Google Pay：Chrome ブラウザまたは Android デバイス

    **解決策：** これは想定された挙動です。カードのフォールバックを用意しておきましょう。
  </Accordion>
</AccordionGroup>

## 関連ページ

<CardGroup cols={2}>
  <Card title="Payment Methods Overview" icon="credit-card" href="/features/payment-methods">
    すべてのサポートされている支払い方法を確認してください。
  </Card>

  <Card title="Overlay Checkout" icon="window-restore" href="/developer-resources/overlay-checkout">
    デジタルウォレット対応のチェックアウトを実装してください。
  </Card>

  <Card title="Testing Process" icon="flask" href="/miscellaneous/testing-process">
    すべての支払い方法に対するテストガイドを完了してください。
  </Card>

  <Card title="React Native Integration" icon="mobile" href="/developer-resources/react-native-integration">
    モバイル SDK のドキュメントと制限事項をご確認ください。
  </Card>
</CardGroup>