跳转到主要内容
以编程方式下载已完成的退款交易的付款证明(POP)文档。 付款证明(POP)是已完成退款交易的官方确认文件。除了可以从Business Portal手动下载外,您还可以通过 API 以编程方式请求获取。

先决条件

开始之前,请确保您已准备好:
  • 带有有效访问令牌的有效 API 凭证。
  • 一笔或多笔状态为 Completed 的退款交易。
  • 您想要获取 POP 的每笔交易的 internalId 或 externalId。

API endpoint

要下载退款 POP,请向下载退款付款证明endpoint 发送 POST 请求。

endpoint

验证

请在请求头中包含您的访问令牌:

请求体

请求体是由交易标识符组成的 JSON 数组。您可以在同一请求中混合使用 internalId 和 externalId 值。

示例请求

curl

响应处理

成功响应

成功时,响应体就是 ZIP 压缩包本身,以纯文本形式进行 base64 编码。它不会包装在 JSON 字段中:直接解码响应体即可获得 ZIP 文件,其中为每笔所请求的交易包含一份 PDF 付款证明。

错误响应

401 未经授权。 访问令牌缺失、无效或已过期。
403 禁止访问。 一笔或多笔所请求的交易状态不是 Completed。
404 未找到。 所请求的标识符均没有可用的付款证明信息。

实施最佳实践

  • 请求 POP 之前,先验证交易处于 Completed 状态。
  • 将多个交易 ID 批量放入单个请求,而不是对每笔交易分别调用一次该 endpoint。
  • 妥善保管访问令牌并定期轮换使用。

资源与后续步骤

利用这些关键资源,最大限度地提高您的集成成功率。

Webhook 集成

设置交易状态更新的实时通知。

报告 Business Portal

获取详细的分析、报告工具和对账功能。

交易监控

学习查询交易状态并实现全面跟踪。

API 参考

提供包含交互式示例的完整 endpoint 文档。

专业提示在部署到生产环境之前,务必先在我们的沙盒环境中测试您的工作流程。这可以确保您的错误处理、Webhook 处理和状态跟踪在所有场景下都能正常工作。

需要帮助吗?如果您遇到任何问题或需要集成方面的帮助,请联系我们的支持团队。

最后修改于 2026年11月10日