--- url: >- https://acquirer-api-docs-v4-en.pingpongx.com/en/notes/integrate/opencart/index.md description: >- Introduction to installing and configuring the PPPay plugin in OpenCart 3.8, including environment requirements, installation steps, and production environment integration process. Suitable for merchants who need to integrate payment functions, supports PHP 7.3 and above, pay special attention to order number uniqueness and monotonic increment rules to avoid status issues. --- # OpenCart-PPPay Plugin Installation Guide ## 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 --- ::: danger 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. ![image.png](/opencart/1629292078166-eb3edab4-8341-4667-8917-66c8477b671d-9476173.png) ### Install Plugin ![image.png](/opencart/681700126850_.pic.jpg) ### Configure Plugin ![image.png](/opencart/1629292956885-29af1e9c-f5b8-4aa2-8560-970951bb1ebe.png) ### Enable Plugin ![image.png](/opencart/1629292978126-c636fdf9-4ba1-4b71-bfc3-506d2da128f5.png) ## Environment Parameters ### Sandbox Environment Store Parameters ```text title="Sandbox Environment Store Parameters" line-numbers # [!code highlight] PingPong Sandbox Environment Store Parameters clientId: 2018092714313010016 accId: 2018092714313010016291 salt: F78BC96A55548B2319EE68E0 ``` ### Sandbox Environment Test Card Numbers ```text title="Sandbox Environment Test Card Numbers" line-numbers # [!code highlight] Standard Test Card Number Card Number: 4200000000000000 Expiry Date: 12/22 cvv: 123 cvv must be 3-digit pure numbers # [!code highlight] 3DS Transaction Test Card Number 3DS Transaction Card: 4711100000000000 ``` ### Environment Addresses ```text title="PingPong Payment Environment Addresses" line-numbers # [!code highlight] Sandbox Environment Address Sandbox Environment https://sandbox-acquirer-payment.pingpongx.com # [!code highlight] Production Environment Address Production Environment https://acquirer-payment.pingpongx.com ``` ## Integration Process ### Sandbox Environment Integration 1. Install the plugin according to the file instructions. 1. 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. 1. 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. 3. After completing the real transaction test, the merchant needs to initiate a refund to verify the refund process. 3. 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](https://pay.pingpongx.com/aq/websiteList) ```text:line-numbers title="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. ![image.png](/opencart/1629468866673-c4edef47-9708-4141-959c-feab1b3f6c26-9476076.png) ### Select Website Select the corresponding website from the list based on the domain name of the current integration website ![image.png](/opencart/1629468928427-be88d189-e850-4479-a279-f853446fc371-20210821001452517-9476096.png) ### Get accId for the corresponding domain website ![image.png](/opencart/1629468994781-7e5ba639-38ca-4593-a6cb-a3d213d71bb0-20210821001511062-9476120.png) ### 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. ![image.png](/opencart/1629469253929-79e2ba85-c8c9-460f-bb79-e6b9301ae557-20210821001534679.png)