カスタマーポータル

​

カスタマーポータルとは？

• 請求履歴を確認: 請求書を表示し、領収書をダウンロードできます。
• サブスクリプションを管理: サブスクリプションの詳細を表示し、一時停止・再開したり、すぐに、または次回請求日に解約したりできます。
• 支払い方法を更新: 有効なサブスクリプションの支払い方法を変更したり、保留中のサブスクリプションを再有効化したりできます。
• ライセンスキーを取得: 購入に紐付けられたすべてのキーにアクセスできます。
• 簡単に移動: 戻るボタンを使って、現在のコンテキストを失わずにポータル内のセクション間を移動できます。

​

主な利点

• サポート量の削減: 顧客は共通の請求リクエストを自力で解決
• 迅速な価値実現: 請求書とキーにすぐにアクセス
• 解約リスクの軽減: 更新とプラン詳細が明確に見える
• 設計上のセキュリティ: 期限付きリンクによるトークン化されたアクセス
• ローカライズされた体験: ポータルは21言語で利用可能、顧客のブラウザ設定に基づく自動検出

​

アクセス方法

​

静的リンク (メールベースのアクセス)

https://test.customer.dodopayments.com/login/{business_id}

https://customer.dodopayments.com/login/{business_id}

​

動的リンク (マジックリンク)

​

ポータルの機能

​

ポータル概要

​

支払い方法と請求履歴

​

言語サポート

​

言語選択の仕組み

• 自動検出: 初訪問時にポータルは顧客のブラウザ設定から希望言語を検出し、利用可能な場合は一致する翻訳を読み込みます。英語がフォールバックとして使用されます。
• 手動オーバーライド: 顧客はポータルヘッダーの言語セレクターから、いつでもアクティブな言語を変更できます（デスクトップとモバイルの両方で利用可能）。
• 保存された設定: 選択された言語はNEXT_LOCALEクッキーに保存され（有効期限1年）、ポータルはセッション間で設定を記憶します。

​

サポートされている言語

​

プランの変更（アップグレード/ダウングレード）

​

利用可能なアクション

​

プラン変更の仕組み

1. Customer がサブスクリプション詳細ページで Change Plan をクリックします。
2. 商品コレクションに基づいて、利用可能なアップグレード／ダウングレードのオプションが表示されます。
3. Customer が新しいプランを選択します。Confirm Plan Change パネルに、現在のプランと変更後のプラン、明細（旧プランのクレジット、新プランの請求）、税額、今すぐ支払う金額が表示されます。ここで discount code を追加することもできます。
4. Customer が Pay ${amount} をクリックして確定します。
5. 日割り計算が行われ、保存済みの payment method に対して請求が処理されます。business が payment link でプラン変更の支払いを回収する設定にしている場合は、下記の hosted checkout page が表示されます。
6. Subscription が新しいプランに更新されます。更新がすぐに行われるか、請求が完了した後にのみ行われるかは、payment failure handling によって異なります。payment link で支払うプラン変更は、必ず支払いの完了を待ちます。

​

Payment Link によるプラン変更の支払い回収

​

Business Controls

• Allow Subscription Updates: Customer が Subscription をアップグレードまたはダウングレードできる機能を有効または無効にします
• Allow Subscription Cancellation: Customer が自身の Subscription をキャンセルできる機能を有効または無効にします
• Allow Subscription Pause: Customer が自身の Subscription を一時停止および再開できる機能を有効または無効にします
• Collect Plan Change Payments by Payment Link: 保存済みの payment method に請求する代わりに、即時のプラン変更の支払いを行うため Customer を checkout page に移動します。デフォルトではオフです。

​

Subscription Details

• Plan details: Subscription の名前、価格、更新日、利用期間
• Payment method: Subscription に紐付けられたカードまたは payment method。「Edit」ボタンも表示されます
• Billing information: 名前、email、電話番号、請求先住所。「Edit」ボタンも表示されます
• Billing history: この Subscription に対するすべての支払いの詳細なテーブル
• Pause: Subscription を一時停止するオプション。self-service pause を許可している場合に表示されます
• Cancel Subscription: Subscription をキャンセルする目立つボタン

​

Subscription のキャンセル

• Cancel at next billing date: Subscription は現在の請求期間が終了するまでアクティブな状態を維持し、その後自動的にキャンセルされます。
• Cancel now: Subscription は直ちにキャンセルされます。

​

キャンセル理由

// 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 の一時停止

• アクセスは直ちに停止します。 Subscription に含まれる機能、ダウンロード、license key は、Subscription が再開されるまで利用できなくなります。
• 一時停止に終了日はありません。 Subscription は Customer が再開するまで一時停止されたままになります。
• 時間は失われません。 次回請求日と更新日は、どちらも一時停止期間の長さに応じて先送りされます。

​

Payment Methods の更新

​

保留中の Subscription の再開

1. 残りの未払い額に対する charge を作成
2. その charge の invoice を生成
3. 新しい payment method を使用して 支払いを処理
4. 支払いが成功すると Subscription を active state に 再開

​

Payment Method の更新フロー

​

Integration Examples

const session = await client.customers.customerPortal.create('cus_123');

// Redirect the user to the hosted Customer Portal
window.location.href = session.link;

​

Unified Customer Portal

​

Unified Portal の機能

• Business 横断の可視性: すべての Dodo Payments merchant における購入と Subscription を 1 か所で表示
• 一元管理: 1 つの dashboard から複数の business にまたがる Subscription を管理
• 統合された請求履歴: すべての購入の invoice と支払い履歴にアクセス
• Single sign-on: email で一度ログインするだけで、すべての Dodo Payments merchant からの購入にアクセス

​

トラブルシューティング

• Link の期限切れ: 新しい dynamic link を生成して送信します。
• Email が認識されない: Customer に購入時に使用した email を使うよう依頼します
• Subscription が保留中: Subscription が保留中の場合、Customer は未払い額を精算して Subscription を再開するため、portal から payment method を更新する必要があります。更新プロセスによって残りの未払い額が自動的に請求されます。
• Payment method の更新に失敗: on_hold Subscription の更新中に支払いに失敗した場合、Subscription は保留中のままになります。Customer は別の payment method で再試行できます。