This plugin adds capability for CHIP for WooCommerce to convert total amount made in any currency to Malaysian Ringgit (MYR).
Currently, the plugin has been integrated with Bank Negara Malaysia (BNM) and Open Exchange Rate (OER) to automate the currency conversion process. The default provider is BNM API. Please do write to us if you need to integrate with other providers.
However, you may opt to define your own conversion rate instead of using the automated currency exchange rate.
By default, the plugin will work as-is upon activation. However, you may tweak the configuration to fit your business needs. The configuration is available in WooCommerce → Settings → General → CHIP Convert Currency API Options.
All configuration is managed through the WooCommerce settings page.
By default, the plugin is set to fetch the information from Bank Negara Malaysia API. However, you may change to your preferred providers if any.
| Setting | Description |
|---|---|
| API Options | Choose between BNM (default), Open Exchange Rate API, or Fixed Rate. |
| Open Exchange Rate API Key | Required only if you select OER as the provider. |
| Fixed Exchange Rate | Enter your own rate. Used only when "Fixed Rate" is selected. |
Since the conversion of currency will require conversion back to the merchant's home currency, you may specify an additional charge for the currency conversion. This is an important configuration since merchants who report in USD but receive in MYR will need to convert it back to USD.
The charge calculations are added after conversion is done.
| Setting | Description |
|---|---|
| Percentage Charge | Percentage added after conversion (e.g., 5 = 5%). |
| Fixed Charge (cent in MYR) | Fixed amount in cents added after conversion. |
Kindly note that different providers do support different currencies. You need to check if the currencies that you are using are supported by the providers you choose. You are safe to ignore the list if you choose to define your own conversion rate.
JPY, AED, AUD, BND, CAD, CHF, CNY, EGP, EUR, GBP, HKD, IDR, INR, KHR, KRW, MMK, NPR, NZD, PHP, PKR, SAR, SGD, THB, TWD, USD, VND, SDR
AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL, BSD, BTC, BTN, BWP, BYN, BZD, CAD, CDF, CHF, CLF, CLP, CNH, CNY, COP, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GGP, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, IMP, INR, IQD, IRR, ISK, JEP, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SSP, STD, STN, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, UYU, UZS, VES, VND, VUV, WST, XAF, XAG, XAU, XCD, XDR, XOF, XPD, XPF, XPT, YER, ZAR, ZMW, ZWL
By default, the currency conversion rate is cached and will only be retrieved every 30 minutes. You may override this behavior by adding the filter wc_chip_currency_provider_refresh_minutes. Example code will change the interval to every hour.
add_filter('wc_chip_currency_provider_refresh_minutes', function($minutes){ return 60 });If the plugin fails to retrieve the conversion rate from the API provider, the Checkout is expected to error, thus preventing the buyer from making payment. This is by design to ensure the order amount is not miscalculated and the buyer does not pay the wrong amount for an order.
Important: This plugin disables automatic refunds for all orders processed through CHIP gateways. Because the order total is converted from the original currency to MYR, refunding the original amount would result in an incorrect refund value. Refunds must be handled manually through your CHIP merchant dashboard.
This plugin is provided absolutely for free, without any warranty. You are expected to do your own due-diligence and use on production at your own risk. Refer to GNU General Public License v3.0.