先决条件
取消付款之前,请确保您已具备以下条件:- 一笔处于活动状态的付款交易,其状态为:
PendingAuth、Received、OnHold或Locked - 具有适当权限的有效 API 凭证
- 交易标识符(
externalId)
API endpoint
要取消付款,请向取消付款endpoint 发送PATCH 请求。
取消付款请求
验证
请在请求头中包含您的访问令牌:关键请求参数
示例请求
curl
响应处理
成功响应
取消成功后,您将收到包含更新后状态的响应:关键响应字段
错误响应
实施最佳实践
- 在尝试取消之前,务必先验证交易状态
- 所有 API 请求均使用 HTTPS
- 妥善保管访问令牌并定期轮换使用
- 实施适当的错误处理和重试逻辑
- 记录所有取消尝试以便审计
测试您的实施
在部署到生产环境之前,请彻底测试您的取消逻辑:- 使用有效交易进行测试,交易需处于可取消状态
- 使用无效交易进行测试,以便妥善处理错误
- 测试身份验证失败和令牌过期的情况
- 如已实施,请验证 webhook 处理
- 测试速率限制和重试逻辑
资源与后续步骤
利用这些关键资源,最大限度地提高您的集成成功率。Webhook 集成
设置交易状态更新的实时通知。
报告 Business Portal
获取详细的分析、报告工具和对账功能。
交易监控
学习查询交易状态并实现全面跟踪。
API 参考
提供包含交互式示例的完整 endpoint 文档。
专业提示在部署到生产环境之前,务必先在我们的沙盒环境中测试您的工作流程。这可以确保您的错误处理、Webhook 处理和状态跟踪在所有场景下都能正常工作。
需要帮助吗?如果您遇到任何问题或需要集成方面的帮助,请联系我们的支持团队。

