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

# 收款人

> 保存并管理用于定期付款的可信目标地址

<Note>
  简而言之<br />
  收款人是已保存的付款目标——有名称的钱包地址，您可以通过 ID 引用，而无需每次发送资金时都输入原始地址。将其视为您的加密支付联系人列表。
</Note>

## 前提条件

<Steps>
  <Step title="API 密钥">
    从 [Blockradar 控制台](https://dashboard.blockradar.co) 获取您的 API 密钥。
  </Step>

  <Step title="已创建钱包">
    您需要 `walletId` 将收款人与钱包关联。
  </Step>
</Steps>

## 工作原理

收款人允许您一次注册一个目标地址，给它一个名称，并在所有未来的付款中通过 ID 引用它，消除错别字并创建清晰的审计记录。

<CardGroup cols={2}>
  <Card title="保存一次，多次使用" icon="floppy-disk">
    将目标地址注册为命名收款人，并在任意数量的提款中重复使用。
  </Card>

  <Card title="减少人为错误" icon="shield-check">
    通过按 ID 引用地址而非手动输入，消除复制粘贴错误。
  </Card>

  <Card title="审计记录" icon="clock-rotate-left">
    每个收款人都有创建时间戳和名称，便于追踪付款对象。
  </Card>

  <Card title="地址白名单" icon="list-check">
    将收款人作为地址白名单策略的一部分，将付款限制在预先批准的目标地址。
  </Card>
</CardGroup>

## 创建收款人

```bash theme={null}
POST /v1/wallets/{walletId}/beneficiaries
```

```javascript theme={null}
const beneficiary = await fetch(
  `https://api.blockradar.co/v1/wallets/${walletId}/beneficiaries`,
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'x-api-key': apiKey },
    body: JSON.stringify({
      name: 'Alice 财务钱包',
      address: '0xabc123...',
      assetId: 'asset_usdc_base_mainnet'
    })
  }
).then(r => r.json());
```

## 管理收款人

| 操作   | 端点                                                            |
| ---- | ------------------------------------------------------------- |
| 创建   | `POST /v1/wallets/{walletId}/beneficiaries`                   |
| 获取全部 | `GET /v1/wallets/{walletId}/beneficiaries`                    |
| 获取单个 | `GET /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}`    |
| 更新   | `PATCH /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}`  |
| 删除   | `DELETE /v1/wallets/{walletId}/beneficiaries/{beneficiaryId}` |

## 最佳实践

* **清晰命名收款人** — 使用能识别人员、团队或用途的名称。
* **定期审查** — 审计收款人列表，删除不再活跃的目标地址。
* **结合白名单使用** — 如果合规要求将付款限制在已批准的地址，使用收款人作为白名单层。

## API 参考

| 端点                                              | 描述          |
| ----------------------------------------------- | ----------- |
| [创建收款人](/en/api-reference/beneficiaries/create) | 保存新的目标地址    |
| [获取全部](/en/api-reference/beneficiaries/get-all) | 列出所有已保存的收款人 |
| [获取单个](/en/api-reference/beneficiaries/get-one) | 按 ID 获取收款人  |
| [更新](/en/api-reference/beneficiaries/update)    | 更新收款人详情     |
| [删除](/en/api-reference/beneficiaries/delete)    | 删除收款人       |