跳转到主要内容
部分支付交易需要额外授权才能处理。本指南将解释何时需要授权以及如何通过不同方式批准支付。

何时需要授权

根据这些条件产生的付款需要额外授权:
  • API 付款:通过 API 创建,且 requireAuth 参数设置为 true。
  • Business Portal 付款:直接在 Localpayment Business Portal 中创建。

授权方法

授权支付的方式取决于支付最初是如何创建的: 商业门户创建的付款 对于在Business Portal中创建的付款,必须由另一位具有授权权限的用户进行授权。 API创建的付款 对于通过 API 创建的付款,请使用授权付款endpoint 以编程方式批准交易。

先决条件

在授权付款前,请确保您已具备以下条件:
  • 一笔状态为 PendingAuth 的已初始化付款交易
  • 具有授权权限的有效 API 凭据
  • 交易标识符(internalId 或 externalId),或用于批量授权的日期范围

通过 API 授权付款

endpoint

验证

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

关键请求参数

您可以使用以下三种方式之一授权付款:
选择一种授权方式对于单笔交易,请使用特定的交易 ID(internalId 或 externalId);对于批量授权,请使用日期范围(dateFrom 和 dateTo)。

示例请求


响应处理

成功响应

授权成功后,您将收到:

关键响应字段

错误响应

验证错误

最佳实践

  • 授权前务必验证交易详情。
  • 所有 API 请求均使用 HTTPS
  • 安全地存储访问令牌
  • 实施适当的错误处理和日志记录
  1. 创建付款:生成 requireAuth=true 的付款
  2. 验证状态:确认交易状态为 PendingAuth
  3. 查看详情:验证交易信息
  4. 授权:调用授权 endpoint
  5. 处理响应:妥善处理成功/错误响应
  6. 监控:通过 Webhook 跟踪交易状态变化

资源与后续步骤

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

Webhook 集成

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

报告 Business Portal

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

交易监控

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

API 参考

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

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

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

最后修改于 2026年11月10日