Woo Alipay adds an Alipay China payment gateway to WooCommerce-powered websites. This Mainland China gateway allows customers to pay both in mobile browsers or from their computer.
- A China Mainland Alipay merchant account.
- The Payment products "支付产品" Computer website payment "电脑网站支付" and Mobile website payment "手机网站支付" enabled.
This plugin adds the following major features to WooCommerce:
- Payment of WooCommerce orders in mobile web browser app: calls the Alipay mobile app for a seamless experience.
- Payment of WooCommerce orders standard in web browser: authentication performed via credentials or QR code on desktop/laptop.
- Refund of WooCommerce orders: possibility to refund orders manually in a few clicks, and support for automatic refund in case the transaction failed.
- Multi-currency support: using an exchange rate against Chinese Yuan configured in the settings.
Compatible with WooCommerce Multilingual, WPML, Ultimate Member, and any caching plugin compatible with WooCommerce.
The settings below are added to WooCommerce and WP Weixin when the plugin is active.
The following settings can be accessed in WooCommerce > Settings > Payments > Alipay:
| Name | Type | Description |
|---|---|---|
| Enable/Disable | checkbox | Used to enable/disable the payment gateway. |
| Checkout page title | text | Title displayed for the payment gateway on the checkout page. |
| Checkout page description | text | Description displayed for the payment gateway on the checkout page. |
| Alipay App ID | text | The App ID found in Alipay Open Platform. |
| Alipay public key | textarea | The Alipay public key generated in the Alipay Open Platform ("支付宝公钥"). |
| Alipay Merchant application private key | textarea | The private key generated with the provided Alipay tool application or the openssl command line.This key is secret and is not recorded in Alipay Open Platform - DO NOT SHARE THIS VALUE WITH ANYONE. |
| Sandbox | checkbox | If checked, Run Alipay in sandbox mode, with the settings found in https://openhome.alipay.com/platform/appDaily.htm. |
| Exchange Rate | number | Exchange rate against Chinese Yuan (shows if the store currency is not set to Chinese Yuan) |
- Go to the Alipay Open Platform and log in.
- If necessary, create a new app by following the options under the create application "创建应用" menu: website & mobile application "网页&移动应用" > payment access "支付接入". The application type "应用类型" should be web page application "网页应用" and the website URL "网址url" should be
https://[[your-homepage-url]]where[[your-homepage-url]]is the home URL of your website. Creating an app will require one or two working day(s) audit of your website content by Alipay. - Once the app is created, go to the app information page - accessible directly via
https://openhome.alipay.com/platform/appManage.htm#/app/[[YOUR_APP_ID]]/appInfo(replace[[YOUR_APP_ID]]with the App ID to be used by Woo Alipay). - Activate payment features and configure the app with the gateway information (see "Register features, website URL and callback" below).
- If necessary, generate the application public and private keys, register the application public key in the Alipay Open Platform, and generate the Alipay public key (see "Key management" below).
- Fill in the configuration fields below.
To communicate with the payment gateway, Alipay needs some features activated, to know your website URL, and to be aware of the WooCommerce gateway callback endpoint.
- Go to the app overview page - accessible via
https://openhome.alipay.com/platform/appManage.htm#/app/[[YOUR_APP_ID]]/overview(replace[[YOUR_APP_ID]]with the App ID to be used by Woo Alipay). - Click the add feature button "添加功能" and add the computer website payment "电脑网站支付" and the mobile website payment "手机网站支付" features - these features need to have been activated beforehand (process not describe in this guide - see the Payment products "支付产品" Computer website payment "电脑网站支付" and Mobile website payment "手机网站支付").
- Go to the app information page - accessible via
https://openhome.alipay.com/platform/appManage.htm#/app/[[YOUR_APP_ID]]/appInfo(replace[[YOUR_APP_ID]]with the App ID to be used by Woo Alipay). - Click the setup link "设置" (or modify link "修改") of the application gateway "应用网关" field.
- In the application gateway "应用网关" modal, enter
https://[[your-domain.com]](replace[[your-domain.com]]with the domain or subdomain running WordPress and Woo Alipay) and click the confirm "确定" button. - Click the setup link "设置" (or modify link "修改") of the authorization callback address "授权回调地址" field.
- In the authorization callback address "授权回调地址" modal, enter
httpsin the callback address type "回调地址类型" field,https://[[your-homepage-url]]/wc-api/WC_Alipay/]]in the callback address "回调地址" field (replace[[your-homepage-url]]with the home URL of your website), and leave the verify domain only "只验证域名" checkbox unchecked for added security, then click the confirm "确定" button.
To complete the payment gateway configuration, you need to generate an application public key, an application private key and an Alipay public key.
Generate the application keys with the Alipay Open Platform Development Assistant application (option 1):
- Go to the Alipay tools documentation page and download the Alipay Open Platform Development Assistant application for the operating system of your choice (Windows or MacOS).
- Within the Alipay Open Platform Development Assistant application, in the "生成密钥" section (default screen when opening the Assistant), select "UTF-8" and "PKCS1非Java使用" options and click the "生成密钥" button to populate the text areas.
- Copy the application public key displayed in the "应用公钥" text area in a text file on your computer (referred to as
alipay_app_public_key.txtbelow). - Copy the application private key displayed in the "应用私钥" text area in a text file on your computer (referred to as
alipay_app_private_key.txtbelow) - DO NOT SHARE THIS VALUE WITH ANYONE.
- Type
opensslto open the OpenSSL command line tool. - Type
genrsa -out alipay_app_private_key.txt 2048to generate the application private key file (referred to asalipay_app_private_key.txtbelow) - DO NOT SHARE THIS VALUE WITH ANYONE. - Type
rsa -in alipay_app_private_key.txt -pubout -out alipay_app_public_key.txtto generate the application public key file (referred to asalipay_app_public_key.txtbelow). - Type
exitto quit the command line tool. - Open both files with a text editor, remove all the header, footer, space and carriage return characters to have each key as a single-line long string, and save the files.
Register the application public key in Alipay Open Platform and generate the Alipay public key (requires completing option 1 or option 2 above):
- Go to the app information page - accessible via
https://openhome.alipay.com/platform/appManage.htm#/app/[[YOUR_APP_ID]]/appInfo(replace[[YOUR_APP_ID]]with the App ID to be used by Woo Alipay). - Click the link "接口加签方式" > "设置/查看" to open the configuration modal.
- Use the associated phone number or password to authenticate.
- In the signature key configuration form (加签管理 | 1 - 加签内容配置), select the public key option "公钥".
- Paste the content of the previously saved file
alipay_app_public_key.txtin the "填写公钥字符" text area. - Click the "保存设置" button to register the application public key and generate the Alipay public key.
- Go to the app information page - accessible via
https://openhome.alipay.com/platform/appManage.htm#/app/[[YOUR_APP_ID]]/appInfo(replace[[YOUR_APP_ID]]with the App ID to be used by Woo Alipay). - Click the link "接口加签方式" > "设置/查看" to open the configuration modal.
- If necessary, use the associated Alipay account's phone number or password to authenticate.
- In the signature completed configuration form (加签管理 | 2 - 加签配置完成), copy the Alipay public key displayed under "支付宝公钥".
- Paste the Alipay public key in the "Alipay public key" field below.
- Paste the content of the previously saved file
alipay_app_private_key.txtin the "Alipay merchant application private key" field below. - Click the "Save changes" button.
The following template file is selected using the locate_template() and included with load_template() functions provided by WordPress. This means it can be overloaded in the active WordPress theme. Developers may place their custom template file in the following directories under the theme's folder (in order of selection priority):
plugins/woo-alipay/woo-alipay/woocommerce/woo-alipay/- at the root of the theme's folder
redirected-pay.php
Description
The template of the page displayed when users are redirected before payment. The template acts as a placeholder before showing the Alipay payment UI.
Associated style enqueued with key:
woo-alipay-main-style