新機能
1. サブスクリプション支払い再試行
失敗したサブスクリプション更新支払いは、収益を回復するために自動的に再試行できるようになりました。統合作業は不要です。設定→回復から有効にし、回復ウィンドウを設定すると、Dodo Paymentsは賢いスケジュールで更新を再試行し、成功するかウィンドウが閉じるまで行います。
| 設定 | 説明 | デフォルト |
|---|
| 支払い再試行の有効化 | 収益を回復するために失敗したサブスクリプション更新支払いを自動的に再試行します。 | オフ（オプトイン） |
| 回復ウィンドウ（日数） | 失敗した支払いを再試行し続ける期間（1～30日）。 | 13 |
- サブスクリプション更新支払いが失敗し、サブスクリプションが
on_hold に移動します。
- 拒否が再試行可能（不足資金や一時的なネットワークエラーなどのソフト拒否）の場合、次の試行が自動的にスケジュールされます。
- 再試行はオフセッションでバックオフスケジュールで実行され、回復ウィンドウで制限されます。
- 最初の成功した再試行で、サブスクリプションは
active に戻り、次の請求日が通常通り進行します。
再試行スケジュール
再試行は徐々にバックオフし、失敗した請求書が作成された時間に固定されます。8回の試行が行われ、回復ウィンドウ内に収まる限り続きます：
| 試行回数 | 前回からの遅延 |
|---|
| 1 | 12時間 |
| 2 | 24時間 |
| 3 | 48時間 |
| 4 | 72時間 |
| 5 | 96時間 |
| 6 | 120時間 |
| 7 | 7日 |
| 8 | 7日 |
ソフト拒否のみが再試行されます（例：不足資金、一般的な拒否、処理エラーまたはネットワークエラー）。ハード拒否は再試行チェーンをすぐに終了します。再試行しても結果は変わりません。
2. ビジネス比例配分設定
プラン変更時に毎回事前に比例配分パラメーターを渡す代わりに、ビジネスレベルで一括してデフォルトのアップグレードとダウングレードの動作を設定できるようになりました。これらのデフォルトは顧客がカスタマーポータルからプランを変更する際に適用され、製品コレクションごとに上書き可能です。
各方向（アップグレードとダウングレード）は2つの独立したコントロールと共有の支払い失敗ポリシーを持っています：
| 設定 | フィールド | デフォルト（アップグレード） | デフォルト（ダウングレード） |
|---|
| 新プランの開始時期 | effective_at_on_upgrade / effective_at_on_downgrade | immediately | next_billing_date |
| 顧客の課金方法 | proration_billing_mode_on_upgrade / proration_billing_mode_on_downgrade | difference_immediately | difference_immediately |
| 顧客の支払いが失敗した場合 | on_payment_failure | apply_change | apply_change |
effective_at)
| 値 | 挙動 |
|---|
immediately | 顧客はすぐに新プランに移ります。 |
next_billing_date | 顧客は次の請求日まで現在のプランに留まり、その後新プランに切り替わります。 |
proration_billing_mode)
| 値 | 挙動 |
|---|
prorated_immediately | 現在の請求サイクルに残っている時間に基づいて、今すぐ比例配分価格を課金します。 |
full_immediately | 新プランの全額を今すぐ課金します。 |
difference_immediately | 新プランと現在のプランの価格差のみを課金します。 |
do_not_bill | 今は何も課金しません。次の請求書で調整が適用されます。 |
on_payment_failure)
| 値 | 挙動 |
|---|
prevent_change | 支払いが通らなかった場合、顧客を現在のプランに留まらせます。 |
apply_change | 支払いが通らなかった場合でも、新しいプランに顧客を移動します。その額を後で回収できます。 |
per-request value (Change Plan API) → collection field (if set) → business field → system default
プラン変更API に渡される各要求値 (proration_billing_mode, effective_at, on_payment_failure) は、常にコレクションおよびビジネスデフォルトより優先されます。新しい設定は、明示的な値が提供されていない場合にのみ適用されます — これはすべてのカスタマーポータルプラン変更に該当します。 3. B2B請求書のためのビジネス名収集
B2B顧客は、購入者の個人名の代わりに法的なビジネス名を請求書に表示できるようになりました。チェックアウト時に有効な税IDが提供される場合は、関連する customer_business_name を収集し、請求書に購入団体を反映させることもできます。
顧客がチェックアウトでビジネスとして購入を選択すると、ビジネス名と税ID番号の入力を促されます。
ビジネス名が請求書に表示されるのは、3つの条件がすべて満たされた場合のみです：
- トランザクションがB2Bであること (
b2b = true)
tax_id が存在すること- 非空の
customer_business_name が提供されること
その他の場合は、顧客の個人名が使用されます。
チェックアウトでの収集
customer_business_name を直接設定、または税IDと共に顧客がチェックアウトページで入力または編集できるよう、allow_customer_editing_business_name を有効にします：
const session = await client.checkoutSessions.create({
product_cart: [{ product_id: 'prod_abc', quantity: 1 }],
customer: { email: 'buyer@acme.com' },
tax_id: 'GB123456789',
customer_business_name: 'Acme Corp Ltd',
feature_flags: {
allow_tax_id: true,
allow_customer_editing_business_name: true // let the customer enter/edit it
},
return_url: 'https://yoursite.com/return'
});
| 表面 | フィールド | ノート |
|---|
| チェックアウトセッション | customer_business_name, feature_flags.allow_customer_editing_business_name | 最大250文字、フラグはデフォルトで false |
| 支払い | customer_business_name | 最大250文字 |
| サブスクリプション | customer_business_name | PATCH /subscriptions/{id} 経由で設定またはクリア |
customer_business_name は、tax_id なしでは設定できません。税IDなしでビジネス名を送信することは拒否されます。tax_id をクリアするとビジネス名もクリアされます。両者は請求書上で結合されているためです。
周囲の空白はトリムされ、空白のみの値は明示的なクリアと扱われます。保存されたデータは常に請求書に表示されるものと一致します。
バグ修正と改善
- プラットフォーム全体でのマイナーなバグ修正と安定性の向上。
