サブスクリプションをダウングレードまたはキャンセル後に利用者にクレジット残高を返金する

サブスクリプションがアップグレードされると、Stripe は比例配分を適用した請求金額を自動的に計算します。たとえば、請求サイクルの半ばで月額 $10.00 から月額 $100.00 のサブスクリプションに変更した場合、最初の価格に対して $5.00 のクレジットが支払われ、新しい価格に対して $50.00 が請求されます。つまり、利用者はサブスクリプションのアップグレードについて計 $45.00 を請求されます。この金額は請求サイクルの最後、またはインボイスを作成後即時に請求されます。

サブスクリプションがダウングレードまたはキャンセルされると、利用者にはクレジットが支払われます。請求サイクルの半ばで月額 $100.00 から月額 $10.00 のサブスクリプションに変更した場合、最初の価格に対して $50.00 のクレジットが支払われ、新しい価格に対して $5.00 が請求されます。サブスクリプションをダウングレードすると、利用者に計 $45.00 のクレジットがクレジット残高に加えられ、今後のインボイスに適用されます。

そのクレジットの金額を元の決済方法に直接返金したいと考える加盟店もいますが、最近ではその返金が自動的に行われることはありません。ただし、加盟店側で実行することは可能です。

利用者のクレジット残高を返金

クレジット残高や保留中のインボイスアイテムの合計を取得する
List Invoices API を使用して、subscription パラメーターにサブスクリプション ID を渡し、そのサブスクリプション ID のみのインボイスを表示する
関連する支払いを展開する必要がある

次に、各インボイスについて以下を実行する

関連する支払いを特定する
利用者のクレジット残高までの金額に設定した返金を作成する
支払い金額が利用者のクレジット残高より少ない場合は、支払い金額の全額を返金した後、利用者のクレジット残高から支払い金額の全額を引くことにより、返金する残りの残高を算出する。例: 利用者のクレジット残高が $100 で、直近のサブスクリプション支払い金額が $40 である場合、返金する残りのクレジット残高は $60 となります。
すべてのクレジットが返金されるまで、リストのインボイスを処理する
API を使用して保留中のインボイスアイテムを削除したり、ダッシュボードから直接残高を修正したりして、利用者のアカウント残高を $0.00 に更新する