先决条件
开始之前,请确保您已准备好:- 带有有效访问令牌的有效 API 凭证。
- 一笔或多笔状态为
Completed的退款交易。 - 您想要获取 POP 的每笔交易的
internalId或externalId。
API endpoint
要下载退款 POP,请向下载退款付款证明endpoint 发送POST 请求。
endpoint
验证
请在请求头中包含您的访问令牌:请求体
请求体是由交易标识符组成的 JSON 数组。您可以在同一请求中混合使用internalId 和 externalId 值。
示例请求
curl
响应处理
成功响应
成功时,响应体就是 ZIP 压缩包本身,以纯文本形式进行 base64 编码。它不会包装在 JSON 字段中:直接解码响应体即可获得 ZIP 文件,其中为每笔所请求的交易包含一份 PDF 付款证明。错误响应
401 未经授权。 访问令牌缺失、无效或已过期。Completed。
实施最佳实践
- 请求 POP 之前,先验证交易处于
Completed状态。 - 将多个交易 ID 批量放入单个请求,而不是对每笔交易分别调用一次该 endpoint。
- 妥善保管访问令牌并定期轮换使用。
资源与后续步骤
利用这些关键资源,最大限度地提高您的集成成功率。Webhook 集成
设置交易状态更新的实时通知。
报告 Business Portal
获取详细的分析、报告工具和对账功能。
交易监控
学习查询交易状态并实现全面跟踪。
API 参考
提供包含交互式示例的完整 endpoint 文档。
专业提示在部署到生产环境之前,务必先在我们的沙盒环境中测试您的工作流程。这可以确保您的错误处理、Webhook 处理和状态跟踪在所有场景下都能正常工作。
需要帮助吗?如果您遇到任何问题或需要集成方面的帮助,请联系我们的支持团队。

