Convert any currency to allowed PayPal currencies for PayPal’s Payment Gateway “PayPal Standard” within WooCommerce

**Attention: before you make a purchase, please make sure your WordPress and WooCommerce Versions are supported!
This plugin is for WooCommerce shops with a shop currency not in this list: “AUD, BRL, CAD, CZK, DKK, EUR, HKD, HUF, ILS, JPY, MYR, MXN, NOK, NZD, PHP, PLN, GBP, SGD, SEK, CHF, TWD, THB, USD”, or want to convert into a different PayPal currency to avoid conversion fees by PayPal.Or simply want to forward PayPal fees to your customer.

FEATURES

  • Convert any given WooCommerce shop currency to allowed PayPal currencies for PayPal’s Payment Gateway “PayPal Standard” within WooCommerce on checkout.
  • Supports customized version of:
  • Converts Shopping cart total.
  • Converts Tax
  • Converts shipping costsImportant Note for versions 3.2.1 or older: shippment does not appear correct in the Payment description on checkout, but only when shippment is based on country and is changed on checkout. Is fixed in the version 3.3.
  • Converts handling fees
  • Custom Currency setup available
  • Show the Cart Total, Shipping Total, Handling fee, Order Total Tax, Order Total inclusive Tax, and Conversion Rate in PayPal related payment gateways descriptions
  • Allows setting of additional handling fees on fixed or percentage base.
  • Automatically update the currency exchange rate between your shop currency and the desired PayPal currency with WP-crontrol (or any other cron plugin), your hosting servers cron job, or a 3rd party cron job service.
  • Actual Currency Exchange Rates will be retrieved from “Open Exchange Rates API”, Xignite, Currency Converter API, Apilayer API, or European Central Bank.
  • Display of Google’s exchange rates history chart of the last 5 years for information purpose.
  • Have your virtual product orders automatically completed after checkout!
  • Have your non virtual product orders automatically completed after checkout!
  • Have your standard product orders automatically processed after checkout!
  • Add a note to the order email adding information about currency exchange rate and converted order total.
  • Optionally supress Order OnHold Emails.
  • Sends notification email to the admin’s email address when the exchange rate has been updated.
  • Logs the actions into a log file.
  • Tool-tip help on every item.
  • Translation Ready
  • Easy to Setup
  • Gives warning for unsupported php.ini settings.
  • Detailed Documentation Included
  • Subscriptions (support only for “WooCoommerce Subscriptions”)

MANDATORY SETTINGS

  1. Find the settings page in WooCommerce’s sub menu.
  2. First time only: Select your target Currency
  3. Save your settings.
  4. Go to the 2nd tab and choose your favorite exchange rate provider, register a valid API ID and activate it with the radio button.
  5. Save your settings.
  6. Accept the suggested exchange rate shown in the button.
  7. Save your settings.

OPTIONAL SETTINGS

EXCHANGE RATE PROVIDER SELECTION

Go to the 2nd tab and choose your favorite exchange rate provider other than the preselected one.Recommended: register a valid API ID and activate it with the radio button.

CUSTOM CURRENCY

If you need a custom currency,check the check-box “Use Custom Currency” on top of the 1st tab, then you will see 3 new text input fields called Code, Symbol, and Name. Fill this out with the appropriate settings. For example: Code=”XOF”, Symbol=”XOF”, Name= “CFA Franc”Save your settings and navigate to WooCommerce’s settings page where you should find your new custom currency. Select it and save your settings. Navigate back to PayPal Currency Converter Pro settings page to check if everything is set.

HANDLING FEES

You can set a fixed amount and a calculated fee based on a percentage. You can decide if the handling fee should be taxed or not, and you can decide if the percentage calculation should as well be calculated including the shipping total. Furthermore you may name your handling fee resp. how it is shown in your order details. As soon as the amount or percentage is greater than zero, it will be added and as a part of the order total be converted as well. So you can forward the PayPal charge to your customer.

ORDER AUTO COMPLETION

This settings are on by default. Override PayPal’s Validation error on “amount comparison” or “PayPal currencies do not match”. Orders for virtual (downloadable) products will be completed when checked! Non virtual product orders will be set to processing and stock will be reduced.

AUTOMATIC EXR UPDATES

For automatic updates you have three options. One option is to use a suitable Cron-Job plugin like “WP-Crontrol” and register the hook “ppcc_cexr_update” for your desired update frequency. Another option is to call the given AJAX url (http://yourdomain.com/wp-admin/admin-ajax.php?action=ppcc&ppcc_function=cexr_update) from your hosting servers cron job or an online cron job service like EASYCRON.COM for a hassle free solution. (This ensures an accurate timing for the upates.)

LOG / EMAIL NOTIFICATION

If the checkbox “log” is checked an email notification will be sent to the admin’s email address every time the exchange rate is updated with date, time, and exchange rate value. Furthermore the log file will be populated with every action the plugin does. The log file can be found and viewed in the indicated location while using your FTP client. For additional convenience you can open the log-file in a pop up window. To make this work add: “Allow from ” to the .htaccess file inside ”../plugins/woocommerce/logs/”

How can I show the converted total, tax, and conversion rate on the checkout page?

Sample payment description content: <br /> Cart Total: <br /><br /> Shipping Total: <br /><br /> Handling % plus fixed.<br /><br /> Handling total: <br /><br /> Order Total Tax: <br /><br /> Order Total...