> ## 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. # Create Withdraw > 发起加密货币提现请求。当目的地址路由至 Binance 渠道时，若该地址簿条目缺少 Travel Rule 数据，提现将被拒绝；请先通过 Update Address Book 补录。[ *Stablecoin Account API 发布方免责声明*](/zh/stablecoin-account/v1.6/guide/stablecoin-account-api-publisher-disclaimer) ## OpenAPI ````yaml /zh/stablecoin-account/v1.6/ramp.yaml post /v1/ramp/withdraw openapi: 3.0.2 info: title: Stablecoin Account API version: 1.0.4 x-source-en-commit: 4413eca x-source-en-path: stablecoin-account/v1.6/ramp.yaml description: | UQPAY Stablecoin Account API 为法币与加密货币的兑换提供全面的稳定币账户管理与支付解决方案，实现完整的资金流转闭环能力。 ## 核心功能 - 资产管理：查询并管理多币种的钱包余额 - 法币转账：在 Stablecoin Account 与 Global Account 系统之间划转资金 - 货币兑换：基于实时报价的加密货币与法币双向兑换 - 加密货币充值：通过地址管理接收加密货币充值 - 加密货币提现：发起并跟踪加密货币提现 ## 身份验证 调用 UQPAY API 时，使用 API 密钥对客户端请求进行身份验证。 API 密钥是用于验证用户身份、授予特权操作访问权限的唯一数据字符串。 请始终对 API 密钥保密并妥善保管。 ## 快速开始 1. 获取 API 凭证（x-client-id 和 x-api-key） 2. 通过 POST /api/v1/connect/token 请求 Access Token 3. 使用沙盒 URL 搭建测试环境 4. 通过 x-auth-token 请求头实现身份验证 5. 从基础操作开始 ## 技术支持 如需技术支持与集成协助，请联系 UQPAY 支持团队。 contact: name: UQPAY Support url: https://www.uqpay.com/support email: ramp.tech@uqpay.com license: name: Proprietary url: https://www.uqpay.com/legal/api-terms termsOfService: https://www.uqpay.com/legal/terms x-api-id: ramp-api-v1.0.0 x-logo: url: https://uqpay.com/img/UQPAY_LogoAnimv2.gif backgroundColor: '#FFFFFF' altText: UQPAY Logo x-categories: - Stablecoin Account - Payment Processing - Cryptocurrency - Fiat Exchange servers: - url: https://api-sandbox.uqpaytech.com/api description: 沙盒环境基础 URL。 - url: https://api.uqpay.com/api description: 生产环境基础 URL。 security: [] tags: - name: Assets description: 管理稳定币钱包账户，并查询不同币种的余额。 - name: Transfer (Out/In) description: 在 Stablecoin Account 与 Global Account 系统之间划转资金。 - name: Conversions description: 在加密货币与法币之间执行货币兑换。 - name: Deposits description: 管理加密货币充值地址并跟踪充值交易。 - name: Withdrawals description: 创建并管理加密货币提现请求。 - name: Configuration description: 查询支持的资产、网络与系统配置。 - name: Address Book description: 管理用于提现的钱包地址簿条目。 - name: Travel Rule description: 用于为地址簿条目填充 Travel Rule 受益人信息的参考数据（VASP、国家、地区）。 paths: /v1/ramp/withdraw: post: tags: - Withdrawals summary: Create Withdraw description: >- 发起加密货币提现请求。当目的地址路由至 Binance 渠道时，若该地址簿条目缺少 Travel Rule 数据，提现将被拒绝；请先通过 Update Address Book 补录。[ *Stablecoin Account API 发布方免责声明*](/zh/stablecoin-account/v1.6/guide/stablecoin-account-api-publisher-disclaimer) operationId: create-withdraw parameters: - $ref: '#/components/parameters/XOnBehalfOf' - $ref: '#/components/parameters/XIdempotencyKey' requestBody: content: application/json: schema: $ref: '#/components/schemas/WithdrawCreateRequest' responses: '200': headers: x-response-id: $ref: '#/components/headers/XResponseId' description: 成功创建提现 content: application/json: schema: $ref: '#/components/schemas/WithdrawCreateResponse' title: WithdrawCreateResponse security: - XAuthToken: [] externalDocs: description: API 发布方免责声明 – UQPAY Australia url: >- /stablecoin-account/v1.6/guide/stablecoin-account-api-publisher-disclaimer components: parameters: XOnBehalfOf: in: header name: x-on-behalf-of schema: type: string required: false description: > 指定代表哪个子账户发起请求。应设置为 `account_id`，可通过 List Connected Accounts 接口获取。若省略或为空，则请求以主账户身份执行。 更多信息参见 Connected Accounts。 example: 18523f72-f4de-4f9c-bb8e-ec7d1c4f32be XIdempotencyKey: in: header name: x-idempotency-key schema: type: string format: uuid required: false description: >- 用于保持操作幂等性的唯一标识符（UUID），确保同一操作的重复执行不会产生非预期的影响或重复。在网络错误、重试或失败的情况下，它有助于保持数据一致性。 example: 2adef8e0-9d63-44bc-b975-9b6ae3440dde schemas: WithdrawCreateRequest: type: object required: - currency - network - amount - withdraw_address - reason properties: currency: type: string description: 提现币种 example: USDC network: type: string description: 网络代码 example: ETH amount: type: string description: 提现金额 example: '100' withdraw_address: type: string description: 提现地址 example: '0x0993446fBB19f4e828768515eF7A9408B5F1A000' memo: type: string description: 提现 Memo example: test reason: type: string description: 提现原因 example: test WithdrawCreateResponse: type: object required: - code - message - data properties: code: type: integer example: 200 message: type: string example: Success data: $ref: '#/components/schemas/WithdrawCreateData' WithdrawCreateData: description: 创建提现的响应数据（4.5.1）- 13 个字段 allOf: - $ref: '#/components/schemas/WithdrawBase' WithdrawBase: type: object description: 所有提现响应共用字段的基础 schema required: - order_id - short_order_id - order_status - order_type - currency - network - amount - withdraw_address - network_fee - processing_fee - actual_amount - reason - create_time properties: order_id: type: string format: uuid description: 订单 ID（长） example: f75fdee5-0cc1-4b52-818e-497dd376cced short_order_id: type: string description: 订单 ID（短） example: WD260124-N1PAAIXX order_status: type: string description: 订单状态 enum: - Pending - Success - Failed example: Pending order_type: type: string description: 订单类型 example: Withdraw currency: type: string description: 提现币种 example: USDC network: type: string description: 网络代码 example: ETH amount: type: string description: 提现金额 example: '100' withdraw_address: type: string description: 提现地址 example: '0x0993446fBB19f4e828768515eF7A9408B5F1A000' network_fee: type: string description: 网络费 example: '0.66' processing_fee: type: string description: 手续费 example: '0' actual_amount: type: string description: 实际到账金额 example: '99.34' reason: type: string description: 提现原因 example: test create_time: type: string description: 创建时间 example: '2026-01-24 11:41:37 +08:00' headers: XResponseId: description: 响应的通用唯一标识符（UUID v4）。在与 UQPAY 支持团队沟通时，有助于定位某次请求。 schema: type: string format: uuid example: 2adba88e-9d63-44bc-b975-9b6ae3440dde securitySchemes: XAuthToken: type: apiKey in: header name: x-auth-token description: UQPay 提供的用于登录的 API Token。 ````