wordpress-PPPay 插件安装说明

安装前提

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

---

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

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

---

注意 :

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

安装过程

登录网站后台

选择 模块-> Module Manager ->上载插件

安装完成之后，选择woocommerce->配置->支付，按下图所示打开插件启用开关。

点击下图中的管理，打开插件参数配置页面

按照下图所示，配置运行环境参数（sandbox，production），最后点击保存

配置插件日志目录（注意目录必须可写） 通过FTP登录服务器修改代码，在wp-config.php里的找到ABSPPATH，在ABSPPATH的后面一行定义你的插件日志目录，日志目录权限必须可写。

/** WordPress目录的绝对路径。 */
if ( !defined('ABSPATH') ){
    define('ABSPATH', dirname(__FILE__) . '/');
}

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

环境参数

沙箱环境店铺参数

clientId: 2018092714313010016
accId: 2018092714313010016291
salt: F78BC96A55548B2319EE68E0   

沙箱环境测试卡号

卡号：4200000000000000
有效期：12/25
cvv: 123
cvv需为3位纯数字
3DS交易卡：4711100000000000

环境地址

沙箱环境    https://sandbox-acquirer-payment.pingpongx.com
生产环境    https://acquirer-payment.pingpongx.com

对接过程

沙箱环境对接

1. 按照文件安装插件。
2. 插件安装完成之后，需要进行支付自测，并完成以下事项：

• [ ] 截图输入卡号的页面
• [ ] 截图支付完成的最终跳转页面
• [ ] 将截图发送到对接群，并通知技术支持

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

---

注意事项：

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

---

生产环境对接

1. 插件在技术支持下完成第一轮的沙箱环境对接后将进入，网站资料和账户审查阶段，通过之后，会发放生产环境参数。
2. 获取到生产参数之后，完成以下事项

• [ ] 将沙箱环境参数替换为生产参数。
• [ ] 自测支付，并完成截图
• [ ] 准备一个$1的商品链接。

3. 发送截图和商品链接，并通知技术支持，将由客户/技术支持对该商品链接发起真实交易测试。以验证对接结果和网站支付可用性。
4. 完成真实交易测试之后，需要商户发起退款，以便于验证退款流程。
5. 完成以上流程，网站对接结束，支付通道正式上线，支付可用。

生产环境配置

审核过程

从对接群中或者商务/客户处获得通知，审核通过。 登录商户后台 (opens new window)

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

前往网站列表

如图所示，前往群组管理->查看详情->网站列表

群组管理

• ⚫ 从菜单栏选择【网站管理】-【群组管理】进入群组管理页面
• ⚫ 该功能实现当前商户可点击“创建群组”新建群组;系统默认会给一个默认的群组
• ⚫ 网站下挂于群组。
• ⚫ 点击“查看详情”进入群组详情页面，可修改群组名称、查看复制 ID 号、查看群组下的网站。

选择网站

根据当前对接网站的域名，在列表中选择对应的网站

获取对应域名网站的accId

获取秘钥

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

物流信息绑定

wordpress-PPPay插件，物流插件Advanced Shipment Tracking for WooCommerce安装完成之后，才可以绑定物流信息。

1. 找到标记为 的网站，单击右侧省略符 ，选择“物流绑定”;
2. 填写 Consumer Key、Consumer Secret 及在 Woocommerce 后台管理账号的域名。

Consumer Key、Consumer Secret 获取方式如下图:

3. 点击绑定
4. 完成绑定。绑定成功后，系统将自动获取物流信息。

交易退款

点击退款之后 Woo后台会变成退款状态 同时PingPongCheckout商户后台也会变为退款状态