0Pricing
Stripe Payments & SaaS Billing Systems · レッスン

複数通貨と料金設定への対応

商品やサブスクリプションで複数通貨に対応し、顧客が現地通貨で支払えるようにします。

「複数通貨と料金設定への対応」はCoddyKit上の無料Stripe Payments & SaaS Billing Systemsレッスンです。 これはレッスン1/4です。 下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。 これはStripe Payments & SaaS Billing Systems学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Stripe Payments & SaaS Billing Systemsコースには全4レッスンが含まれています。

このレッスンの一部はまだ翻訳されておらず、英語で表示されています。

Go Global with Multi-Currency

Expanding your business globally often means supporting customers from different countries. A key part of this is offering prices in their local currency.

This makes purchasing more straightforward and builds trust, as customers see prices they understand without needing to calculate conversions.

Stripe's Multi-Currency Support

Stripe is built for global businesses and supports processing payments in over 135 currencies. You have two main ways to handle currencies:

  • Specific Currencies: Define prices directly in a particular currency (e.g., $10 USD or €9 EUR).
  • Dynamic Conversion: Let Stripe convert funds if a customer pays in a currency different from your product's defined currency.

Defining Prices in Specific Currencies

The most common approach is to create separate Price objects for each currency you want to support. This allows you to set precise amounts for each market, accounting for local pricing strategies or exchange rate fluctuations.

Each price will be linked to a product, but will have its own currency and unit_amount.

Creating a Price in EUR

Here's a simplified example of how you might create a Stripe Price object for a 'Basic Plan' specifically in Euros (€). In a real application, you'd use the Stripe API client library.

public class Main {
  public static void main(String[] args) {
    System.out.println("Simulating Stripe Price Creation...");
    String productName = "Basic Plan";
    long amount = 1000; // 10.00 EUR
    String currency = "eur";

    // In a real app, you'd use the Stripe Java client library:
    // PriceCreateParams params = PriceCreateParams.builder()
    //     .setUnitAmount(amount)
    //     .setCurrency(currency)
    //     .setProductData(PriceCreateParams.ProductData.builder()
    //         .setName(productName).build())
    //     .build();
    // Price price = Price.create(params);

    System.out.println("Created price for " + productName);
    System.out.println("Amount: " + (double)amount / 100 + " " + currency.toUpperCase());
    System.out.println("Simulated Price ID: price_123EUR");
  }
}

Understanding `currency_options`

For more advanced scenarios, Stripe allows you to define a single Price object with multiple currency options. This is useful when you want to manage a single 'logical' price but offer different exact amounts per currency.

For example, a 'Premium Plan' might cost $20 USD or €18 EUR, all managed under one price ID.

Price with Multiple Currency Options

This simulated example shows how you might set up a price where the default currency is USD, but you also provide a specific amount for EUR. Notice how currency_options is used.

import java.util.HashMap;
import java.util.Map;

public class Main {
  public static void main(String[] args) {
    System.out.println("Simulating Price with Currency Options...");
    String productName = "Premium Plan";

    // In a real app, use the Stripe Java client library:
    // Map<String, Object> usdOptions = new HashMap<>();
    // usdOptions.put("unit_amount", 2000L); // $20.00 USD

    // Map<String, Object> eurOptions = new HashMap<>();
    // eurOptions.put("unit_amount", 1800L); // €18.00 EUR

    // Map<String, Map<String, Object>> currencyOptions = new HashMap<>();
    // currencyOptions.put("usd", usdOptions);
    // currencyOptions.put("eur", eurOptions);

    // PriceCreateParams params = PriceCreateParams.builder()
    //     .setCurrency("usd") // This is the 'base' currency
    //     .setUnitAmount(2000L) // Base amount
    //     .setProductData(PriceCreateParams.ProductData.builder()
    //         .setName(productName).build())
    //     .putAllCurrencyOptions(currencyOptions)
    //     .build();
    // Price price = Price.create(params);

    System.out.println("Created price for " + productName);
    System.out.println("Default (USD): $20.00");
    System.out.println("Option (EUR): €18.00");
    System.out.println("Simulated Price ID: price_456MULTI");
  }
}

Displaying Multi-Currency Prices

On your website or application, you'll need to present the correct currency option to your users. This often involves:

  • Geolocation: Detecting the user's IP address to infer their country and preferred currency.
  • User Choice: Providing a currency selector dropdown.
  • Browser Settings: Checking the user's browser language or locale settings.

Once selected, you'll use the corresponding Stripe Price ID (or the correct currency option within a Price ID) for the transaction.

Checkout Session in Local Currency

When a customer is ready to pay, you create a Stripe Checkout Session. It's crucial that you use the Price ID that corresponds to the currency the customer has selected or that you've determined for them.

This ensures they are charged the correct amount in their local currency.

public class Main {
  public static void main(String[] args) {
    System.out.println("Simulating Stripe Checkout Session...");
    String selectedPriceId = "price_123EUR"; // From Scene 4
    String successUrl = "https://example.com/success";
    String cancelUrl = "https://example.com/cancel";
    String customerEmail = "customer@example.com";

    // In a real app, use the Stripe Java client library:
    // SessionCreateParams params = SessionCreateParams.builder()
    //     .setMode(SessionCreateParams.Mode.PAYMENT)
    //     .addLineItem(
    //         SessionCreateParams.LineItem.builder()
    //             .setPrice(selectedPriceId)
    //             .setQuantity(1L)
    //             .build())
    //     .setSuccessUrl(successUrl)
    //     .setCancelUrl(cancelUrl)
    //     .setCustomerEmail(customerEmail)
    //     .build();
    // Session session = Session.create(params);

    System.out.println("Creating Checkout Session for Price ID: " + selectedPriceId);
    System.out.println("Customer Email: " + customerEmail);
    System.out.println("Simulated Checkout URL: https://checkout.stripe.com/pay/cs_live_123_abc");
  }
}

Currency Conversion Considerations

Even with multi-currency pricing, you might encounter currency conversions if your payout currency (the currency Stripe sends money to your bank account in) differs from the customer's payment currency.

  • Implicit Conversion: Stripe automatically converts funds at a market rate if needed.
  • Explicit Pricing: Defining prices in local currencies minimizes implicit conversions and offers better control over your revenue.

Be aware of any fees associated with conversions.

Multi-Currency Benefits

Why is it beneficial to offer multi-currency pricing for your products and subscriptions?

Recap: Global Pricing Power

You've learned how to implement multi-currency support in Stripe!

  • We explored creating specific prices per currency.
  • We saw how to use currency_options for flexible pricing.
  • You understand how to integrate these into Checkout Sessions.
  • We touched on currency conversion considerations.

By offering local currency options, you make your service more appealing and accessible to a global audience, paving the way for international growth.

よくある質問

「複数通貨と料金設定への対応」レッスンは無料ですか？

はい。「複数通貨と料金設定への対応」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Stripe Payments & SaaS Billing Systemsコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Stripe Payments & SaaS Billing Systemsコースには全4レッスンが含まれています。

「複数通貨と料金設定への対応」で何を学びますか？

商品やサブスクリプションで複数通貨に対応し、顧客が現地通貨で支払えるようにします。 ブラウザで直接実行するハンズオンコードでStripe Payments & SaaS Billing Systemsを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

Stripe Payments & SaaS Billing Systemsを始めるのに経験は必要ですか？

事前経験は必要ありません。CoddyKitのStripe Payments & SaaS Billing Systemsは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。 これはレッスン1/4です。

「複数通貨と料金設定への対応」レッスンにはどのくらい時間がかかりますか？

ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このStripe Payments & SaaS Billing Systemsレッスンでコードを書いて実行できますか？

はい。すべてのStripe Payments & SaaS Billing Systemsレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

  1. 複数通貨と料金設定への対応
  2. 国際的な決済手段の統合
  3. グローバルコンプライアンスと各地域の規制
  4. 通貨換算、為替リスク、決済
← Stripe Payments & SaaS Billing Systemsに戻る