多通貨の顧客
顧客への請求通貨を変更して、複数の通貨を受け付けられるようにします。
Invoicing API を使用して別の通貨で顧客に請求書を発行します。多通貨の顧客機能を使用すると、同一の顧客に対してその顧客のデフォルト通貨として設定された通貨以外の通貨を使用して請求したり、顧客のサブスクリプションの通貨を変更したりできます。通貨の異なる複数のサブスクリプションをアクティブに設定することはできません。
このガイドでは、クレジットノートを作成して、割り当てられているすべての通貨での顧客のクレジット残高を調べる方法も説明しています。この説明ではカナダドル (CAD) を使用しています。
請求書を作成する
顧客に請求書を発行する前に、顧客 id、amount、currency を渡して、請求書アイテムを作成します。顧客を取り違えて追加しないようにするため、請求書アイテムを追加する際は、顧客ごとに処理してください。
インボイスアイテムの最大数は 250 です。インボイスを作成すると、最大 250 の保留中のインボイスアイテムが追加され、残りは次のインボイスに追加されます。顧客の保留中のインボイスアイテムを確認するには、顧客詳細ページをご覧になるか、API を使用してインボイスアイテムのすべてをリスト表示する際に pending 属性を true に設定してください。
注
CAD の請求書は、USD 建てまたは CAD 以外の通貨建ての顧客のクレジット残高を適用しません。また、お客様が顧客に適用した CAD 以外の通貨建ての割引クーポンはすべて無視されます。
複数通貨の請求書を発行する際には currency パラメーターを渡す必要があります。currency パラメーターは、請求書に取り込む請求書アイテムを指定します。たとえば、同じ顧客に対して USD と CAD の 2 つの請求書アイテムを作成した場合、通貨を CAD に設定すると、CAD の請求書アイテムのみが取り込まれます (USD の請求書アイテムは無視されます)。
クレジットノートを作成する
請求書に問題があった場合は、クレジットノートを作成できます。(元の支払い方法に戻すのではなく) 顧客のクレジット残高にクレジットを適用する必要がある場合、Stripe はクレジット金額を CAD 固有のクレジット残高に割り当てます。
クレジット残高を調べる
顧客が各通貨で所有するクレジット金額を確認するには、invoice_ パラメーターを使用します。
顧客のクレジット残高は、次回作成される CAD の請求書から引き落とされます。別の通貨で作成された請求書から引き落とされることはありません。