# 安装指南

本指南涵盖了 Antom Payments for WooCommerce 的安装和初始设置。

## 前提条件

- **WordPress** 5.3 或更高版本
- **WooCommerce** 8.0 或更高版本（测试至 9.0.0）
- **PHP** 7.2 或更高版本
- **Antom 商家账户** — [在此注册](https://dashboard.antom.com/global-payments/account/register?bizMode=ISV&isvBizScene=ISO_COMMON&registrationSource=WooCommerce)

## 安装

### 方法一：从 WordPress 后台安装

1. 进入 **插件 → 安装插件**
2. 搜索 **"Antom"**
3. 点击 **立即安装**，然后点击 **启用**

### 方法二：手动安装

1. 下载插件压缩包
2. 进入 **插件 → 安装插件 → 上传插件**
3. 选择 zip 文件并点击 **立即安装**
4. 点击 **启用**

## 初始配置

激活后，请按以下步骤操作：

### 步骤 1：配置核心凭据

1. 进入 **WooCommerce → 设置 → 结账**
2. 在支付方式列表中找到 **Antom Payment Gateway**
3. 点击 **管理** 或支付方式标题
4. 填写以下必填字段：
   - **Client ID** — 你的 Antom 商家客户端 ID（在 Antom 商家门户中查找）
   - **私钥 (Private Key)** — 你的 RSA 私钥（用于签名 API 请求）
   - **公钥 (Public Key)** — Antom 的 RSA 公钥（用于验证 API 响应）

### 步骤 2：配置 Webhook

1. 登录 [Antom 商家门户](https://dashboard.alipay.com/global-payments/home)
2. 进入 Webhook 配置部分
3. 设置 Webhook URL 为：
   ```
   https://your-store.com/?wc-api=antom_payment_notify
   ```
   将 `your-store.com` 替换为你的商店域名。

### 步骤 3：测试模式（可选）

1. 在核心设置中启用 **测试模式** 以使用 Antom 沙箱环境
2. 从 Antom 商家门户获取沙箱凭据（Client ID、密钥）
3. 测试支付不会处理真实交易

### 步骤 4：启用支付方式

1. 进入 **WooCommerce → 设置 → 结账**
2. 你将看到各个支付方式的列表（信用卡、支付宝、GCash 等）
3. 在每个要启用的支付方式上点击 **管理**
4. 切换 **启用/禁用** 并配置方式特定的设置

## 安装后

配置完成后：

- 所选支付方式将出现在结账页面上
- 客户可以使用首选的本地支付方式完成支付
- 支付结果通过 Webhook 通知异步处理

## 故障排除

### 常见问题

| 问题 | 解决方案 |
|---|---|
| 插件无法激活 | 确保 WooCommerce 已安装并启用 |
| 支付方式不显示 | 检查币种筛选——支付方式仅显示支持的币种 |
| Webhook 不工作 | 验证 Webhook URL 是否正确且可从互联网访问 |
| 签名错误 | 确认私钥和 Antom 公钥配置正确 |

### 日志

启用 WordPress 调试日志以排查问题：

```php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
```

在 `/wp-content/debug.log` 中查看日志。

## 下一步

- 查看[配置指南](configuration.md)了解详细设置参考
- 查看[架构概述](architecture.md)了解插件工作原理
- 查看[Webhook 与 API 参考](webhook-api.md)了解 Webhook 处理详情