China Payments Plugin Documentation
Main SiteDemoPricingGet support
EN (English)
EN (English)
  • Welcome 👋
  • Getting Started
    • Quick Setup
    • Activating Payment Methods
  • Checkout Flows
    • WooCommerce
    • MemberPress
    • Simple Membership Plugin
    • LifterLMS
    • Payment Page (payment form)
  • Payment Gateways
    • Stripe
    • Planned Payment Gateways
  • Payment Methods
    • WeChat Pay
      • WeChat Pay User Experience
    • Alipay
      • Alipay User Experience
    • Credit Cards
  • Currencies
    • Supported Currencies
    • Currency Conversion API
  • Common Error Messages
    • Common WeChat Pay Error Messages
    • Common Alipay Error Messages
    • Other Errors + Plugin Conflicts
  • Troubleshooting
    • Troubleshooting Steps
    • Why are payments for WeChat Pay and Alipay getting refunded?
    • How do I add Gaucho Plugins Support to my Stripe Team?
    • Why isn't Stripe Connect working?
    • Why are payments failing in Stripe?
    • WooCommerce Order Completion
  • FAQs
    • How do I set up Stripe Webhooks?
    • Why can't I activate Alipay or WeChat Pay in my Stripe account?
    • How do WeChat Pay and Alipay work?
    • What is China Payments Plugin?
    • How does China Payments Plugin Work?
    • How do I connect with Stripe Connect?
    • How do I upgrade to the PRO or Business plans?
    • How do I set up a payment confirmation page?
    • How long are WeChat Pay QR codes valid?
    • What's the total cost of using China Payments Plugin?
    • How do I remove all plugin data on uninstallation?
    • How do I join the BETA?
    • How do I override the icons used in checkout?
  • Changelog
    • Changelog
Powered by GitBook
On this page
  1. Currencies

Currency Conversion API

WeChat Pay and Alipay only support the default currency of your Stripe account, so we built a currency conversion API to show the right price to your customers before checkout.

PreviousSupported CurrenciesNextCommon WeChat Pay Error Messages

Last updated 3 years ago

Obviously, Chinese customers much prefer to see CNY on checkout when purchasing online. This is true for every consumer purchasing online. Your national currency is generally the most familiar and most comfortable to you.

If your payment form displays a currency other than CNY, this will lead to a bad checkout process for Chinese customers who will wonder:

"Why are payments appearing in USD (or another currency) and not in CNY?"

To solve this problem, we created an integration with a free currency conversion API, which you can setup in the plugin settings under the "Currency" tab. This API integration converts the amount on your payment form (in whatever currency your Stripe account uses) and displays the approximate CNY equivalent for your customers BEFORE they scan the WeChat Pay QR code or get redirected to Alipay.

If you're using WooCommerce, this is an example of what the currency conversion looks like on the checkout page:

WeChat and Alipay convert the payment amount to CNY when the customer goes to the next step of the payment process. This means the currency conversion API is optional, and it is strictly up to you if you want to use it to optimize your checkout flow so your Chinese customers are aware of what they will pay on the next step.

We have plans to add the currency conversion to the Single Product Page and Product Archive pages in WooCommerce, based on customer needs, so please contact support if you'd like us to streamline this feature.

Unfortunately, the currency options can be a bit limiting due to Stripe restrictions, but if you have any further questions please contact .

support
WooCommerce Currency Conversion API