多通貨の顧客
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_credit_balance
パラメーターを使用します。
顧客のクレジット残高は、次回作成される CAD の請求書から引き落とされます。別の通貨で作成された請求書から引き落とされることはありません。