> ## 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 Transfer > 发起 Stablecoin Account 法币资金转出至 Global Account（类型 transfer-out：4001）； 发起 Global Account 法币资金转入至 Stablecoin Account（类型 transfer-in：4000）。 [ *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/transfer 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/transfer: post: tags: - Transfer (Out/In) summary: Create Transfer description: > 发起 Stablecoin Account 法币资金转出至 Global Account（类型 transfer-out：4001）； 发起 Global Account 法币资金转入至 Stablecoin Account（类型 transfer-in：4000）。 [ *Stablecoin Account API 发布方免责声明*](/zh/stablecoin-account/v1.6/guide/stablecoin-account-api-publisher-disclaimer) operationId: create-transfer parameters: - $ref: '#/components/parameters/XOnBehalfOf' - $ref: '#/components/parameters/XIdempotencyKey' requestBody: content: application/json: schema: $ref: '#/components/schemas/TransferCreateRequest' responses: '200': headers: x-response-id: $ref: '#/components/headers/XResponseId' description: 成功创建转账 content: application/json: schema: $ref: '#/components/schemas/TransferCreateResponse' title: TransferCreateResponse 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: TransferCreateRequest: type: object required: - currency - amount - type properties: currency: type: string description: 本次转出/转入的钱包币种 example: USD amount: type: string description: 本次转出/转入的金额 example: '100.50' type: type: integer description: 转出：4001；转入：4000 example: 4001 reason: type: string description: 交易备注 example: Business transfer TransferCreateResponse: type: object required: - code - message - data properties: code: type: integer example: 200 message: type: string example: Success data: $ref: '#/components/schemas/TransferCreateData' TransferCreateData: type: object description: 创建转账的响应（第 4.2.1 节） required: - order_id - short_order_id - order_status - order_type - amount - currency - processing_fee - create_time properties: order_id: type: string description: 订单 ID（长格式） example: 3c9e22ba-7b5e-4b7c-b92e-197d0406b86b short_order_id: type: string description: 订单 ID（短格式） example: TO260123-JZBHC9IA order_status: type: string description: 订单状态 enum: - Submitted - Pending - Failed - Success - Submit Failed example: Pending order_type: type: string description: 订单类型 example: Transfer Out amount: type: number format: decimal description: 金额 example: 100 currency: type: string description: 币种 example: USD processing_fee: type: number format: decimal description: 手续费 example: 0 reason: type: string description: 备注 example: testAPI create_time: type: string description: 创建时间 example: '2026-01-23 13:12:27 +08:00' complete_time: type: string description: 完成时间 example: '' message: type: string description: 请求失败时的失败原因 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。 ````