Installation Prerequisites

• wordpress version 3.x 5.6 5.7
• php version >=7.3
• php-Extensions:curl
• chmod 777 /webRoot/wordpress/wp-content/log

---

The following are non-essential settings, if 504 error occurs, you can check the following options

• php ini execution timeout
• nginx or apache timeout settings

---

Caution

1. Order numbers under the same accId cannot be duplicated, they must be monotonically increasing, otherwise order status issues will occur;
2. Orders from different databases cannot share the same accId;
3. If there have been transactions under accId, before installing the plugin, the id starting value should be set to be greater than the current maximum order id;
4. When resetting the database, store, or migrating accId to another store, you should check the maximum order number under accId.

Plugin Download

woocommerce-pppay.zip

Installation Process

Login to website backend

Select Module-> Module Manager -> Upload Plugin

After installation is complete, select woocommerce->Settings->Payment, enable the plugin switch as shown in the figure below.

Click Management in the figure below to open the plugin parameter configuration page

Configure runtime environment parameters (sandbox, production) as shown in the figure below, then click Save

Configure plugin log directory (note that the directory must be writable) Login to the server via FTP to modify the code, find ABSPPATH in wp-config.php, define your plugin log directory on the line after ABSPPATH, the log directory permissions must be writable.

wp-config.php

/** Absolute path to the WordPress directory. */
if ( !defined('ABSPATH') ){
    define('ABSPATH', dirname(__FILE__) . '/');
}

define('WP_TEMP_DIR', ABSPATH . 'wp-content/tmp');

Environment Parameters

Sandbox Environment Store Parameters

config/sandbox.ini

clientId: 2018092714313010016  
accId: 2018092714313010016291  
salt: F78BC96A55548B2319EE68E0  

Sandbox Environment Test Card Numbers

config/test-cards.txt

Card Number: 4200000000000000
Expiry Date: 12/22
cvv: 123
cvv must be 3-digit pure numbers

3DS transaction card: 4711100000000000

Environment URLs

config/environment-urls.txt

Sandbox Environment    https://sandbox-acquirer-payment.pingpongx.com

Production Environment    https://acquirer-payment.pingpongx.com

Integration Process

Sandbox Environment Integration

1. Install the plugin according to the file.
2. After plugin installation is complete, payment self-testing is required, and complete the following items:

• Screenshot the card number input page
• Screenshot the final redirect page after payment completion
• Send screenshots to the integration group and notify technical support

If there are any issues during the installation process, you can request technical support in the integration group.

---

Notes:

In sandbox environment, no deduction will be made from the cardholder, shipping after payment will cause losses, and not shipping may result in complaints from cardholders. Therefore, during integration, operations need to be performed carefully, after integration testing is passed, the payment channel should be immediately closed and wait for production environment launch before opening.

---

Production Environment Integration

1. After the plugin completes the first round of sandbox environment integration under technical support, it will enter the website information and account review stage. After passing, production environment parameters will be issued.
2. After obtaining production parameters, complete the following items

• Replace sandbox environment parameters with production parameters.
• Self-test payment and complete screenshots
• Prepare a $1 product link.

3. Send screenshots and product link, and notify technical support. The customer/technical support will initiate a real transaction test on this product link to verify the integration results and website payment availability.
4. After completing the real transaction test, the merchant needs to initiate a refund to verify the refund process.
5. After completing the above process, website integration ends, the payment channel is officially launched, and payment becomes available.

Production Environment Configuration

Review Process

Receive notification of approval from the integration group or business/customer. Login to Merchant Backend

urls/merchant-backend.txt

https://pay.pingpongx.com/aq/websiteList

Go to Website List

As shown in the figure, go to Group Management->View Details->Website List

Group Management

• ⚫ Select [Website Management]-[Group Management] from the menu bar to enter the group management page
• ⚫ This function allows the current merchant to click "Create Group" to create a new group; the system will provide a default group by default
• ⚫ Websites are under groups.
• ⚫ Click "View Details" to enter the group details page, where you can modify the group name, view and copy the ID number, and view websites under the group.

Select Website

Select the corresponding website from the list according to the domain name of the current integration website

Get accId for the corresponding domain website

Get Secret Key

Select [System Management]-[Secret Key Management] from the menu bar, by default enter the secret key management page, where you can view the website secret key. After entering secret key management, you can view the secret keys corresponding to all websites, click "Secret Key Details" to view specific secret key fields. Secret keys with status "Normal" can be used, when status is "Abnormal", they cannot be used and you can contact relevant business personnel for handling.