测试通知 URL

在 AinePay 商户管理后台设置或更新商户通知 URL 时，AinePay 会通过此接口测试商户自己的系统，所以商户系统需要响应此接口。

端点

• 方法： GET
• 路径： {notifyUrl}/ainepay/notify
• 认证： 需要在 AinePay 商户管理后台
• Content-Type： application/x-www-form-urlencoded

请求参数

URL 验证

1. 去除提交的 URL 末尾的 /。
2. 添加固定的 Webhook 路径 /ainepay/notify。
3. 发送带有 x-callback-token 头的 GET 请求。
4. 商户系统必须返回成功的 HTTP 状态。
5. 商户系统必须在响应头中回传相同的 x-callback-token 值。
6. 如果验证通过，URL 将保存为商户的通知 URL。

URL 要求

• URL 必须是 absolute URL。
• URL 不能包含 fragment。
• 在生产环境中，URL 必须使用 https 且有效端口为 443。
• 在生产环境中，URL 不能包含用户信息且不能使用 IP 字面量作为主机。
• 在生产环境中，主机必须解析为公共地址。

预期测试请求

GET /ainepay/notify HTTP/1.1
Host: merchant.example.com
User-Agent: CallbackVerifier/1.0
x-callback-token: 3809990972772635598

常见错误

• 如果提交的 URL 缺失、格式错误或违反 URL 验证规则，返回 PARAMETER_ERROR。
• 如果验证请求无法到达您的端点、收到非 2xx 响应或未收到相同的 x-callback-token 回传，返回 CALL_BACK_URL_INVALID。