# 手動による通貨の価格

手動による通貨の価格を使用して顧客に現地通貨を表示します。

# 完全ホスト型ページ

> This is a 完全ホスト型ページ for when payment-ui is stripe-hosted. View the full page at https://docs.stripe.com/payments/checkout/localize-prices/manual-currency-prices?payment-ui=stripe-hosted.

Stripe では、[商品](https://docs.stripe.com/products-prices/overview.md#get-started)を作成するときに、複数の通貨で価格を手動で定義できます。ただし Stripe は、手動による通貨価格ではなく、[Adaptive Pricing](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md) の使用を推奨しています。本機能は、為替レートの変動リスクを軽減し、100 を超える現地通貨のサポートを自動で有効化します。

以下の場合、Adaptive Pricing ではなく手動による通貨価格をお使いください。

- Adaptive Pricing はビジネスまたは決済構成で[サポートされ](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md#restrictions)ていません。
- 通貨の為替レート変動が許容範囲内である地域に対応しています。

手動で定義された多通貨の価格は、Adaptive Pricing が有効な場合も、その通貨の適応型価格を上書きします。

> #### 地域に合わせた料金設定
> 
> API を使って[請求書の項目を作成](https://docs.stripe.com/api/invoiceitems/create.md)するか、請求を行う場合、Stripe は明示的に指定された金額と通貨を処理します。ローカライズされた価格は自動的に計算されないため、顧客のリージョンに合った正しい金額と通貨を渡す必要があります。価格 ID を渡すには、[pricing.price](https://docs.stripe.com/api/invoiceitems/create.md#create_invoiceitem-pricing-price) パラメーターの使用を推奨します。

## 多通貨の価格を作成する [ダッシュボード] [サーバー側]

#### ダッシュボード

1. [ダッシュボード](https://dashboard.stripe.com/products?active=true) で商品に移動します。
1. **+ 別の価格を追加**をクリックして、新しい価格を作成します。
1. 価格を入力し、通貨を選択します。第一通貨は、価格のデフォルトの通貨になります。すべての価格に同じデフォルト通貨が設定されていることを確認してください。
1. **+ 通貨別の価格を追加**をクリックして、サポートされている通貨の中から希望の通貨を選択し、価格にその通貨を追加します。
1. Checkout セッションの作成時に、[項目](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items-price)に価格 ID を渡して作成した多通貨価格を使用します。

#### API

[Prices API](https://docs.stripe.com/api/prices/object.md#price_object-currency_options) を使用する際に `currency_options` を指定して、Price に複数の通貨を追加します。

```curl
curl https://api.stripe.com/v1/prices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d currency=usd \
  -d unit_amount=1000 \
  -d "currency_options[eur][unit_amount]=950" \
  -d "currency_options[jpy][unit_amount]=1500" \
  -d "product_data[name]=My Product"
```

この例では、価格は USD で作成され、EUR と JPY の通貨オプションが追加されています。

## Checkout セッションを作成する [サーバー側]

多通貨の価格を使用して Checkout セッションを作成します。

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "line_items[0][price]={{PRICE_ID}}" \
  -d "line_items[0][quantity]=1" \
  -d mode=payment \
  --data-urlencode "success_url=https://example.com/success"
```

## テストする [サーバー側] [クライアント側]

Checkout、Payment Links、[料金表](https://docs.stripe.com/payments/checkout/pricing-table.md)で現地通貨での表示をテストするには、メールアドレスのローカル部分に `+location_XX` 形式のサフィックスを含めて、地域に応じた形式の顧客メールアドレスを渡します。`XX` は有効な [2 桁の ISO 国コード](https://www.nationsonline.org/oneworld/country_code_list.htm)にする必要があります。

たとえば、フランスで顧客への通貨の表示をテストする場合は、`test+location_FR@example.com` などのメールアドレスを渡します。

Checkout セッション、Payment Links、または地域に応じた形式のメールアドレスで作成された料金表にアクセスすると、指定された国の顧客への表示と同じ通貨が表示されます。

### Checkout をテストする

特定の国から Checkout のシミュレーションを行うため、Checkout セッションの作成時に [customer_email](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_email) として地域に応じた形式でメールアドレスを渡します。

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u <<YOUR_SECRET_KEY>>: \
  -d "line_items[0][price]"="{{PRICE_ID}}" \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d success_url="https://example.com/success" \
  --data-urlencode customer_email="test+location_FR@example.com"
```

新しい顧客を作成し、それら用に `+location_XX` サフィックスを含むメールアドレスを指定することもできます。Stripe テストカードは通常どおり機能します。

Checkout で顧客の現地通貨を表示できるようになると、[Checkout Session (Checkout セッション)](https://docs.stripe.com/api/checkout/sessions/object.md) オブジェクトが変わります。`currency`、`payment_method_types`、`amount_total` などのフィールドに現地の通貨と価格が反映されます。

### Payment Links をテストする

Payment Links の場合、`prefilled_email` [URL パラメーター](https://docs.stripe.com/payment-links/customize.md#customize-checkout-with-url-parameters)として地域に応じた形式のメールアドレスを渡して、さまざまな国の顧客に対する通貨表示をテストします。

### 料金表をテストする

料金表の場合は、[customer-email](https://docs.stripe.com/payments/checkout/pricing-table.md#customer-email) 属性として地域に応じた形式のメールアドレスを渡して、さまざまな国の顧客への通貨の表示をテストします。

## Optional: 通貨を指定する [サーバー側]

セッションで多通貨の価格を使用すると、Checkout は顧客に応じて現地通貨への換算を自動的に処理します。ただし、この動作は、Checkout セッションの作成時に通貨を指定することで上書きできます。

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d currency=eur \
  -d "line_items[0][price]={{PRICE_ID}}" \
  -d "line_items[0][quantity]=1" \
  -d mode=payment \
  --data-urlencode "success_url=https://example.com/success"
```

この例では、顧客の所在地に関係なく Checkout セッションの通貨が常に EUR (`eur`) になります。

## 地域固有の決済手段

Checkout セッションでは、現地通貨に対応している主要な決済手段が顧客に提示されます。たとえば、オランダ在住の顧客の場合、Checkout セッションは価格を EUR に変換し、iDEAL などオランダで人気の決済手段も提示します。

受け付ける支払い方法は[支払い方法の設定](https://dashboard.stripe.com/settings/payment_methods)で設定できます。

## 料金表

手動による通貨の価格は[料金表](https://docs.stripe.com/payments/checkout/pricing-table.md)でも使用できます。料金表を表示する顧客に現地通貨を表示するには、料金表のすべての価格の `currency_options` に顧客の現地通貨を含める必要があります。また、Stripe Tax を使用している場合は、当該通貨の `tax_behavior` も含める必要があります。

## サポートされているシステム

以下のすべてに該当する場合、Checkout では現地通貨が自動的に顧客に表示されます。

- Checkout セッションの価格、配送料、割引の `currency_options` に関連通貨が指定されている。
- Checkout セッションの価格にアップセルが設定されている場合に、アップセルの価格の `currency_options` に関連通貨が指定されている。
- Stripe Tax を使用する Checkout セッションで、Checkout セッションの価格、配送料、割引のすべての関連通貨に `tax_behavior` が指定されている。
- Checkout セッションの作成時に通貨を指定していない。

関連通貨オプションまたは `tax_behavior` が不足しているために Checkout で通貨を現地通貨に換算できない場合、顧客のセッションにはデフォルトの通貨が表示されます。デフォルトの通貨は、すべての価格、配送料、割引で同じである必要があります。

### 制限

以下の場合、Checkout セッションの価格の現地通貨への換算は使用できません。

- 手動の税率を使用している場合。
- `payment_intent_data.application_fee_amount` または `payment_intent_data.transfer_data.amount` を使用している場合。

## 手数料

自動換算が行われる取引には、Stripe の標準取引手数料が適用されます。

- カードまたは支払い方法の手数料
- 国際的なカードまたは支払い方法の手数料 (該当する場合)
- 両替手数料

これらの手数料の詳細については、[料金体系ページ](https://stripe.com/pricing)をご覧ください。


# 完全埋め込みページ

> This is a 完全埋め込みページ for when payment-ui is embedded-page. View the full page at https://docs.stripe.com/payments/checkout/localize-prices/manual-currency-prices?payment-ui=embedded-page.

Stripe では、[商品](https://docs.stripe.com/products-prices/overview.md#get-started)を作成するときに、複数の通貨で価格を手動で定義できます。ただし Stripe は、手動による通貨価格ではなく、[Adaptive Pricing](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md) の使用を推奨しています。本機能は、為替レートの変動リスクを軽減し、100 を超える現地通貨のサポートを自動で有効化します。

以下の場合、Adaptive Pricing ではなく手動による通貨価格をお使いください。

- Adaptive Pricing は、お客様のビジネスまたは Checkout の設定では[サポート対象外](https://docs.stripe.com/payments/currencies/localize-prices/adaptive-pricing.md#restrictions)です。プレビューへの参加については、[adaptive-pricing-beta@stripe.com](mailto:adaptive-pricing-beta@stripe.com) にお問い合わせください。
- 通貨の為替レート変動が許容範囲内である地域に対応しています。

手動で定義された多通貨の価格は、Adaptive Pricing が有効な場合も、その通貨の適応型価格を上書きします。

> #### 地域に合わせた料金設定
> 
> API を使って[請求書の項目を作成](https://docs.stripe.com/api/invoiceitems/create.md)するか、請求を行う場合、Stripe は明示的に指定された金額と通貨を処理します。ローカライズされた価格は自動的に計算されないため、顧客のリージョンに合った正しい金額と通貨を渡す必要があります。価格 ID を渡すには、[pricing.price](https://docs.stripe.com/api/invoiceitems/create.md#create_invoiceitem-pricing-price) パラメーターの使用を推奨します。

## 多通貨の価格を作成する [ダッシュボード] [サーバー側]

#### ダッシュボード

1. [ダッシュボード](https://dashboard.stripe.com/products?active=true) で商品に移動します。
1. **+ 別の価格を追加**をクリックして、新しい価格を作成します。
1. 価格を入力し、通貨を選択します。第一通貨は、価格のデフォルトの通貨になります。すべての価格に同じデフォルト通貨が設定されていることを確認してください。
1. **+ 通貨別の価格を追加**をクリックして、サポートされている通貨の中から希望の通貨を選択し、価格にその通貨を追加します。
1. Checkout セッションの作成時に、[項目](https://docs.stripe.com/api/checkout/sessions/create.md#create_checkout_session-line_items-price)に価格 ID を渡して作成した多通貨価格を使用します。

#### API

[Prices API](https://docs.stripe.com/api/prices/object.md#price_object-currency_options) を使用する際に `currency_options` を指定して、Price に複数の通貨を追加します。

```curl
curl https://api.stripe.com/v1/prices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d currency=usd \
  -d unit_amount=1000 \
  -d "currency_options[eur][unit_amount]=950" \
  -d "currency_options[jpy][unit_amount]=1500" \
  -d "product_data[name]=My Product"
```

この例では、価格は USD で作成され、EUR と JPY の通貨オプションが追加されています。

## Checkout セッションを作成する [サーバー側]

多通貨の価格を使用して Checkout セッションを作成します。

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "line_items[0][price]={{PRICE_ID}}" \
  -d "line_items[0][quantity]=1" \
  -d mode=payment \
  -d ui_mode=embedded_page \
  --data-urlencode "return_url=https://example.com/return"
```

## テストする [サーバー側] [クライアント側]

現地の通貨の提示をテストするには、メールアドレスの現地の部分に `+location_XX` 形式のサフィックスを含めた、地域に応じた形式の顧客メールアドレスを渡します。`XX` は有効な [2 文字の ISO 国コード](https://www.nationsonline.org/oneworld/country_code_list.htm)である必要があります。

たとえば、フランスの顧客に対する通貨の提示をテストするには、`test+location_FR@example.com` などのメールアドレスを渡します。地域に応じた形式のメールアドレスで作成された Checkout セッションの URL にアクセスすると、指定した国で顧客に表示されるのと同じ通貨が表示されます。

Checkout セッションの作成時に、地域に応じた形式のメールアドレスを [customer_email](https://docs.stripe.com/api/checkout/sessions/object.md#checkout_session_object-customer_email) として渡して、特定の国をシミュレーションします。

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u <<YOUR_SECRET_KEY>>: \
  -d "line_items[0][price]"="{{PRICE_ID}}" \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d ui_mode=embedded_page \
  -d return_url="https://example.com/return" \
  --data-urlencode customer_email="test+location_FR@example.com"
```

新しい顧客を作成し、それら用に `+location_XX` サフィックスを含むメールアドレスを指定することもできます。Stripe テストカードは通常どおり機能します。

顧客の現地通貨を提示できるようになると、[Checkout Session](https://docs.stripe.com/api/checkout/sessions/object.md) オブジェクトが変化します。`currency`、`payment_method_types`、`amount_total` などのフィールドには、現地の通貨と料金が反映されます。

## Optional: 通貨を指定する [サーバー側]

多通貨の価格を使用する場合、Checkout セッションは顧客の通貨を地域に合わせて自動的に変換します。ただし、Checkout セッションの作成時に通貨を指定すると、この動作を上書きできます。

```curl
curl https://api.stripe.com/v1/checkout/sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d currency=eur \
  -d "line_items[0][price]={{PRICE_ID}}" \
  -d "line_items[0][quantity]=1" \
  -d mode=payment \
  -d ui_mode=embedded_page \
  --data-urlencode "return_url=https://example.com/return"
```

この例では、顧客の所在地に関係なく Checkout セッションの通貨が常に EUR (`eur`) になります。

## 地域固有の決済手段

Checkout セッションでは、現地通貨に対応している主要な決済手段が顧客に提示されます。たとえば、オランダ在住の顧客の場合、Checkout セッションは価格を EUR に変換し、iDEAL などオランダで人気の決済手段も提示します。

受け付ける支払い方法は[支払い方法の設定](https://dashboard.stripe.com/settings/payment_methods)で設定できます。

## サポートされているシステム

以下のすべてに該当する場合、Checkout では現地通貨が自動的に顧客に表示されます。

- Checkout セッションの価格、配送料、割引の `currency_options` に関連通貨が指定されている。
- Checkout セッションの価格にアップセルが設定されている場合に、アップセルの価格の `currency_options` に関連通貨が指定されている。
- Stripe Tax を使用する Checkout セッションで、Checkout セッションの価格、配送料、割引のすべての関連通貨に `tax_behavior` が指定されている。
- Checkout セッションの作成時に通貨を指定していない。

関連通貨オプションまたは `tax_behavior` が不足しているために Checkout で通貨を現地通貨に換算できない場合、顧客のセッションにはデフォルトの通貨が表示されます。デフォルトの通貨は、すべての価格、配送料、割引で同じである必要があります。

### 制限

以下の場合、Checkout セッションの価格の現地通貨への換算は使用できません。

- 手動の税率を使用している場合。
- `payment_intent_data.application_fee_amount` または `payment_intent_data.transfer_data.amount` を使用している場合。

## 手数料

自動換算が行われる取引には、Stripe の標準取引手数料が適用されます。

- カードまたは支払い方法の手数料
- 国際的なカードまたは支払い方法の手数料 (該当する場合)
- 両替手数料

これらの手数料の詳細については、[料金体系ページ](https://stripe.com/pricing)をご覧ください。