Bill for items in Vietnamese Dong

What's new?

We added Vietnamese Dong as a supported currency for payments.

How it works

Vietnam is a rapidly growing economy, known for its young population and expanding middle class. The primary currency is the Vietnamese Dong (VND).

You can now create prices, discounts, transactions, and subscriptions in Vietnamese Dong, letting you charge customers in Vietnam in their local currency. Offering prices in local currencies builds trust by helping customers understand how much they're being charged, means they're less likely to be charged FX fees, and improves payment acceptance rates.

Automatic localization

While VND is available as a platform currency, Paddle Checkout doesn't automatically localize prices in Vietnam to Vietnamese Dong when automatic currency conversion is enabled. This gives us time to monitor acceptance rates.

Checkouts opened in Vietnam present prices in US Dollar (USD), unless you've created a price override for Vietnam for a price.

To use Vietnamese Dong, set VND as the value for currency_code when creating or updating a transaction.

Summary of changes

VND is now a valid allowed value for currency_code when working with payment currencies in the Paddle API, including:

• price.unit_price.currency_code
• price.unit_price_overrides.unit_price.currency_code
• discount.currency_code
• transaction.currency_code
• subscription.currency_code
• pricing_preview.currency_code

You may see it in responses from the Paddle API as a payment currency, too.

VND is not a valid currency code for manually-collected transactions or subscriptions, payouts, chargeback fees, or your balance currency.

Next steps

This change is available in version 1 of the Paddle API.

It's a non-breaking change, meaning it doesn't impact existing integrations.

Check the API documentation to work with prices, subscriptions, and transactions.

Learn more