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

# 充值的 Travel Rule

> 当充值带有 need_travel_rule 标记时，提交付款方（发起方）信息。

[Stablecoin Account API 发布方声明](/zh/stablecoin-account/v1.6/guide/stablecoin-account-api-publisher-disclaimer)

部分入账充值需要先提交付款方（发起方，originator）的 Travel Rule 信息才能继续处理。[充值 webhook](/zh/stablecoin-account/v1.6/webhooks/deposit) 会告诉你哪些充值需要：事件的 `data` 中包含 `"need_travel_rule": true`。没有该标记的充值无需任何操作。

<h2 id="when-you-receive-need_travel_rule-true">
  收到 `need_travel_rule: true` 时
</h2>

<Steps>
  <h3 id="collect-the-sender-s-details">
    收集付款方信息
  </h3>

  从充值通知中记下 `from_address` 和 `network` —— 提交的内容必须与该笔充值对应。然后向你的用户收集发起方的 Travel Rule 数据：钱包托管类型、地址属于本人还是第三方，以及必要时的受益人明细。字段规则与提现使用的 `meta_data` 结构完全相同 —— 每个字段及其条件参见 [Travel Rule 合规](/zh/stablecoin-account/v1.6/guide/travel-rule-compliance)。

  <h3 id="submit-the-deposit-sender">
    提交充值发送方
  </h3>

  调用 [Submit Deposit Sender Travel Rule](/zh/stablecoin-account/v1.6/api-reference/create-deposit-sender)，传入该笔充值的来源地址和网络：

  ```bash theme={null}
  curl -X POST https://api-sandbox.uqpaytech.com/api/v1/ramp/wallet_address/deposit-sender \
    -H "x-auth-token: YOUR_API_TOKEN" \
    -H "x-idempotency-key: $(uuidgen | tr '[:upper:]' '[:lower:]')" \
    -H "Content-Type: application/json" \
    -d '{
      "source_address": "TLa2f6VPqDgRE67v1736s7bJ8Ray5wYjU7",
      "network": "TRX",
      "meta_data": {
        "wallet_type": "hosted",
        "address_party": "third_party",
        "beneficiary_information": {
          "entity_type": "individual",
          "first_name": "John",
          "last_name": "Doe",
          "country": "sg",
          "city": "Singapore",
          "vasp_id": "I1QNLP",
          "vasp_name": "Binance"
        }
      }
    }'
  ```

  成功时响应返回 `data: null` —— 以 `code: 200` 表示已受理。

  <h3 id="wait-for-the-deposit-to-proceed">
    等待充值继续处理
  </h3>

  信息受理后，被标记的充值即可继续处理，且同一来源地址后续的充值不会再被标记。通过[充值 webhook](/zh/stablecoin-account/v1.6/webhooks/deposit) 或 [Retrieve Deposit](/zh/stablecoin-account/v1.6/api-reference/retrieve-deposit) 跟踪订单直至完成。
</Steps>

<h2 id="how-deposit-sender-entries-are-stored">
  充值发送方记录如何存储
</h2>

充值发送方记录与提现地址簿分开存放。如需查看，调用 [List Address Book](/zh/stablecoin-account/v1.6/api-reference/list-address-book) 并传 `address_kind=deposit_sender`。用相同的 `source_address` 和 `network` 再次提交会更新已有记录，不会产生重复条目。

<h2 id="related">
  相关页面
</h2>

* [Submit Deposit Sender Travel Rule API](/zh/stablecoin-account/v1.6/api-reference/create-deposit-sender)
* [Travel Rule 合规](/zh/stablecoin-account/v1.6/guide/travel-rule-compliance) —— `meta_data` 字段规则
* [充值 webhook](/zh/stablecoin-account/v1.6/webhooks/deposit)
* [接收充值](/zh/stablecoin-account/v1.6/guide/receive-deposits)