サブスクリプション用アドオン

アドオンは、サブスクリプションに追加できる補助的な商品です。顧客はチェックアウト時またはサブスクリプションの更新時に数量を選択でき、アドオンは親サブスクリプションの請求サイクルに基づいて請求されます。

Seat-Based Billing

チーム用の追加シートやユーザーライセンス向けにアドオンを作成できます。

Usage Extensions

アドオンを利用して、使用量の上限、API 呼び出し数、データ容量を拡張できます。

アドオンとは？

アドオンは、顧客がメインのサブスクリプションと一緒に購入できる補助的な商品です。シートベースの課金、機能のアップグレード、使用量の拡張、サービスの追加に適しています。

主なメリット

アドオンを利用すると、柔軟な価格モデル、アップセル機会による収益の最適化、1 つのダッシュボードからの簡単な管理、サブスクリプションを顧客が自由にカスタマイズできる選択肢を実現できます。

アドオンの作成

アドオンはダッシュボードで個別の商品として作成し、その後サブスクリプション商品に追加します。これにより、複数のサブスクリプションでアドオンを再利用し、価格を個別に管理できます。

アドオンの設定

アドオンを作成する際は、次の項目を設定できます。

価格: 最小通貨単位でアドオンの金額（price）を設定します。アドオンは親サブスクリプションの請求サイクルに基づいて請求されます
通貨: Dodo Payments が請求できる任意の通貨で基準価格を設定します。検索可能な通貨セレクターでは、USD、GBP、EUR、INR が上部に固定表示されます。基準通貨以外の顧客には、Adaptive Currency を通じて請求されます
数量: 顧客はアドオンをサブスクリプションに追加する際に数量を選択します
利用可能性: 各商品の addons リストを通じて、アドオンをサブスクリプション商品に追加します。アドオン自体には利用可能性の設定はありません
税設定: 適切な tax_category を設定します

はじめに

サブスクリプションビジネスでアドオンを導入する準備はできましたか？次の手順で始めましょう。

Plan Your Add-ons

アドオンとして提供すると顧客にメリットがある追加機能、サービス、容量を特定します。次の点を検討してください。

顧客から頻繁に依頼されるものは何か
個別に収益化できる機能は何か
自然なアップグレードの導線を作れるものは何か

Create Your First Add-on

Dodo Payments のダッシュボードまたは API を使用して、最初のアドオン商品を作成します。

Dashboard Guide

ステップごとのガイドに従って、ダッシュボードでアドオンを作成します。

Attach to Subscriptions

アドオンを、利用可能にする適切なサブスクリプション商品に接続します。

Test Integration

さまざまなアドオンの組み合わせでテスト用チェックアウトセッションを作成し、すべてが正しく動作することを確認します。

Monitor Performance

アドオンの導入率と収益への影響を追跡し、価格戦略を最適化します。

一般的なユースケース

シートベースの課金: 追加のチームメンバー、ユーザーライセンス、同時利用ユーザー
機能のアップグレード: プレミアム機能、高度な分析、優先サポート
使用量の拡張: 追加ストレージ、API 呼び出し、帯域幅の容量
サービスの追加: プロフェッショナルサービス、トレーニング、コンサルティング時間

統合例

アドオン付きチェックアウトセッション

チェックアウトセッションを作成する際は、数量とともにアドオンを含めます。

const session = await client.checkoutSessions.create({
  product_cart: [
    {
      product_id: 'pdt_123',
      quantity: 1,
      addons: [
        {
          addon_id: 'addon_456',
          quantity: 3 // 3 additional seats
        }
      ]
    }
  ],
  customer: { email: 'customer@example.com' },
  return_url: 'https://yourapp.com/success'
});

session = client.checkout_sessions.create(
    product_cart=[
        {
            "product_id": "pdt_123",
            "quantity": 1,
            "addons": [
                {
                    "addon_id": "addon_456",
                    "quantity": 3  # 3 additional seats
                }
            ]
        }
    ],
    customer={"email": "customer@example.com"},
    return_url="https://yourapp.com/success"
)

curl -X POST https://test.dodopayments.com/checkouts \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_cart": [
      {
        "product_id": "pdt_123",
        "quantity": 1,
        "addons": [
          {
            "addon_id": "addon_456",
            "quantity": 3
          }
        ]
      }
    ],
    "customer": {"email": "customer@example.com"},
    "return_url": "https://yourapp.com/success"
  }'

顧客がチェックアウトページで自分でアドオンを追加または削除できるようにするには、セッションの作成時に allow_editing_addons 機能フラグを true に設定します。デフォルトは false で、サブスクリプション商品のみに適用されます。

const session = await client.checkoutSessions.create({
  product_cart: [{ product_id: 'pdt_123', quantity: 1 }],
  feature_flags: {
    allow_editing_addons: true // customers can edit add-ons at checkout
  },
});

アドオン付きのプラン変更

既存のサブスクリプションを変更して、アドオンを追加、削除、更新します。

// Add add-ons to existing subscription
await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [
    { addon_id: 'addon_123', quantity: 2 }
  ]
});

// Remove all existing add-ons
await client.subscriptions.changePlan('sub_123', {
  product_id: 'pdt_new',
  quantity: 1,
  proration_billing_mode: 'difference_immediately',
  addons: [] // Empty array removes all existing add-ons
});

# Add add-ons to existing subscription
client.subscriptions.change_plan(
    'sub_123',
    product_id='pdt_new',
    quantity=1,
    proration_billing_mode='difference_immediately',
    addons=[
        {'addon_id': 'addon_123', 'quantity': 2}
    ]
)

# Remove all existing add-ons
client.subscriptions.change_plan(
    'sub_123',
    product_id='pdt_new',
    quantity=1,
    proration_billing_mode='difference_immediately',
    addons=[]
)

動的な価格設定

アドオンの選択内容に基づいて合計費用を動的に計算します。

interface AddonSelection {
  price: number;
  quantity: number;
}

function calculateTotalCost(basePrice: number, addons: AddonSelection[]) {
  const addonTotal = addons.reduce((sum, addon) => 
    sum + (addon.price * addon.quantity), 0
  );
  return basePrice + addonTotal;
}

API による管理

Dodo Payments では、アドオンをプログラムから管理するための包括的な API を提供しています。

Create Add-ons

POST /addons エンドポイントを使用して、カスタム価格、説明、設定オプションを指定した新しいアドオンを作成します。

API Reference

アドオンの作成に関する API ドキュメント全体を確認します。

Update Add-ons

PATCH /addons/{id} エンドポイントを使用して既存のアドオンを変更し、価格、説明、税区分を更新します。

API Reference

プログラムからアドオンの詳細を更新する方法を確認します。

List and Retrieve

GET /addons を使用してすべてのアドオンを一覧表示するか、GET /addons/{id} を使用して特定のアドオンの詳細を取得します。

API Reference

一覧表示および取得 API のドキュメント全体を確認します。

Image Management

PUT /addons/{id}/images エンドポイントを使用してアドオンの画像を更新し、商品の見栄えを向上させます。

API Reference

API 経由でアドオンの画像を管理する方法を確認します。

ベストプラクティス

シンプルに始める: 2〜3 個の主要なアドオンから開始し、顧客のフィードバックと利用状況に基づいて選択肢を拡張します。
価格を明確にする: アドオンの価格と価値を明確に伝え、顧客が追加料金で何を得られるのかを理解できるようにします。
十分にテストする: アドオンの組み合わせを検証し、価格計算が正確で、チェックアウトフローがスムーズに機能することを確認します。

設計上の考慮事項

明確な価値提案: 各アドオンには、顧客が理解できる明確なメリットを持たせます
論理的なグループ化: チェックアウトフローで関連するアドオンをまとめます
柔軟な数量: 必要に応じて顧客がアドオンの数量を調整できるようにします
透明性のある価格表示: チェックアウトプロセス全体を通じて合計費用を明確に表示します

Seat-Based Billing

アドオンを使用したシート単位の価格設定の実装ガイドです。

Checkout Sessions

チェックアウトセッション API と設定の全体像です。

Subscriptions

サブスクリプションのライフサイクル、請求サイクル、更新について説明します。

Adaptive Currency

チェックアウト時に現地通貨で価格を表示します。

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Seat-Based Billing

Usage Extensions

アドオンとは？

主なメリット

アドオンの作成

アドオンの設定

はじめに

Dashboard Guide

一般的なユースケース

統合例

アドオン付きチェックアウトセッション

アドオン付きのプラン変更

動的な価格設定

API による管理

API Reference

API Reference

API Reference

API Reference

ベストプラクティス

設計上の考慮事項

関連情報

Seat-Based Billing

Checkout Sessions

Subscriptions

Adaptive Currency

Seat-Based Billing

Usage Extensions

​アドオンとは？

​主なメリット

​アドオンの作成

​アドオンの設定

​はじめに

Dashboard Guide

​一般的なユースケース

​統合例

​アドオン付きチェックアウトセッション

​アドオン付きのプラン変更

​動的な価格設定

​API による管理

API Reference

API Reference

API Reference

API Reference

​ベストプラクティス

​設計上の考慮事項

​関連情報

Seat-Based Billing

Checkout Sessions

Subscriptions

Adaptive Currency

アドオンとは？

主なメリット

アドオンの作成

アドオンの設定

はじめに

一般的なユースケース

統合例

アドオン付きチェックアウトセッション

アドオン付きのプラン変更

動的な価格設定

API による管理

ベストプラクティス

設計上の考慮事項

関連情報