Working with multiple currencies

Stripe supports processing charges in 135+ currencies. This allows you to present prices in a customer’s native currency and avoid conversion costs for customers.

The currencies you can use are determined by the country of the Stripe account where the charge is made.

Currency conversions

A currency conversion occurs if the presentment currency differs from the settlement currency.

The presentment currency is the currency that’s used for charges. The settlement currency is the currency that you can receive payouts in, depending on the charge type and applicable currency conversion. See the supported presentment currencies and the supported settlement currencies.

Depending on bank account or debit card availability, the following occurs when paying out a balance:

If you regularly charge in multiple currencies, you may be able to establish multiple bank accounts to have multiple settlement currencies.

Currency conversions use the current exchange rates provided by our service providers, with an additional conversion fee applied by Stripe. There are online resources for conversion calculation that can help you estimate current market rates. However, these numbers can fluctuate and may not reflect Stripe’s rates at the time a payment is processed.

Application fees for direct charges

Although direct charges are in the connected account’s default currency, application fees for direct charges are received by the platform in the platform’s default currency.

If your platform doesn’t use application fees and retains a portion of the charges instead, those funds are paid out (and converted or not) the same way as other charges on the platform account.

Application fees for destination charges and converting balances

Application fees collected using the application_fee_amount parameter aren’t converted again for destination charges; your platform always receives application fees in the connected account’s settlement currency. However, we recommend that you use the destination[amount] parameter to transfer less of the charge amount to the connected account.

If you create charges on the platform using the destination or on_behalf_of parameters, you may accumulate balances in multiple currencies. If you do not have bank accounts for these other currencies, Stripe provides a way to pay out balances in non-default currencies to your platform’s default bank account.

These currency conversions are created as manual payouts with currency set as the currency of the source balance:

curl https://api.stripe.com/v1/payouts \
  -u {PLATFORM_SECRET_KEY}: \
  -d amount=1000 \
  -d currency=mzn
curl https://api.stripe.com/v1/payouts \
  -u {PLATFORM_SECRET_KEY}: \
  -d amount=1000 \
  -d currency=mzn

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

Stripe::Payout.create({
  amount: 1000,
  currency: 'mzn',
})
# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

Stripe::Payout.create({
  amount: 1000,
  currency: 'mzn',
})

# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

stripe.Payout.create(
  amount=1000,
  currency='mzn',
)
# Set your secret key. Remember to switch to your live secret key in production!
# See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

stripe.Payout.create(
  amount=1000,
  currency='mzn',
)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

\Stripe\Payout::create([
  'amount' => 1000,
  'currency' => 'mzn',
]);
// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
\Stripe\Stripe::setApiKey('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

\Stripe\Payout::create([
  'amount' => 1000,
  'currency' => 'mzn',
]);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

PayoutCreateParams params =
  PayoutCreateParams.builder()
    .setAmount(1000L)
    .setCurrency("mzn")
    .build();

Payout payout = Payout.create(params);
// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
Stripe.apiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

PayoutCreateParams params =
  PayoutCreateParams.builder()
    .setAmount(1000L)
    .setCurrency("mzn")
    .build();

Payout payout = Payout.create(params);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const payout = await stripe.payouts.create(
  {
    amount: 1000,
    currency: 'mzn',
  }
);
// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
const stripe = require('stripe')('sk_test_4eC39HqLyjWDarjtT1zdp7dc');

const payout = await stripe.payouts.create(
  {
    amount: 1000,
    currency: 'mzn',
  }
);

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

params := &stripe.PayoutParams{
  Amount: stripe.Int64(1000),
  Currency: stripe.String(string(stripe.CurrencyMZN)),
}
po, _ := payout.New(params)
// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
stripe.Key = "sk_test_4eC39HqLyjWDarjtT1zdp7dc"

params := &stripe.PayoutParams{
  Amount: stripe.Int64(1000),
  Currency: stripe.String(string(stripe.CurrencyMZN)),
}
po, _ := payout.New(params)

// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new PayoutCreateOptions
{
  Amount = 1000,
  Currency = "mzn",
};

var service = new PayoutService();
var payout = service.Create(options);
// Set your secret key. Remember to switch to your live secret key in production!
// See your keys here: https://dashboard.stripe.com/account/apikeys
StripeConfiguration.ApiKey = "sk_test_4eC39HqLyjWDarjtT1zdp7dc";

var options = new PayoutCreateOptions
{
  Amount = 1000,
  Currency = "mzn",
};

var service = new PayoutService();
var payout = service.Create(options);

As long as there are sufficient funds in the balance for the specified currency, Stripe automatically converts the funds to the default bank account’s currency.

Example scenarios

The following examples illustrate how to work with multiple currencies in Connect:

Direct charges

Direct charges are always converted to the connected account's default currency from the presentment currency. The application fee is converted to the platform's default currency.

For example, you accept a charge for a connected account in USD. The connected account settles in EUR. The funds sent to the connected account are converted to EUR and the application fee is converted back to your platform in USD from EUR.

Destination charges without on_behalf_of

Destination charges are converted to the platform's default currency from the presentment currency and the funds sent to the connected account are converted again to the connected account’s default currency. If application_fee_amount is used, the application fee remains in the connected account's currency. If transfer_data[amount] is used, the application fee amount remains in the platform's default currency.

For example, you accept a charge for a connected account in USD. The connected account settles in GBP. The funds sent to the connected account are converted to GBP. If application_fee_amount is used, the application fee is converted from USD to GBP. If transfer_data[amount] is used, the application fee is retained in USD from the initial presentment amount, without any intervening conversions.

Destination charges with on_behalf_of

Destination charges are converted to the connected account's default currency from the presentment currency. The application fee remains in the connected account's currency, whether application_fee_amount or transfer_data[amount] is used.

For example, the connected account accepts a charge in USD but settles in EUR. The charge is converted to EUR and sent to the connected account in EUR. The application fee is collected in EUR.

Separate charges and transfers without on_behalf_of

Separate charges are converted to the platform's default currency from the presentment currency and the platform later transfers the funds to the connected account. The application_fee_amount and transfer_data[amount] parameters are not used to collect fees, since the platform can choose the appropriate amount to send at transfer time.

Separate charges and transfers with on_behalf_of

Separate charges are converted to the connected account's default currency from the presentment currency and the platform later transfers the funds to the connected account. The application_fee_amount and transfer_data[amount] parameters are not used to collect fees, since the platform can choose the appropriate amount to send at transfer time.

See also

• Creating Charges
• Creating Direct Charges
• Using Subscriptions