カスタマーポータル - Dodo Payments Documentation

カスタマーポータルは、顧客がサポートに連絡することなくサブスクリプションの管理、請求書の確認、ライセンスキーの詳細へのアクセスを行える、安全なホスト型エリアです。

Create Portal Session (API)

プログラム的に安全で時間制限付きのポータルセッションを作成します。

Subscriptions

定期プラン、アップグレード、ダウングレード、およびアドオンを管理します。

アクティブなサブスクリプション、支払い方法、請求履歴を表示する刷新された顧客ポータル

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

ポータルは、顧客が次のことを行うための信頼できるブランド化されたセルフサービス体験を提供します：

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

主な利点

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

アクセス方法

顧客は、静的リンクまたは一時的な動的リンクのいずれかを使用してポータルにアクセスできます。

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

顧客は、決して期限切れにならない静的リンクにメールアドレスを入力することでポータルアクセスをリクエストできます。静的ポータルリンクの形式は環境によって異なります： テストモード (テストおよび開発用)：

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

ライブモード (実際の取引用)：

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

{business_id}を実際のビジネス識別子に置き換え、顧客に適切なリンクを共有して、メールを入力しポータルへの安全なアクセスを受け取れるようにします。

Merchant flow

セールス → 顧客に移動します。
招待状を共有をクリックします。
静的リンクをコピーして顧客と共有します。

Customer flow

静的リンクを開きます。
購入時に使用したメールアドレスを入力します。
ポータルにアクセスするための安全なログインリンクを受け取ります。

既存の顧客は自動的に認識されます。

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

顧客をポータルに直接送信するパーソナライズされた一時的なマジックリンク。リンクは24時間で期限切れになります。

動的リンクは24時間後に期限切れになります。期限切れの場合は、新しいリンクを生成して送信してください。

Merchant flow

セールス → 顧客に移動します。
招待状を共有をクリックします。
動的リンクをコピーして顧客と共有します。

Customer flow

動的リンクを開きます。
メールを入力せずにカスタマーポータルに直接アクセスします。

ポータルの機能

刷新されたカスタマーポータルは、左のサイドバーと整理されたセクションを備え、すべてのアカウント管理ニーズに対してクリーンで統一されたインターフェースを提供します。

Active Subscriptions

プラン名、価格、更新日、有効期間とともに、すべての有効なサブスクリプションを表示します。「サブスクリプションを管理」をクリックすると、詳細の表示、請求情報の編集、一時停止、解約ができます。

Payment Methods

保存済みの支払い方法（カード、UPIなど）を一目で確認できます。支払い方法はサブスクリプションの詳細から直接編集できます。

Billing History

日付、ステータス、価格タイプ、利用権限、ダウンロード可能な請求書を含む詳細なテーブルで、すべての取引を表示します。

Billing Information

サブスクリプション詳細ページから氏名、メール、電話番号、請求先住所を表示および編集できます。

ポータル概要

メインのポータルページには、すべてのアクティブなサブスクリプション、保存済みの支払い方法、および請求履歴が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に追加してください。グループ化されると、顧客は同じコレクション内でプランを切り替えることができます。

利用可能なアクション

アクション	説明	利用可能な場合
アップグレード	同じコレクション内の上位プランに移行	ビジネスがサブスクリプションの更新を許可した場合
ダウングレード	同じコレクション内の下位プランに移行	ビジネスがサブスクリプションの更新を許可した場合

プラン変更の仕組み

顧客はポータルで現在のサブスクリプションを表示
Product Collectionに基づいて利用可能なアップグレード/ダウングレードオプションが表示
顧客は新しいプランを選択
プロレーションが計算され、支払いが即時処理されます（該当する場合）
サブスクリプションが新しいプランに更新されます

プラン変更は同じコレクション内の製品間でのみ利用可能です。製品はサブスクリプションまたは使用量ベースの請求タイプでなければなりません。

ビジネスコントロール

Businesses can configure portal subscription behavior in Subscription Settings:

サブスクリプションの更新を許可: 顧客によるサブスクリプションのアップグレードまたはダウングレードを有効または無効にします
サブスクリプションの解約を許可: 顧客が自分でサブスクリプションを解約できるようにするかどうかを設定します
サブスクリプションの一時停止を許可: 顧客が自分でサブスクリプションを一時停止・再開できるようにするかどうかを設定します

Product Collections

製品コレクションを設定し、アップグレード/ダウングレードパスを構成する方法を学びます。

サブスクリプション詳細

顧客がアクティブなサブスクリプションで「サブスクリプションを管理」をクリックすると、サブスクリプションの詳細ページに移動します。このページには以下が表示されます：

プランの詳細: サブスクリプション名、価格、更新日、有効期間
支払い方法: サブスクリプションに紐付けられたカードまたは支払い方法。「編集」ボタン付き
請求情報: 名前、メールアドレス、電話番号、請求先住所。「編集」ボタン付き
請求履歴: このサブスクリプションに対するすべての支払いの詳細な表
一時停止: セルフサービスでの一時停止を許可している場合に表示される、サブスクリプションを一時停止するオプション
サブスクリプションを解約: サブスクリプションを解約するための目立つボタン

サブスクリプションのキャンセル

顧客はサブスクリプション詳細ページから直接サブスクリプションをキャンセルできます。「サブスクリプションをキャンセル」をクリックすると、確認ダイアログが表示され、次の2つのオプションがあります：

次の請求日にキャンセル: サブスクリプションは現在の請求期間が終了するまでアクティブのままで、その後自動的にキャンセルされます。
今すぐキャンセル: サブスクリプションが直ちにキャンセルされます。

Self-service cancellation is controlled by the Allow Subscription Cancellation setting under Settings → Subscriptions, which is enabled by default. When you turn it off, the Cancel Subscription button is disabled with a tooltip asking the customer to contact you, and both portal cancellation paths — cancel now and cancel at next billing date — are rejected. Customers who already have a scheduled cancellation keep the option to revoke it, so they can choose to stay. Cancellations you perform yourself are never affected.

Cancel subscription dialog with options to cancel at next billing date or cancel immediately

Cancellation Reasons

Before confirming cancellation, customers are asked “Why are you cancelling?” and prompted to pick a reason from a curated list. The reason is stored on the subscription and surfaced in webhook payloads and the API, so you can analyze churn drivers and tailor your win-back flows.

Cancellation modal with the 'Why are you cancelling?' dropdown showing reasons like Too expensive, Missing features, and Other

Value	Customer-facing label
`too_expensive`	Too expensive
`missing_features`	Missing features
`switched_service`	Switched to another service
`unused`	Not using it enough
`customer_service`	Poor customer service
`low_quality`	Low quality
`too_complex`	Too complex
`other`	Other

The selected value is written to the subscription’s cancellation_feedback field. An optional free-text cancellation_comment can also be captured.

// 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 payload にも含まれており、API を通じてキャンセルをスケジュールまたは実行する際に、PATCH /subscriptions/{subscription_id} でプログラムから値を設定できます。

Combine cancellation_feedback with Subscription Dunning to tailor win-back emails — for example, send a discount code to too_expensive cancellers and a “what’s missing?” survey to missing_features cancellers.

サブスクリプションの一時停止

一時停止は、サブスクリプションを継続するか完全に解約するかの中間となる選択肢を顧客に提供します。一時停止中のサブスクリプションでは請求が停止しますが、プランと履歴は保持されるため、最初からやり直すのではなく、後で再開できます。顧客はサブスクリプション詳細ページから一時停止ダイアログを開きます。ダイアログには現在のプランが表示され、アクセスが直ちに終了することへの警告と、請求日がどのように変更されるかが説明されます。顧客は サブスクリプションを一時停止 をクリックして確定します。

顧客に伝えられる内容と、実際に発生すること:

アクセスは直ちに停止します。 サブスクリプションに含まれる機能、ダウンロード、ライセンスキーは、サブスクリプションを再開するまで利用できなくなります。
一時停止に終了日はありません。 顧客が再開するまで、サブスクリプションは一時停止されたままになります。
時間が失われることはありません。 次回請求日と更新日は、一時停止期間の長さだけ先に延長されます。

再開も同じ流れで行います。サブスクリプションは active に戻り、アクセスが復元されます。

セルフサービスでの一時停止は、Settings → Subscriptions にある Allow Subscription Pause 設定で制御され、デフォルトでは無効 になっています。無効な間は、顧客は新たに一時停止を開始できません。ただし、すでに一時停止中の顧客は、自分で開始した一時停止を引き続き再開できます。ダッシュボードから自分で実行する一時停止には、設定の影響はありません。

How Pausing Works

請求への影響、利用状況の精算、webhooksを含む、一時停止の完全な動作。

支払い方法の更新

顧客は、支払い方法の横にある「編集」をクリックして、サブスクリプション詳細ページから直接支払い方法を更新できます。この機能は、支払い失敗により保留中になったサブスクリプションを再有効化する場合に特に重要です。

保留中のサブスクリプションの再有効化

支払い失敗によりサブスクリプションが on_hold 状態になると、顧客は再有効化するために支払い方法を更新する必要があります。更新処理では自動的に次の操作が行われます:

残りの未払い金額に対する請求を作成
請求に対する請求書を生成
新しい支払い方法で支払いを処理
支払いが成功すると、サブスクリプションを active 状態に再有効化

on_hold 状態のサブスクリプションは自動的に更新されません。顧客は未払い金額を清算し、サブスクリプションを再有効化するために、支払い方法を更新する必要があります。

on_hold サブスクリプションの支払い方法の更新に成功すると、顧客には確認ページが表示され、支払いの成功とサブスクリプションの再有効化に関するメール通知が届きます。

支払い方法の更新フロー

Access subscription details

ポータルのホームページで、任意の有効なサブスクリプションの「サブスクリプションを管理」をクリックします。

Click Edit on payment method

支払い方法の横にある「編集」ボタンをクリックして、支払い方法の更新インターフェースを開きます。

Select or add payment method

既存の保存済み支払い方法を選択するか、カード情報を安全に入力して新しい支払い方法を追加します。

Confirm changes

更新を確定します。on_hold サブスクリプションの場合、残りの未払い金額に対する請求が自動的に作成されます。

Complete payment (if on hold)

サブスクリプションが保留中の場合、顧客は残りの未払い金額の支払いを完了するためにリダイレクトされます。支払いが成功すると、サブスクリプションは自動的に再有効化されます。

Confirmation

顧客には、支払い方法が更新されたこと、該当する場合はサブスクリプションが再有効化されたことを知らせる確認が表示されます。

統合例

APIを介して特定の顧客向けの有効期限付きCustomer Portalセッションを作成し、その後ユーザーをセッションURLにリダイレクトします。

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

ビジネス固有のカスタマーポータルに加えて、Dodo Paymentsは customer.dodopayments.com に Unified Customer Portal を提供しています。顧客はここで、Dodo Paymentsを利用するさまざまなビジネスにおけるすべての購入とサブスクリプションを確認・管理できます。

Unified Portalの機能

ビジネス横断の可視性: すべての購入とサブスクリプションを、任意のDodo Payments加盟店から一か所で確認できます
一元管理: 一つのダッシュボードから、さまざまなビジネスのサブスクリプションを管理できます
統合された請求履歴: すべての購入の請求書と支払い履歴にアクセスできます
シングルサインオン: メールアドレスで一度ログインするだけで、すべてのDodo Payments加盟店での購入にアクセスできます

Unified Customer Portalは、ビジネス固有のポータルを補完します。顧客は好みに応じて、ブランド化された加盟店ポータルまたは統合ポータルのいずれかを利用できます。

トラブルシューティング

リンクの有効期限切れ: 新しい動的リンクを生成して送信します。
メールアドレスが認識されない: 購入時に使用したメールアドレスを使うよう顧客に案内します
サブスクリプションが保留中: サブスクリプションが保留中の場合、顧客は未払い金額を清算してサブスクリプションを再有効化するために、ポータルから支払い方法を更新する必要があります。更新処理によって、残りの未払い金額が自動的に請求されます。
支払い方法の更新に失敗: on_hold サブスクリプションの更新処理中に支払いに失敗した場合、サブスクリプションは保留中のままになります。顧客は別の支払い方法で再試行できます。

Design & Theme Customization

Designページから、あらかじめ用意されたテーマ、タイポグラフィ、カラー、ライブプレビューを使ってカスタマーポータルの外観をカスタマイズできます。

Create Portal Session (API)

Subscriptions

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

​主な利点

​アクセス方法

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

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

​ポータルの機能

Active Subscriptions

Payment Methods

Billing History

Billing Information

​ポータル概要

​支払い方法と請求履歴

​言語サポート

​言語選択の仕組み

​サポートされている言語

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

​利用可能なアクション

​プラン変更の仕組み

​ビジネスコントロール

Product Collections

​サブスクリプション詳細

​サブスクリプションのキャンセル

​Cancellation Reasons

​サブスクリプションの一時停止

How Pausing Works

​支払い方法の更新

​保留中のサブスクリプションの再有効化

​支払い方法の更新フロー

​統合例

​Unified Customer Portal

​Unified Portalの機能

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

Design & Theme Customization

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

主な利点

アクセス方法

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

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

ポータルの機能

ポータル概要

支払い方法と請求履歴

言語サポート

言語選択の仕組み

サポートされている言語

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

利用可能なアクション

プラン変更の仕組み

ビジネスコントロール

サブスクリプション詳細

サブスクリプションのキャンセル

Cancellation Reasons

サブスクリプションの一時停止

支払い方法の更新

保留中のサブスクリプションの再有効化

支払い方法の更新フロー

統合例

Unified Customer Portal

Unified Portalの機能

トラブルシューティング