> ## 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**：`CONVERSION`
* **types**：
  * `ramp.conversion.trade.pending` – 换汇进行中
  * `ramp.conversion.trade.completed` – 换汇成功
  * `ramp.conversion.trade.failed` – 换汇失败

**请求体**

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

**通知示例**

* 结构与 `Retrieve Conversion` API响应一致。

```json theme={null}
{
  "version": "V1.6.0",
  "event_name": "CONVERSION",
  "event_type": "ramp.conversion.trade.pending",
  "event_id": "9f02664f-e30a-43dd-8904-35bb7806c79c",
  "source_id": "2031debb-8ac5-4dc9-add5-02ebd1aa36da",
  "data": {
    "buy_amount": "98.06",
    "buy_currency": "USD",
    "complete_time": "",
    "conversion_id": "2031debb-8ac5-4dc9-add5-02ebd1aa36da",
    "conversion_status": "Pending",
    "create_time": "2026-03-03 10:10:04 +0800 CST",
    "network_fee": "0",
    "processing_fee": "0",
    "quote_price": "0.899712",
    "reason": "test",
    "sell_amount": "109",
    "sell_currency": "USDC",
    "short_conversion_id": "ES260303-V77NUZPN"
  }
}
```