> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 审批与双重签名

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

## 何时需要授权

根据这些条件产生的付款需要额外授权：

* **API 付款**：通过 API 创建，且 `requireAuth` 参数设置为 `true`。
* **Business Portal 付款**：直接在 Localpayment Business Portal 中创建。

### 授权方法

授权支付的方式取决于支付最初是如何创建的：

**商业门户创建的付款**

对于在[Business Portal](https://docs.localpayment.com/zh/docs/dashboard-review-payout.md)中创建的付款，必须由另一位具有授权权限的用户进行授权。

**API创建的付款**

对于通过 API 创建的付款，请使用[授权付款](https://docs.localpayment.com/zh/reference/authorize-payout.md)endpoint 以编程方式批准交易。

***

## 先决条件

在授权付款前，请确保您已具备以下条件：

* 一笔状态为 `PendingAuth` 的**已初始化付款交易**
* 具有授权权限的有效 API 凭据
* 交易标识符（`internalId` 或 `externalId`），或用于批量授权的日期范围

***

## 通过 API 授权付款

### endpoint

```http theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
POST https://api.stage.localpayment.com/api/payout/authorize
```

### 验证

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

```http theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
Authorization: Bearer <your_access_token>
```

### 关键请求参数

您可以使用以下三种方式之一授权付款：

| 参数 | 类型 | 描述 | 必需的 |
| - | - | - | - |
| `internalId` | string | Localpayment 的唯一交易标识符 | ✅（选项 1） |
| `externalId` | string | 您的系统的唯一交易标识符 | ✅（选项 2） |
| `dateFrom` | string | 批量授权的起始日期（YYYY-MM-DD） | ✅（选项 3） |
| `dateTo` | string | 批量授权截止日期（YYYY-MM-DD） | ✅（选项 3） |

> [!NOTE]
>
> **选择一种授权方式**
>
> 对于单笔交易，请使用特定的交易 ID（`internalId` 或 `externalId`）；对于批量授权，请使用日期范围（`dateFrom` 和 `dateTo`）。

### 示例请求

> [tab] 单笔交易（外部 ID）
>
> ```curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> curl --request POST \
>      --url https://api.stage.localpayment.com/api/payout/authorize \
>      --header 'Authorization: Bearer <your_access_token>' \
>      --header 'Content-Type: application/json' \
>      --data '{
>        "externalId": "1939b376-2aed-4c7a-bc2b-1157702f00b0"
>      }'
> ```

> [tab] 单笔交易（内部 ID）
>
> ```curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> curl --request POST \
>      --url https://api.stage.localpayment.com/api/payout/authorize \
>      --header 'Authorization: Bearer <your_access_token>' \
>      --header 'Content-Type: application/json' \
>      --data '{
>        "internalId": "7d7f7fca-e411-4ba6-b4f5-b9fed4d5f3d2"
>      }'
> ```

> [tab] 批量授权（日期范围）
>
> ```curl theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
> curl --request POST \
>      --url https://api.stage.localpayment.com/api/payout/authorize \
>      --header 'Authorization: Bearer <your_access_token>' \
>      --header 'Content-Type: application/json' \
>      --data '{
>        "dateFrom": "2024-01-01",
>        "dateTo": "2024-01-31"
>      }'
> ```

***

## 响应处理

### 成功响应

授权成功后，您将收到：

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "status": 200,
  "message": "The request will be processed."
}
```

#### 关键响应字段

| 字段 | 类型 | 描述 |
| - | - | - |
| `status` | integer | HTTP状态码（200表示成功） |
| `message` | string | 确认消息表明请求正在处理中 |

### 错误响应

#### 验证错误

```json theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
{
  "errors": {
    "externalId": [
      "The externalId field is required."
    ]
  },
  "type": "https://tools.ietf.org/html/rfc7231#section-6.5.1",
  "title": "One or more validation errors occurred.",
  "status": 400,
  "traceId": "00-6af59d173e66ad4eb215987cd15d57af-bea3981476c0f347-00"
}
```

## 最佳实践

* 授权前务必验证交易详情。
* 所有 API 请求均使用 HTTPS
* 安全地存储访问令牌
* 实施适当的错误处理和日志记录

### 推荐工作流程

1. **创建付款**：生成 `requireAuth=true` 的付款
2. **验证状态**：确认交易状态为 `PendingAuth`
3. **查看详情**：验证交易信息
4. **授权**：调用授权 endpoint
5. **处理响应**：妥善处理成功/错误响应
6. **监控**：通过 Webhook 跟踪交易状态变化

***

## 资源与后续步骤

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

> [card] [Webhook 集成](https://docs.localpayment.com/zh/docs/webhooks.md)
>
> 设置交易状态更新的实时通知。

> [card] [报告 Business Portal](https://docs.localpayment.com/zh/docs/balance-report.md)
>
> 获取详细的分析、报告工具和对账功能。

> [card] [交易监控](https://docs.localpayment.com/zh/reference/transaction-status-error-codes)
>
> 学习查询交易状态并实现全面跟踪。

> [card] [API 参考](https://docs.localpayment.com/zh/reference/exchange-bulk.md)
>
> 提供包含交互式示例的完整 endpoint 文档。

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

***

> [!NOTE]
>
> **需要帮助吗？**
>
> 如果您遇到任何问题或需要集成方面的帮助，请联系我们的[支持团队](mailto:support@localpayment.com)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.