Skip to main content

Wallet Multi Currency Changes

Prior to version 1.1, the wallet could only be created in USD currency however we have added support for other currencies. With version 1.1, the currencies wallet supports are now listed in ProductPriceCurrency type.


When any of End User Payment Methods is enabled for your ATS (we asked you when setting up your partner account), the very first time HAPI Elements loads for a given clientId, it needs to create a wallet immediately. With version 1.1, If you want your user to have a wallet in any other currency than USD, you will now need to provide which currency you want the wallet to be created with.


If you want to use any currency other than USD, here are the changes you need to make to have the wallet created:

If you are using Programmatic way of adding the script with POST request:​

If you are using Programmatic way of adding the script with GET request​

  • Add walletCurrency to URLSearchParams (query params) with the currency. Possible values are listed in ProductPriceCurrency type

If you are using HTML way of adding the script​

  • Add walletCurrency to query params in the URL provided to <script> tag's src with the currency. Possible values are listed in ProductPriceCurrency type

Possible errors you might receive​

You provided a walletCurrency and wallet payment method is actually enabled but the currency you provided is not set up​

The widgets you include in your UI will show an error message and an error will be logged to the console. You can check what error you will receive on Demo ATS.

You provided a walletCurrency not supported by VONQ​

The widgets you include in your UI will show an error message and an error will be logged to the console. You can check what error you will receive on Demo ATS.