# 多通貨の顧客

顧客への請求通貨を変更して、複数の通貨を受け付けられるようにします。

複数の通貨で販売する必要があるが、それぞれの顧客ごとに 1 つの通貨を使用させる必要がある場合は、[多通貨の価格](https://docs.stripe.com/products-prices/how-products-and-prices-work.md#multiple-currencies)をご覧ください。

Invoicing API を使用して別の通貨で顧客に請求書を発行します。多通貨の顧客機能を使用すると、同一の*顧客* (Customer objects represent customers of your business. They let you reuse payment methods and give you the ability to track multiple payments)に対してその顧客のデフォルト通貨として設定された通貨以外の通貨を使用して請求したり、顧客のサブスクリプションの通貨を変更したりできます。通貨の異なる複数のサブスクリプションをアクティブに設定することはできません。

このガイドでは、クレジットノートを作成して、割り当てられているすべての通貨での顧客のクレジット残高を調べる方法も説明しています。この説明ではカナダドル (CAD) を使用しています。

## 請求書を作成する

顧客に請求書を発行する前に、顧客 `id`、`amount`、`currency` を渡して、請求書アイテムを作成します。顧客を取り違えて追加しないようにするため、請求書アイテムを追加する際は、顧客ごとに処理してください。

インボイスアイテムの最大数は 250 です。インボイスを作成すると、最大 250 の保留中のインボイスアイテムが追加され、残りは次のインボイスに追加されます。顧客の保留中のインボイスアイテムを確認するには、**顧客詳細**ページをご覧になるか、API を使用してインボイスアイテムのすべてをリスト表示する際に [pending](https://docs.stripe.com/api/invoiceitems/list.md#list_invoiceitems-pending) 属性を `true` に設定してください。

> CAD の請求書は、USD 建てまたは CAD 以外の通貨建ての顧客のクレジット残高を適用しません。また、お客様が顧客に適用した CAD 以外の通貨建ての割引クーポンはすべて無視されます。

```curl
curl https://api.stripe.com/v1/invoiceitems \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d customer="{{CUSTOMER_ID}}" \
  -d amount=1000 \
  -d currency=cad
```

複数通貨の請求書を発行する際には `currency` パラメーターを渡す必要があります。`currency` パラメーターは、請求書に取り込む請求書アイテムを指定します。たとえば、同じ顧客に対して USD と CAD の 2 つの請求書アイテムを作成した場合、通貨を CAD に設定すると、CAD の請求書アイテムのみが取り込まれます (USD の請求書アイテムは無視されます)。

```curl
curl https://api.stripe.com/v1/invoices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d customer="{{CUSTOMER_ID}}" \
  -d collection_method=send_invoice \
  -d days_until_due=30 \
  -d pending_invoice_items_behavior=include \
  -d currency=cad
```

## クレジットノートを作成する

請求書に問題があった場合は、クレジットノートを作成できます。(元の支払い方法に戻すのではなく) 顧客のクレジット残高にクレジットを適用する必要がある場合、Stripe はクレジット金額を CAD 固有のクレジット残高に割り当てます。

```curl
curl https://api.stripe.com/v1/credit_notes \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d invoice={{INVOICE_ID}} \
  -d reason=duplicate \
  -d amount=1000 \
  -d credit_amount=1000
```

## クレジット残高を調べる

顧客が各通貨で所有するクレジット金額を確認するには、`invoice_credit_balance` パラメーターを使用します。

```curl
curl -G https://api.stripe.com/v1/customers/{{CUSTOMER_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "expand[]"=invoice_credit_balance
```

顧客のクレジット残高は、次回作成される CAD の請求書から引き落とされます。別の通貨で作成された請求書から引き落とされることはありません。

## See also

- [Invoicing API と連携する](https://docs.stripe.com/invoicing/integration.md)
- [顧客を管理する](https://docs.stripe.com/invoicing/customer.md)
- [商品および価格](https://docs.stripe.com/invoicing/products-prices.md)