> ## 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.

# 充值

[稳定币账户API发布者免责声明](/zh/stablecoin-account/v1.6/guide/stablecoin-account-api-publisher-disclaimer)

**事件元数据**

* **name**：`DEPOSIT`
* **types**：
  * `ramp.deposit.pending` – 充值待确认
  * `ramp.deposit.success` – 充值成功
  * `ramp.deposit.failed` – 充值失败

**请求体**

| 字段          | 类型     | 描述     |
| ----------- | ------ | ------ |
| event\_id   | string | 事件唯一ID |
| event\_name | string | 事件名称   |
| event\_type | string | 事件类型   |
| source\_id  | string | 订单ID   |
| version     | string | API版本  |
| data        | object | 充值详情对象 |

`data` 对象可能额外包含 `need_travel_rule`：

| 字段                 | 类型      | 描述                                                                                                                                                                                                                                          |
| ------------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| need\_travel\_rule | boolean | 仅当该笔充值确需补填来源 Travel Rule 才能继续处理时出现且为 `true`。收到 `true` 时，请以该笔充值的 `from_address` 作为 `source_address`，通过 [Submit Deposit Sender Travel Rule](/zh/stablecoin-account/v1.6/api-reference/create-deposit-sender) 提交来源方的 Travel Rule 数据。其余情况省略该字段。 |

**通知示例**

```json theme={null}
{
  "version": "V1.6.0",
  "event_name": "DEPOSIT",
  "event_type": "ramp.deposit.pending",
  "event_id": "38614827-7666-4c0c-abae-cc3abef24903",
  "source_id": "eda7be90-8fbc-444c-b747-542faf5d3e10",
  "data": {
    "amount": "10",
    "complete_time": "0001-01-01 00:00:00 +0000 UTC",
    "create_time": "2026-02-27 10:19:19 +0800 CST",
    "currency": "USDC",
    "fee": "0",
    "from_address": "0x303039d7632c7341c681e889ea0073c3af1a2f6a",
    "network": "ETH",
    "order_id": "eda7be90-8fbc-444c-b747-542faf5d3e10",
    "order_status": "Pending",
    "reason": "test-remark",
    "short_order_id": "DP260227-QZOXQND1",
    "transaction_type": "Deposit",
    "txid": "0x65590ef2a2ef1902f3644da38b19eaf4b953831c0deaac73cadce02ee356d5d1",
    "need_travel_rule": true
  }
}
```