分步指南：如何阅读 PAYWISE API 日志来排查问题
使用您的 API 密钥发出的每个请求都会被记录。了解每一列的含义、状态码说明了什么，以及如何找到请求失败的原因。
发布于 04 十月 2026 阅读约 3 分钟
当付款没有出现，或者您的集成突然返回错误时，控制台中的 API 日志页面是首先要查看的地方。使用您 API 密钥发出的每个请求都记录在那里。
第 1 步：打开日志
在控制台开发者部分打开 API 日志。每一行是一个请求，最新的在最上面，共六列：
- Method 和 Endpoint：调用了什么，例如
POST /api/v1/transactions。 - 状态：PAYWISE 返回的 HTTP 状态，按类型显示不同颜色。
- 响应时间：PAYWISE 的响应耗时。
- Request ID：该响应的
X-Request-Id。 - 时间：请求发生的时间（印尼西部时间）。
日志保留 60 天。
第 2 步：看懂状态码
- 2xx：成功。
201表示创建了新付款。创建请求返回200表示您发送的merchant_reference已存在且金额和方式相同，因此返回了原来的付款。 - 4xx：请求中有内容需要修改。 原样重试不会有帮助。
- 5xx：支付服务商出现问题。 这种情况很少见，交易会被标记为失败，您可以重新创建一笔。
第 3 步：对照错误码
响应体中总会包含 error.code。最常见的有：
| 状态 | 错误码 | 处理方法 |
|---|---|---|
| 401 | INVALID_API_KEY |
检查密钥和 Authorization: Bearer 请求头 |
| 401 | API_KEY_REVOKED |
创建新密钥；该密钥已被撤销 |
| 403 | IP_NOT_ALLOWED |
将服务器 IP 加入该密钥的允许列表 |
| 409 | DUPLICATE_REFERENCE |
相同的 merchant_reference 但金额或方式不同：请使用新的订单号 |
| 422 | VALIDATION_ERROR |
某个字段缺失或有误，例如 customer_id 或 amount |
| 429 | RATE_LIMITED |
单个密钥每分钟超过 60 次请求：放慢速度后重试 |
| 502 / 504 | PROVIDER_ERROR / PROVIDER_TIMEOUT |
服务商拒绝或未响应：请创建新的付款 |
完整列表见 API 文档。
第 4 步：查看响应时间
大多数请求响应很快。如果创建请求耗时数秒，通常是支付服务商响应较慢。如果同一时间有大量请求变慢，请查看状态页面。
第 5 步：使用 Request ID
在您自己的系统中为每次调用记录 X-Request-Id 请求头。联系客服时提供该 ID：它指向具体的那个请求，问题可以在几分钟内而不是几小时内找到。
小提示
- 沙盒和正式环境的请求都会被记录，上线前即可排查问题。
- 某个请求在日志中完全没有记录？说明它从未到达 PAYWISE：请检查服务器的网络、DNS 或防火墙。
- Webhook 问题在另一个页面：在 Webhook 页面可以看到每次推送尝试及其结果。
