> ## Documentation Index
> Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 上线清单

> 从沙盒切换到生产环境前的完整检查清单。

从沙盒切换到生产环境前，请逐项确认以下检查清单。

## 集成验收

* 已通过 Waffo [集成验收标准](/docs/zh/developer-docs/tools-and-references/references/acceptance-criteria)（含功能测试、异常处理、传参质量检查）
* 已将验收结果提交给 Waffo 技术对接群，并获得确认

## 凭证与配置

* 如使用 Waffo SDK 或 AI 集成工具，已将环境配置从 `Environment.SANDBOX` 切换为 `Environment.PRODUCTION`
* 如直接调用 API，已切换到生产环境 API 域名，并使用生产环境 API Key
* 已配置生产环境的 API Key（在 **Merchant Portal → Integration** 页面查看，需 Dev/Admin 角色）
* 已生成生产环境的 RSA 密钥对（不能复用沙盒预生成的密钥）
* 已在 **Merchant Portal → Integration** 页面配置商户公钥（复制 X.509 Base64 内容，需 Dev/Admin 角色）
* 已在 Portal 获取生产环境的 Waffo 公钥
* 如需全局退款回调，已在 Portal 配置 `refundNotifyUrl`
* 如需[争议/拒付](/docs/zh/essentials/dispute-chargeback)通知，已在 Portal 配置 `chargebackNotifyUrl`

可使用以下命令生成与 Waffo 签名工具一致的生产环境 RSA 密钥对。私钥格式为 PKCS8 Base64，公钥格式为 X.509/SPKI Base64：

```bash theme={null}
openssl genpkey -algorithm RSA \
  -pkeyopt rsa_keygen_bits:2048 \
  -out merchant_private_key.pem

openssl pkcs8 -topk8 -inform PEM -outform PEM -nocrypt \
  -in merchant_private_key.pem \
  | grep -v '^-----' \
  | tr -d '\n' > merchant_private_key.base64

openssl rsa -in merchant_private_key.pem -pubout \
  | grep -v '^-----' \
  | tr -d '\n' > merchant_public_key.base64
```

脚本会自动去掉 PEM 头尾，并输出单行 Base64。将 `merchant_public_key.base64` 文件中的内容直接复制到 Merchant Portal 的商户公钥输入框。将 `merchant_private_key.base64` 保存到服务端密钥管理系统；不要提交到代码仓库或发送给 Waffo。

## 安全

* RSA 私钥未硬编码在代码中，使用环境变量或密钥管理服务
* 所有 API 通信使用 TLS 1.2+
* 日志中未记录完整的密钥或敏感支付信息

## 基建推荐配置

* 推荐将生产服务器部署在海外或网络延迟稳定的区域；如部署在中国大陆，请先完成到 Waffo API 的延迟评估
* 推荐 API 调用超时时间设置为 15 秒，最低不低于 8 秒
* 推荐 DNS 缓存时间设置为 60 秒，避免长期固定 Waffo IP
* 推荐对创建支付、查询支付、Webhook 处理配置日志和告警，便于上线初期排查问题

## App 相关（如适用）

* App WebView 允许打开外部 App 和外部浏览器页面
* App WebView 支持下载、复制、长按保存等能力（QR、OTC、银行转账等支付方式可能需要）
* 原生 App 与 WebView 之间传递 URL 时完整保留 query 参数
* 已按 [支付方式集成注意事项](/docs/zh/developer-docs/tools-and-references/references/payment-method-integration-notes) 检查 PayPay、Google Pay、Apple Pay、JKOPAY 等限制