> ## 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.
# カスタマーポータル
> 顧客が自分でサブスクリプション、請求履歴、ライセンスキー、プロフィールを安全に管理できるようにします。
カスタマーポータルは、顧客がサポートに連絡することなくサブスクリプションの管理、請求書の確認、ライセンスキーの詳細へのアクセスを行える、安全なホスト型エリアです。
プログラム的に安全で時間制限付きのポータルセッションを作成します。
定期プラン、アップグレード、ダウングレード、およびアドオンを管理します。
## カスタマーポータルとは？
ポータルは、顧客が次のことを行うための信頼できるブランド化されたセルフサービス体験を提供します：
* **請求履歴にアクセス**: 請求書を閲覧し、領収書をダウンロード。
* **サブスクリプションの管理**: サブスクリプションの詳細を表示し、即時または次回の請求日にキャンセル。
* **支払い方法の更新**: アクティブなサブスクリプションの支払い方法を変更したり、保留中のサブスクリプションを再アクティブ化。
* **ライセンスキーの取得**: 購入に関連するすべてのキーにアクセス。
* **簡単なナビゲーション**: 戻るボタンを使用して、コンテキストを失わずにポータルセクション間を移動。
## 主な利点
* **サポート量の削減**: 顧客は共通の請求リクエストを自力で解決
* **迅速な価値実現**: 請求書とキーにすぐにアクセス
* **解約リスクの軽減**: 更新とプラン詳細が明確に見える
* **設計上のセキュリティ**: 期限付きリンクによるトークン化されたアクセス
* **ローカライズされた体験**: ポータルは21言語で利用可能、顧客のブラウザ設定に基づく自動検出
## アクセス方法
顧客は、静的リンクまたは一時的な動的リンクのいずれかを使用してポータルにアクセスできます。
### 静的リンク (メールベースのアクセス)
顧客は、決して期限切れにならない静的リンクにメールアドレスを入力することでポータルアクセスをリクエストできます。
静的ポータルリンクの形式は環境によって異なります：
**テストモード** (テストおよび開発用)：
```bash theme={null}
https://test.customer.dodopayments.com/login/{business_id}
```
**ライブモード** (実際の取引用)：
```bash theme={null}
https://customer.dodopayments.com/login/{business_id}
```
`{business_id}`を実際のビジネス識別子に置き換え、顧客に適切なリンクを共有して、メールを入力しポータルへの安全なアクセスを受け取れるようにします。
1. セールス → 顧客に移動します。
2. 招待状を共有をクリックします。
3. 静的リンクをコピーして顧客と共有します。
1. 静的リンクを開きます。
2. 購入時に使用したメールアドレスを入力します。
3. ポータルにアクセスするための安全なログインリンクを受け取ります。
既存の顧客は自動的に認識されます。
### 動的リンク (マジックリンク)
顧客をポータルに直接送信するパーソナライズされた一時的なマジックリンク。リンクは24時間で期限切れになります。
動的リンクは24時間後に期限切れになります。期限切れの場合は、新しいリンクを生成して送信してください。
1. セールス → 顧客に移動します。
2. 招待状を共有をクリックします。
3. 動的リンクをコピーして顧客と共有します。
1. 動的リンクを開きます。
2. メールを入力せずにカスタマーポータルに直接アクセスします。
## ポータルの機能
刷新されたカスタマーポータルは、左のサイドバーと整理されたセクションを備え、すべてのアカウント管理ニーズに対してクリーンで統一されたインターフェースを提供します。
すべてのアクティブなサブスクリプションをプラン名、価格、更新日、期間とともに表示します。「サブスクリプションを管理」で詳細を表示し、請求情報を編集したりキャンセルできます。
保存済みの支払い方法（カード、UPIなど）を一目で確認できます。支払い方法はサブスクリプションの詳細から直接編集できます。
日付、ステータス、価格タイプ、利用権限、ダウンロード可能な請求書を含む詳細なテーブルで、すべての取引を表示します。
サブスクリプション詳細ページから氏名、メール、電話番号、請求先住所を表示および編集できます。
### ポータル概要
メインのポータルページには、すべてのアクティブなサブスクリプション、保存済みの支払い方法、および請求履歴が1つのスクロール可能な画面に表示されます。
### 支払い方法と請求履歴
下にスクロールすると保存済みの支払い方法と、ステータス表示および請求書ダウンロード機能付きの完全な請求履歴を確認できます。
## 言語サポート
顧客ポータルは**21言語**で利用可能ですので、顧客は彼らが最も快適な言語でサブスクリプション、支払い方法、請求履歴を管理できます。
### 言語選択の仕組み
* **自動検出**: 初訪問時にポータルは顧客のブラウザ設定から希望言語を検出し、利用可能な場合は一致する翻訳を読み込みます。英語がフォールバックとして使用されます。
* **手動オーバーライド**: 顧客はポータルヘッダーの言語セレクターから、いつでもアクティブな言語を変更できます（デスクトップとモバイルの両方で利用可能）。
* **保存された設定**: 選択された言語は`NEXT_LOCALE`クッキーに保存され（有効期限1年）、ポータルはセッション間で設定を記憶します。
### サポートされている言語
| 言語 | コード | 言語 | コード |
| ---------- | ---- | ------- | ---- |
| 英語 (デフォルト) | `en` | インドネシア語 | `id` |
| アラビア語 | `ar` | イタリア語 | `it` |
| カタルーニャ語 | `ca` | 日本語 | `ja` |
| 中国語 | `zh` | 韓国語 | `ko` |
| オランダ語 | `nl` | マレー語 | `ms` |
| フランス語 | `fr` | ポーランド語 | `pl` |
| ドイツ語 | `de` | ポルトガル語 | `pt` |
| ヘブライ語 | `he` | ルーマニア語 | `ro` |
| ロシア語 | `ru` | スペイン語 | `es` |
| スウェーデン語 | `sv` | タイ語 | `th` |
| トルコ語 | `tr` | | |
## プランの変更（アップグレード/ダウングレード）
製品が**Product Collections**に整理されている場合、顧客は顧客ポータルから直接プランをアップグレードまたはダウングレードできます。
**既存のサブスクリプションにアップグレード/ダウングレード機能を有効にしますか？** サブスクリプション製品をProduct Collectionに追加してください。グループ化されると、顧客は同じコレクション内でプランを切り替えることができます。
### 利用可能なアクション
| アクション | 説明 | 利用可能な場合 |
| ----------- | ------------------ | ------------------------ |
| **アップグレード** | 同じコレクション内の上位プランに移行 | ビジネスがサブスクリプションの更新を許可した場合 |
| **ダウングレード** | 同じコレクション内の下位プランに移行 | ビジネスがサブスクリプションの更新を許可した場合 |
### プラン変更の仕組み
1. 顧客はポータルで現在のサブスクリプションを表示
2. Product Collectionに基づいて利用可能なアップグレード/ダウングレードオプションが表示
3. 顧客は新しいプランを選択
4. プロレーションが計算され、支払いが即時処理されます（該当する場合）
5. サブスクリプションが新しいプランに更新されます
プラン変更は同じコレクション内の製品間でのみ利用可能です。製品はサブスクリプションまたは使用量ベースの請求タイプでなければなりません。
### ビジネスコントロール
ビジネスは、サブスクリプション設定でプラン変更の挙動を構成できます。
* **サブスクリプションの更新を許可**: 顧客がサブスクリプションをアップグレードまたはダウングレードできるようにするかどうかを設定
製品コレクションを設定し、アップグレード/ダウングレードパスを構成する方法を学びます。
## サブスクリプション詳細
顧客がアクティブなサブスクリプションで「サブスクリプションを管理」をクリックすると、サブスクリプションの詳細ページに移動します。このページには以下が表示されます：
* **プランの詳細**: サブスクリプション名、価格、更新日、有効期間
* **支払い方法**: サブスクリプションにリンクされたカードまたは支払い方法、「編集」ボタン付き
* **請求情報**: 氏名、メール、電話番号、請求先住所、「編集」ボタン付き
* **請求履歴**: このサブスクリプションに対するすべての支払いの詳細なテーブル
* **サブスクリプションのキャンセル**: サブスクリプションをキャンセルする目立つボタン
## サブスクリプションのキャンセル
顧客はサブスクリプション詳細ページから直接サブスクリプションをキャンセルできます。「サブスクリプションをキャンセル」をクリックすると、確認ダイアログが表示され、次の2つのオプションがあります：
* **次の請求日にキャンセル**: サブスクリプションは現在の請求期間が終了するまでアクティブのままで、その後自動的にキャンセルされます。
* **今すぐキャンセル**: サブスクリプションが直ちにキャンセルされます。
### キャンセル理由
キャンセルを確認する前に、顧客には\*\*「なぜキャンセルするのですか？」\*\*と尋ねられ、リストから理由を選ぶよう促されます。この理由はサブスクリプションに保存され、WebhookペイロードやAPIで確認できるため、解約動機を分析し、再取得フローを調整することができます。
| 値 | 顧客向けラベル |
| ------------------ | ------------ |
| `too_expensive` | 料金が高すぎる |
| `missing_features` | 機能が不足している |
| `switched_service` | 別のサービスに切り替えた |
| `unused` | 十分に使用していない |
| `customer_service` | サポートが不十分 |
| `low_quality` | 品質が低い |
| `too_complex` | 複雑すぎる |
| `other` | その他 |
選択された値はサブスクリプションの`cancellation_feedback`フィールドに書き込まれます。オプションで自由記述の`cancellation_comment`も記録できます。
```typescript theme={null}
// Read the captured feedback after a customer cancels
const subscription = await client.subscriptions.retrieve('sub_123');
console.log(subscription.cancellation_feedback); // e.g., "too_expensive"
console.log(subscription.cancellation_comment); // e.g., "Switching to a competitor"
```
両フィールドは`subscription.cancelled` Webhookペイロードにも含まれ、APIを通じてキャンセルをスケジュールまたは実行する際にプログラム的に入力できます。
`cancellation_feedback`を[サブスクリプション滞納](/features/recovery/subscription-dunning)と組み合わせて、再度利用を促すメールを調整します。例えば、`too_expensive`キャンセル者には割引コードを送ったり、`missing_features`キャンセル者には「何が足りませんか？」というアンケートを送ったりします。
## 支払い方法の更新
顧客はサブスクリプションの詳細ページから直接「編集」をクリックして支払い方法を更新できます。この機能は、支払いが失敗したために保留状態になったサブスクリプションを再活性化する際に特に重要です。
### 保留中のサブスクリプションの再活性化
支払いの失敗により`on_hold`状態になったサブスクリプションを再活性化するには、顧客は支払い方法を更新する必要があります。この更新プロセスは自動的に:
1. **未払金の請求**を作成
2. 請求書の**発行**
3. 新しい支払い方法を使用した**支払いの処理**
4. 成功した支払いの後にサブスクリプションを`active`状態に**再活性化**
`on_hold`状態のサブスクリプションは自動的に更新されません。顧客は支払い方法を更新して未払金を清算し、サブスクリプションを再活性化する必要があります。
`on_hold`サブスクリプションの支払い方法を正常に更新した後、顧客には確認ページが表示され、支払い成功とサブスクリプション再活性化に関するメール通知が送信されます。
### 支払い方法の更新フロー
ポータルホームページから任意のアクティブなサブスクリプションで「サブスクリプションを管理」をクリックします。
支払い方法の横にある「編集」ボタンをクリックして、支払い方法更新インターフェースを開きます。
既存の保存された支払い方法を選択するか、カード情報を安全に入力して新しい支払い方法を追加します。
更新を確認します。`on_hold`サブスクリプションの場合、未払金の請求が自動的に作成されます。
サブスクリプションが保留中の場合、顧客は未払金の支払いを完了するようリダイレクトされます。支払いが成功するとサブスクリプションは自動的に再活性化されます。
顧客は支払い方法が更新されたこと、また該当する場合にはサブスクリプションが再活性化されたことを確認する通知を受け取ります。
## 統合例
特定の顧客に対する時間制限付きのカスタマーポータルセッションをAPI経由で作成し、ユーザーをセッションURLにリダイレクトします。
```typescript Node.js theme={null}
const session = await client.customers.customerPortal.create('cus_123');
// Redirect the user to the hosted Customer Portal
window.location.href = session.link;
```
## 統一カスタマーポータル
特定事業者のカスタマーポータルに加えて、ドードー・ペイメンツは[customer.dodopayments.com](https://customer.dodopayments.com)で**統一カスタマーポータル**を提供しています。ここでは異なる事業者との全ての購入とサブスクリプションを閲覧し、管理することができます。
### 統一ポータルの機能
* **クロス事業者の可視性**: 全ての事業者からの購入とサブスクリプションを一箇所で確認
* **集中管理**: 異なる事業者のサブスクリプションを一つのダッシュボードで管理
* **統一請求履歴**: 全ての購入からの請求書と支払い履歴にアクセス
* **シングルサインオン**: メールで一度ログインするだけで全てのドードー・ペイメンツ事業者の購入にアクセス
統一カスタマーポータルは事業者別のポータルを補完します。顧客はブランド化された事業者ポータルまたは統一ポータルのどちらかを選んで利用できます。
## トラブルシューティング
* **リンクが期限切れ**: 新しい動的リンクを生成して送信します。
* **メールが認識されない**: 購入に関連づけられたメールアドレスを使用するよう顧客に依頼してください。
* **サブスクリプションが保留中**: サブスクリプションが保留中の場合、顧客はポータルを通じて支払い方法を更新し、未払金を清算してサブスクリプションを再活性化する必要があります。更新プロセスは残りの未払金を自動的に請求します。
* **支払い方法の更新が失敗した**: `on_hold`サブスクリプションの更新プロセス中に支払いが失敗した場合、サブスクリプションは保留状態のままです。他の支払い方法で再試行することができます。
設計ページから事前に用意されたテーマ、タイポグラフィー、カラー、ライブプレビューを使ってカスタマーポータルの外観をカスタマイズします。