Docs

Bill for items in Vietnamese Dong

Create prices, discounts, transactions, and subscriptions in Vietnamese Dong.

Tooling

  • Platform

Released

November 25, 2024

Status

Released

API version

Version 1

What's new?

We added Vietnamese Dong as a supported currency for payments.

currency_code string

Supported three-letter ISO 4217 currency code

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.

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.

Summary of changes

Entity Field Change Type
currency_code VND + Added Enum value
Vietnamese Dong added as a supported payment currency.

Was this page helpful?