カスタマーポータル

​

Customer Portalとは？

• 請求履歴へのアクセス：過去の支払いを表示し、請求書をダウンロードします。
• サブスクリプションの管理：サブスクリプションの詳細を表示し、一時停止・再開したり、設定に応じて直ちにキャンセルしたり、次回請求日にキャンセルしたりできます。
• 支払い方法の更新：サブスクリプションの支払い方法を変更したり、保留中のサブスクリプションを再有効化したりできます。
• ライセンスキーの取得：購入に紐付けられたライセンスキーを確認できます。
• アプリに戻る：return_urlを渡すと、ポータルにビジネスへの戻るリンクが表示されます。モバイルでは、ヘッダーの戻る矢印をタップするとポータルの概要に戻ります。

​

主なメリット

• サポート量の削減：顧客が一般的な請求に関する依頼を自分で処理できます。
• 迅速なアクセス：顧客はサインインするとすぐに請求書とライセンスキーを取得できます。
• 解約リスクの低減：顧客は請求前に更新日とプランの詳細を確認できます。
• 署名付きで有効期限のあるリンク：すべてのサインインリンクには署名が付けられ、24時間後に期限切れになります。
• ローカライズされた体験：ポータルは21言語に対応しており、顧客のブラウザー設定から言語を選択します。

​

アクセス方法

​

静的リンク（メールベースのアクセス）

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

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

​

動的リンク（マジックリンク）

​

ポータルの機能

​

ポータルの概要

​

支払い方法と請求履歴

​

言語サポート

​

言語選択の仕組み

• 自動検出：初回アクセス時に、ポータルはブラウザーから優先言語を読み取り、対応していればその言語で読み込みます。対応していない場合は英語を使用します。
• 手動変更：顧客はデスクトップとモバイルのページ右下にある言語セレクターから、いつでも言語を変更できます。
• 設定の保存：ポータルはNEXT_LOCALE Cookieに選択した言語を1年間保存するため、再訪時にも同じ言語が使用されます。

​

対応言語

​

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

​

利用可能な操作

​

プラン変更の仕組み

1. 顧客がサブスクリプションの詳細ページでChange Planをクリックします。
2. ポータルにProduct Collection内の他のプランが一覧表示されます。
3. 顧客がプランを選択します。Confirm Plan Changeパネルに、現在のプランと更新後のプラン、明細の内訳（旧プランのクレジットと新プランの請求）、税額、今すぐ支払う金額が表示されます。顧客はここで割引コードも入力できます。
4. 顧客が、支払額を表示するPayボタンで確定します。
5. Dodo Paymentsが日割り計算を行い、保存済みの支払い方法から請求するか、プラン変更の支払いをpayment linkで回収する設定の場合はホスト型checkoutページで請求します（payment linkによるプラン変更の支払い回収を参照）。
6. サブスクリプションが新しいプランに移行します。移行が直ちに行われるか、請求が成功した後にのみ行われるかは、支払い失敗の処理の設定によって異なります。payment linkで支払うプラン変更の場合は、常に支払いを待ってから移行します。

​

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

​

Businessの制御

• Allow Subscription Updates：顧客によるアップグレードまたはダウングレードを許可します。デフォルトではオフです。
• Allow Immediate Cancellation：顧客がサブスクリプションを終了し、直ちにアクセスを失うことを許可します。デフォルトではオンです。
• Allow Cancellation at Next Billing Date：顧客が支払い済みの期間の終了時にキャンセルできるようにします。デフォルトではオンです。
• Allow Subscription Pause：顧客が自分のサブスクリプションを一時停止・再開できるようにします。デフォルトではオフです。
• Collect Plan Change Payments by Payment Link：保存済みの支払い方法に請求する代わりに、顧客をcheckoutページに移動して即時のプラン変更料金を支払わせます。デフォルトではオフです。

​

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

• Plan details：サブスクリプション名、価格、更新日、有効期間。
• Payment method：サブスクリプションの支払い方法とEditボタン。
• Billing information：名前、メールアドレス、電話番号、請求先住所と、名前および請求先住所用のEditボタン。
• Billing history：このサブスクリプションのすべての支払いを一覧表示する表。
• Pause Subscription：セルフサービスでの一時停止を許可している場合に表示されます。
• Cancel Subscription：キャンセルダイアログを開きます。

​

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

• Cancel at next billing date：現在の請求期間が終了するまでサブスクリプションはアクティブのままになり、その後キャンセルされます。
• Cancel now：サブスクリプションが直ちにキャンセルされます。

​

キャンセル理由

// `client` is a DodoPayments client, created as in the Integration Guide.
// 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"

​

サブスクリプションの休止

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

​

支払い方法の更新

​

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

1. 残りの未払い額に対するchargeを作成します
2. chargeのinvoiceを生成します
3. 新しい支払い方法で支払いを回収します
4. 支払いが成功すると、サブスクリプションをactiveに再有効化します

​

Grace Period中のサブスクリプションの再有効化

​

支払い方法の更新フロー

​

インテグレーション例

// Server: `client` is a DodoPayments client, created as in the Integration Guide.
const session = await client.customers.customerPortal.create('cus_123', {
  return_url: 'https://yourapp.com/account', // optional: shown as a back link in the portal
});

// Send session.link to the browser, then redirect the customer:
// window.location.href = session.link;

​

Unified Customer Portal

​

Unified Portalの機能

• ビジネス横断の可視性：すべてのDodo Payments加盟店からの購入とサブスクリプションを1か所で確認できます。
• 一元管理：異なるビジネスのサブスクリプションを1つのサイトで管理できます。
• 統合された請求履歴：すべての購入に関する請求書と支払い履歴にアクセスできます。
• 1回のサインイン：メールアドレスで一度サインインすると、すべてのDodo Payments加盟店からの購入にアクセスできます。

​

トラブルシューティング

• リンクの期限切れ：新しい動的リンクを生成して顧客に送信します。
• メールアドレスが認識されない：顧客には購入時に使用したメールアドレスを使うよう案内します。あなたのビジネスの顧客ではないメールアドレスには、サインインメールは送信されません。
• サブスクリプションが保留中：顧客がポータルで支払い方法を更新します。Dodo Paymentsは残りの未払い額を請求し、支払いが成功するとサブスクリプションを再有効化します。
• 支払い方法の更新に失敗：on_holdのサブスクリプションで更新中に支払いが失敗した場合、サブスクリプションは保留中のままです。顧客は別の支払い方法で再試行できます。