Skip to content

Add VED (Venezuelan Bolívar Digital) and remove obsolete VEF/VES currency codes #40698

@ginoijewels

Description

@ginoijewels

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

  1. Add VED (Venezuelan Bolívar Digital) to the list of supported
    currencies in Magento.
  2. 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).

Metadata

Metadata

Type

No type

Projects

Status

No status

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions