# Prestashop

## 引言

PayKKa 是一款为商家和消费者提供高效、便捷的支付解决方案的第三方支付平台。它为在线商店、移动应用和其他电子商务平台提供集成的支付服务，支持多种支付方式，并拥有强大的安全防护体系。

## 插件安装前的准备

### 确保您的 Prestashop 版本

- PayKKa 支付插件支持的 Prestashop 版本范围（1.7.0 至 8.2.1）。
- 推荐的 PHP 版本 8.1（建议 7.0 至 8.2 之间）。


### 注册 PayKKa 账户

#### 沙箱环境支付功能开通

- 访问 [Sandbox 登录](https://portal-sandbox.paykka.com/login) 点击右上角 **点击注册** 按钮，按照提示完成帐号注册。
- 收到邮件后可跳转设置初始密码，然后登录系统。
- 实名认证：点击 **实名认证** 项目完成实名认证，激活账户。
- 商户入网：点击 **商户入网** 项目完成商户入网，创建可交易商户。
- 支付密码：点击 **支付密码** 项目设置支付密码，该密码用于退款前安全校验，请妥善保管。
- 以上操作亦可联系 PayKKa 对接人员协助完成。


#### 设置交易密钥

- 访问 [Sandbox 登录](https://portal-sandbox.paykka.com/) 后，点击右上角 **个人账户** -> **个人中心** -> **安全设置** -> **交易密钥**，点击 **设置** 。
- 可下载使用下方的工具生成一对 RSA2048 密钥对，将公钥输入“我的公钥”并 **保存** ，后续对接时使用该密钥对进行加签验签。
- 交易密钥上方的 PayKKa 公钥可用于如下场景验签：接收交易通知，处理 API 响应。
- 联系对接人员为您开通需要的支付方式。
请妥善保护您的私钥，防止泄露。


#### 生产用户注册

- 亚太地区：`https://portal.paykka.com/`
- 欧洲地区：`https://mps.eu.paykka.com/`


### 下载插件

- 联系对接人员获取支付插件压缩包。
- 登录 Prestashop 应用市场下载。
- 通过 github 下载 PayKKa 支付插件。


## 安装插件

### 手动安装

- 在 Prestashop 后台找到 **模块和服务** 部分，点击 **上传模块**。
- 上传 PayKKa 支付插件的压缩包文件。
- 点击安装并激活插件。


Description of image
### 自动安装

- 在 Prestashop 后台 **模块和服务** 搜索 **PayKKa**，然后点击 **安装**。


Description of image
### 安装验证

- 确保插件已安装成功，商家可以在 **已安装模块** 列表中看到 PayKKa 插件。


## 配置插件

### 配置 PayKKa 后台信息

- PayKKa 商户号
- PayKKa Client key
- 商户交易私钥
- PayKKa 公钥


商户操作完 **注册 PayKKa 账户** 步骤后便可获取到对应字段信息

Description of image
### 设置支持语言、货币和国家

- 设置支持的支付语言（如英语、中文等）、币种（如 USD、CNY 等）以及国家（如中国香港、美国等）。


Description of image
## 测试支付功能

- **开启测试模式**：在插件设置中开启“测试模式”，以便在开发阶段进行测试。
- **执行支付测试**：在商店前端进行测试订单，选择 PayKKa 支付方式，确保支付流程顺畅。
- **验证支付回调**：确保支付完成后，商家的订单状态正确更新，并且支付结果正确显示。


## 上线和生产验证

- **切换到生产模式**：完成所有测试后，切换插件为 **生产模式**。
- **支付验证**：在实际支付环境中再进行一次支付流程验证，确保一切正常运行。


## 更新和维护

- 定期检查 PayKKa 插件的更新版本，并根据需要进行升级。
- 确保系统和插件都保持最新，以避免安全风险。