跳转到主要内容
有时您需要在付款发起后将其停止,本指南介绍取消流程。 如果您因错误或需求变更需要取消付款,只要该付款处于以下状态之一,即可取消:待授权(Pending Authorization)、已接收(Received)、暂挂(On Hold) 或 已锁定(Locked)。 您可以通过Business Portal 网站取消付款,也可以通过 API 以编程方式取消付款。

先决条件

取消付款之前,请确保您已具备以下条件:
  • 一笔处于活动状态的付款交易,其状态为:PendingAuth、Received、OnHold 或 Locked
  • 具有适当权限的有效 API 凭证
  • 交易标识符(externalId)
重要的付款一旦进入 处理中(Processing) 或 已完成(Completed) 状态,就无法通过 API 取消。如需协助处理已处理的交易,请联系支持团队。

API endpoint

要取消付款,请向取消付款endpoint 发送 PATCH 请求。

取消付款请求

验证

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

关键请求参数

示例请求

curl

响应处理

成功响应

取消成功后,您将收到包含更新后状态的响应:

关键响应字段

错误响应


实施最佳实践

  • 在尝试取消之前,务必先验证交易状态
  • 所有 API 请求均使用 HTTPS
  • 妥善保管访问令牌并定期轮换使用
  • 实施适当的错误处理和重试逻辑
  • 记录所有取消尝试以便审计

测试您的实施

在部署到生产环境之前,请彻底测试您的取消逻辑:
  1. 使用有效交易进行测试,交易需处于可取消状态
  2. 使用无效交易进行测试,以便妥善处理错误
  3. 测试身份验证失败和令牌过期的情况
  4. 如已实施,请验证 webhook 处理
  5. 测试速率限制和重试逻辑

资源与后续步骤

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

Webhook 集成

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

报告 Business Portal

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

交易监控

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

API 参考

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

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

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

最后修改于 2026年11月10日