Description
Venezuela has undergone multiple currency redenominations. Magento currently
includes outdated Venezuelan currency codes that are no longer legal tender,
while the current official currency is missing entirely.
Current State in Magento
| Code |
Name |
Status |
| VEF |
Venezuelan Bolívar Fuerte |
❌ Obsolete — discontinued August 2018 |
| VES |
Venezuelan Bolívar Soberano |
❌ Obsolete — discontinued October 2021 |
| VED |
Venezuelan Bolívar Digital |
✅ Current legal currency since October 2021 |
Request
- Add
VED (Venezuelan Bolívar Digital) to the list of supported
currencies in Magento.
- Deprecate or remove
VEF and VES as they are no longer valid
currencies under Venezuelan law.
References
Impact
Merchants operating in Venezuela cannot correctly configure their store
currency. This causes silent failures in shipping carrier integrations and
payment gateways that rely on the current ISO currency code VED, as
Magento resolves exchange rate lookups to 0 when the requested code
does not exist in the system.
Suggested Change
In lib/internal/Magento/Framework/Locale/ or the equivalent currency
data source, update the Venezuelan currency entry:
- Remove:
VEF, VES
- Add:
VED — Venezuelan Bolívar Digital (ISO 4217)
Expected behavior
Magento should include VED (Venezuelan Bolívar Digital) as a supported
currency and remove the obsolete VEF and VES codes, which have not been
legal tender since 2018 and 2021 respectively.
Merchants operating in Venezuela should be able to select VED as their
store currency or configure exchange rates against it, just as they can
with any other current ISO 4217 currency.
Benefits
- Venezuelan merchants can correctly configure their store currency without
workarounds.
- Shipping carrier and payment gateway integrations that rely on the current
ISO code VED will resolve exchange rates correctly instead of silently
returning zero.
- Removes confusion caused by two deprecated currency codes (VEF, VES)
that no longer exist in the Venezuelan financial system.
- Brings Magento into compliance with the current ISO 4217 standard for
Venezuelan currency.
Additional information
Venezuela has redenominated its currency twice since 2008:
- VEF (Bolívar Fuerte): valid until August 20, 2018
- VES (Bolívar Soberano): valid August 2018 – October 1, 2021
- VED (Bolívar Digital): current official currency since October 1, 2021
(1 VED = 1,000,000 VEF)
Official source: Banco Central de Venezuela — https://www.bcv.org.ve
ISO 4217 reference: https://www.iso.org/iso-4217-currency-codes.html
This issue was discovered while integrating a Venezuelan shipping carrier
(Zoom International Services C.A.) with a Magento 2 store. The carrier API
returns prices in VES/VED but Magento only offers VEF in the currency
selector, causing exchange rate lookups to return 0 and breaking shipping
rate calculation at checkout.
Release note
Updated Venezuelan currency support: added VED (Bolívar Digital, current
ISO 4217 code), deprecated VEF and VES (obsolete codes no longer recognized
as legal tender in Venezuela).
Description
Venezuela has undergone multiple currency redenominations. Magento currently
includes outdated Venezuelan currency codes that are no longer legal tender,
while the current official currency is missing entirely.
Current State in Magento
Request
VED(Venezuelan Bolívar Digital) to the list of supportedcurrencies in Magento.
VEFandVESas they are no longer validcurrencies under Venezuelan law.
References
https://www.bcv.org.ve
https://www.iso.org/iso-4217-currency-codes.html
zeroes from VES to create VED. 1 VED = 1,000,000 VEF.
Impact
Merchants operating in Venezuela cannot correctly configure their store
currency. This causes silent failures in shipping carrier integrations and
payment gateways that rely on the current ISO currency code
VED, asMagento resolves exchange rate lookups to
0when the requested codedoes not exist in the system.
Suggested Change
In
lib/internal/Magento/Framework/Locale/or the equivalent currencydata source, update the Venezuelan currency entry:
VEF,VESVED— Venezuelan Bolívar Digital (ISO 4217)Expected behavior
Magento should include VED (Venezuelan Bolívar Digital) as a supported
currency and remove the obsolete VEF and VES codes, which have not been
legal tender since 2018 and 2021 respectively.
Merchants operating in Venezuela should be able to select VED as their
store currency or configure exchange rates against it, just as they can
with any other current ISO 4217 currency.
Benefits
workarounds.
ISO code VED will resolve exchange rates correctly instead of silently
returning zero.
that no longer exist in the Venezuelan financial system.
Venezuelan currency.
Additional information
Venezuela has redenominated its currency twice since 2008:
(1 VED = 1,000,000 VEF)
Official source: Banco Central de Venezuela — https://www.bcv.org.ve
ISO 4217 reference: https://www.iso.org/iso-4217-currency-codes.html
This issue was discovered while integrating a Venezuelan shipping carrier
(Zoom International Services C.A.) with a Magento 2 store. The carrier API
returns prices in VES/VED but Magento only offers VEF in the currency
selector, causing exchange rate lookups to return 0 and breaking shipping
rate calculation at checkout.
Release note
Updated Venezuelan currency support: added VED (Bolívar Digital, current
ISO 4217 code), deprecated VEF and VES (obsolete codes no longer recognized
as legal tender in Venezuela).