何时需要授权
根据这些条件产生的付款需要额外授权:- 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)。示例请求
- 单笔交易(外部 ID)
- 单笔交易(内部 ID)
- 批量授权(日期范围)
响应处理
成功响应
授权成功后,您将收到:关键响应字段
错误响应
验证错误
最佳实践
- 授权前务必验证交易详情。
- 所有 API 请求均使用 HTTPS
- 安全地存储访问令牌
- 实施适当的错误处理和日志记录
推荐工作流程
- 创建付款:生成
requireAuth=true的付款 - 验证状态:确认交易状态为
PendingAuth - 查看详情:验证交易信息
- 授权:调用授权 endpoint
- 处理响应:妥善处理成功/错误响应
- 监控:通过 Webhook 跟踪交易状态变化
资源与后续步骤
利用这些关键资源,最大限度地提高您的集成成功率。Webhook 集成
设置交易状态更新的实时通知。
报告 Business Portal
获取详细的分析、报告工具和对账功能。
交易监控
学习查询交易状态并实现全面跟踪。
API 参考
提供包含交互式示例的完整 endpoint 文档。
专业提示在部署到生产环境之前,务必先在我们的沙盒环境中测试您的工作流程。这可以确保您的错误处理、Webhook 处理和状态跟踪在所有场景下都能正常工作。
需要帮助吗?如果您遇到任何问题或需要集成方面的帮助,请联系我们的支持团队。

