---
url: >-
  https://acquirer-api-docs-v4-en.pingpongx.com/notes/zh/integrate/magento235/index.md
description: >-
  Magento2.3.5-PPPay
  插件安装说明涵盖了插件的安装前提、注意事项及详细步骤。适用于Magento版本≥2.3.5和PHP版本≥7.1的环境，支持curl和bcmath扩展。文档强调了订单号单调递增的重要性，并提供了沙箱与生产环境配置参数及命令行操作指南。
---
# Magento2.3.5-PPPay 插件安装说明

## 安装前提

> - magento version>=2.3.5
> - php version >=7.1
> - php extionsion:curl bcmath  
> - chmod 777 /magentoRoot/var/log

---

以下为非必要设置，若出现504错误可以检查下列选项

- [ ] php ini执行超时时间 
- [ ] nginx 或者 apache 设置执行超时时间

---

::: danger 注意
1. 同一个accId下订单号不能重复，必须是单调递增的，否则会引发订单状态问题。
2. 来源于不同数据库的订单不能共用同一个accId。
3. accId下已经有过交易，安装插件之前应该将id起始值设置为大于当前订单id最大的值。
4. 重置数据库，商店，或者accId迁往别的商店，应该检查accId下订单号最大值。
:::

### 插件下载

<a :href="$withBase('/magento235/Pppay.zip')" download="Pppay.zip">Pppay.zip</a>

## 安装过程

### Magento安装路径规则
解压插件包后 我们先查看插件压缩包的registration.php文件
```php title="registration.php" line-numbers<?php
// [!code highlight] 注册Magento插件组件
\Magento\Framework\Component\ComponentRegistrar::register(
    \Magento\Framework\Component\ComponentRegistrar::MODULE,
    'Pppay_Pppay', // 插件包名
    __DIR__
);
```
插件包名为Pppay,插件名为Pppay。
所以安装目录为app/code/Pppay/Pppay/
把插件的代码解压到app/code/Pppay/Pppay/里就行。

通过FTP登录服务器，插件安装进去后，就需要启用该插件了,默认是禁用的。
我们ssh登录服务器，cd到Magento项目根目录。

---

### 1.查看插件列表
```shell title="查看插件列表" line-numbers
php bin/magento module:status
```
这条命令列出了插件列表，我们在列表结尾处查到Pppay_Pppay，发现信息如下：
```shell title="插件状态输出" line-numbers
...
List of disabled modules:[!code highlight]
Pppay_Pppay
```
插件是被禁用的。
**如果没有看到你的插件的话,说明你插件没有安装正确,安装目录不对,系统没识别到。**

---

### 2.启用插件并安装插件数据
```shell title="启用插件并安装插件数据" line-numbers
php bin/magento module:enable --clear-static-content Pppay_Pppay[!code highlight]
php bin/magento setup:upgrade[!code highlight]
php bin/magento setup:di:compile[!code highlight]
```

---

### 3.deploy

如果是默认模式或者生产模式的话,需要deploy下

```shell title="部署静态内容" line-numbers
php bin/magento cache:clean[!code highlight]
php bin/magento cache:flush[!code highlight]
php bin/magento setup:static-content:deploy -f[!code highlight]
```
### 4.RuntimeException

如果还报[RuntimeException]这样的错误,代码有缓存,需要执行更新系统

```shell title="清理缓存并重新编译" line-numbers
php bin/magento maintenance:enable[!code highlight]

rm -rf var/di/* && rm -rf var/generation/* && rm -rf var/cache/* && rm -rf var/page_cache/* && rm -rf var/view_preprocessed/* && rm -rf pub/static/* && rm -rf generated/* && mkdir var/di

php bin/magento setup:upgrade && php bin/magento setup:di:compile[!code highlight]

php bin/magento setup:static-content:deploy -f && php bin/magento indexer:reindex && php bin/magento maintenance:disable && php bin/magento cache:clean && php bin/magento cache:flush[!code highlight]

```

---

## 配置过程

1.  登录网站后台 
1. 选择`STORES->Configuration->Sales->Payments Method->Ping Pong Pay`
   ![image.png](/magento235/1629294143209-dcc8a72d-8755-4f26-a375-98f613267516.png)
1. 按照下图所示配置参数!
   [image.png](/magento235/1629294335798-7a795d99-5669-4423-ba7c-6fd1d3226dee.png)

---

## 环境参数
### 沙箱环境店铺参数
```text title="沙箱环境店铺参数" line-numbers
# [!code highlight] PingPong沙箱环境店铺参数
clientId: 2018092714313010016
accId: 2018092714313010016291
salt: F78BC96A55548B2319EE68E0
```
### 沙箱环境测试卡号
```text title="沙箱环境测试卡号" line-numbers
# [!code highlight] 标准测试卡号
卡号：4200000000000000
有效期：12/22
cvv: 123
cvv需为3位纯数字

# [!code highlight] 3DS交易测试卡号
3DS交易卡：4711100000000000
```
###  环境地址
```text title="PingPong支付环境地址" line-numbers
# [!code highlight] 沙箱环境地址
沙箱环境    https://sandbox-acquirer-payment.pingpongx.com

# [!code highlight] 生产环境地址
生产环境    https://acquirer-payment.pingpongx.com
```

---

### 对接过程
#### 沙箱环境对接

1. 按照文件安装插件。
1. 插件安装完成之后，需要进行支付自测，并完成以下事项：
- [ ] 截图输入卡号的页面
- [ ] 截图支付完成的最终跳转页面
- [ ] 将截图发送到对接群，并通知技术支持

安装过程，有任何问题可以在对接群里需求技术支持。

---

注意事项：
> 沙箱环境下，不会对持卡人发起扣款，支付之后发货将造成损失，不发货将持卡人可能会发起投诉。因此在对接期间，需要谨慎操作，对接测试通过之后，因立即关闭支付通道，等待生产环境上线之后打开。

---

## 生产环境对接

1. 插件在技术支持下完成第一轮的沙箱环境对接后将进入，网站资料和账户审查阶段，通过之后，会发放生产环境参数。
1. 获取到生产参数之后，完成以下事项
- [ ] 将沙箱环境参数替换为生产参数。
- [ ] 自测支付，并完成截图
- [ ] 准备一个$1的商品链接。
3. 发送截图和商品链接，并通知技术支持，将由客户/技术支持对该商品链接发起真实交易测试。以验证对接结果和网站支付可用性。
3. 完成真实交易测试之后，需要商户发起退款，以便于验证退款流程。
3. 完成以上流程，网站对接结束，支付通道正式上线，支付可用。

## 生产环境配置
### 审核过程
从对接群中或者商务/客户处获得通知，审核通过。
登录[商户后台](https://pay.pingpongx.com/aq/websiteList)
```text title="商户后台地址"https://pay.pingpongx.com/aq/websiteList
```
#### 前往网站列表
如图所示，前往群组管理->查看详情->网站列表
#### 群组管理
> - ⚫  从菜单栏选择【网站管理】-【群组管理】进入群组管理页面
> - ⚫  该功能实现当前商户可点击“创建群组”新建群组;系统默认会给一个默认的群组
> - ⚫  网站下挂于群组。
> - ⚫  点击“查看详情”进入群组详情页面，可修改群组名称、查看复制 ID 号、查看群组下的网站。

![image.png](/magento235/1629468866673-c4edef47-9708-4141-959c-feab1b3f6c26-20210821002721004.png)
#### 选择网站

根据当前对接网站的域名，在列表中选择对应的网站
![image.png](/magento235/1629468928427-be88d189-e850-4479-a279-f853446fc371-20210821002730498.png)

#### 获取对应域名网站的accId
![image.png](/magento235/1629468994781-7e5ba639-38ca-4593-a6cb-a3d213d71bb0-20210821002739821.png)


#### 获取秘钥
> 从菜单栏选择【系统管理】-【秘钥管理】默认进入秘钥管理页，可在此页面查 看网站秘钥。
进入秘钥管理后，可查看所有网站对应的秘钥，点击“秘钥详情”查看具体秘
> 钥字段。
> 状态为“正常”的秘钥可使用，当状态为“异常”时，将无法使用可联系相关业务 人员处理。



![image.png](/magento235/1629469253929-79e2ba85-c8c9-460f-bb79-e6b9301ae557-20210821002748739.png)

---

### M2常用命令

#### 显示后台管理员URI
```shell title="显示后台管理员URI" line-numbers
php bin/magento info:adminuri
```
#### 卸载模块
比如插件名为Pppay_Pppay
```shell title="卸载模块" line-numbers
php bin/magento module:uninstall --clear-static-content Pppay_Pppay
```
#### 启用模块插件
比如插件名为Pppay_Pppay
```shell title="启用模块插件" line-numbers
php bin/magento module:enable --clear-static-content Pppay_Pppay
```
#### 禁用模块插件
比如插件名为Pppay_Pppay
```shell title="禁用模块插件" line-numbers
php bin/magento module:disable --clear-static-content Pppay_Pppay
```
#### 插件列表(启用和禁用的)
```shell title="插件列表" line-numbers
php bin/magento module:status
```
#### 切换到生产模式
```shell title="切换到生产模式" line-numbers
php bin/magento deploy:mode:set production
```

#### 切换到开发模式
```bash title="切换到开发模式" line-numbers
php bin/magento deploy:mode:set developer
```
#### 代码编译
检查代码是否有语法错误,比如调用的类是否存在等等。
```shell title="代码编译" line-numbers
bin/magento setup:di:compile[!code highlight]
```
#### 生成静态文件
生成最新的静态文件到pub/static里去。
默认模式和生成模式必须要这些静态文件,不然就报错。
```shell title="生成静态文件" line-numbers
bin/magento setup:static-content:deploy -f[!code highlight]
```
会自动生成默认语言(一般为英语)的静态文件。
也就是说上面这条命令只生成en_US的静态文件。
如果你想要同时生成英文和中文,需要在后面指定语言包名,就是:
```shell title="生成多语言静态文件" line-numbers
bin/magento setup:static-content:deploy en_US zh_Hans_CN -f[!code highlight]
```

#### 更新Magento数据库数据
插件里有自定义的表/添加了产品属性/更改了某个字段等等,凡是跟数据库表相关的数据。
都用这个命令来更新到数据库里去。
```shell title="更新Magento数据库数据" line-numbers
php bin/magento setup:upgrade[!code highlight]
```