Prerequisites

• opencart version 3.8
• php version >=7.3
• php Extensions:curl
• chmod 777 /opencart_root/storage/logs

---

---

The following settings are not mandatory, if a 504 error occurs, check the following options

• php ini execution timeout
• nginx or apache set execution timeout

---

Caution

1. Order numbers under the same accId cannot be duplicated and must be monotonically increasing, otherwise it will cause order status problems;
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 a value greater than the current maximum order id;
4. After resetting the database, store, or migrating accId to another store, you should check the maximum order number under accId.

Plugin Download

opencart-ppay.ocmod.zip

---

Installation Process

Login to Website Backend

Select Extension Management->Plugin Installation Click Upload Plugin.

Install Plugin

Configure Plugin

Enable Plugin

Environment Parameters

Sandbox Environment Store Parameters

Sandbox Environment Store Parameters

# PingPong Sandbox Environment Store Parameters
clientId: 2018092714313010016
accId: 2018092714313010016291
salt: F78BC96A55548B2319EE68E0

Sandbox Environment Test Card Numbers

Sandbox Environment Test Card Numbers

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

# 3DS Transaction Test Card Number
3DS Transaction Card: 4711100000000000

Environment Addresses

PingPong Payment Environment Addresses

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

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

Integration Process

Sandbox Environment Integration

1. Install the plugin according to the file instructions.
2. After the plugin installation is completed, self-testing of payment is required, and the following items need to be completed:

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

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

---

Notes:

In the 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, and after successful integration testing, the payment channel should be immediately closed and wait for the production environment to go online before opening.

---

Production Environment Integration

1. After the plugin completes the first round of sandbox environment integration with technical support, it will enter the website information and account review stage. After passing the review, production environment parameters will be issued.
2. After obtaining the 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 officially goes live, and payment becomes available.

Production Environment Configuration

Review Process

Get 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 hung 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 based on 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, which will default to 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 the status is "Abnormal", they cannot be used and you can contact relevant business personnel for handling.