---
title: "创建充值订单"
method: POST
path: "/v1/console/payment/topup"
tags: ["PaymentService"]
---

# 创建充值订单

`POST /v1/console/payment/topup`

创建充值订单并返回支付跳转地址。

## Request body

- PaymentV1CreateTopupRequest — CreateTopup
  - `amountMicros` string — amount_micros 法币进路径：用户应付法币 micros（>0），按 internal_credit_rates 基础单价换算积分。与 credits/package_id 互斥。
  - `credits` string — credits 自定义路径：用户想要的积分数（>0）。与 amount_micros/package_id 互斥。
  - `currency` string
  - `packageId` string — package_id 套餐路径：选定的充值套餐 id（>0）。与 amount_micros/credits 互斥。
  - `provider` string — provider 支付渠道：alipay/wechat/stripe
  - `returnUrl` string — return_url 用户支付完成/取消后浏览器回跳的前端页面地址（绝对 URL）。 Stripe Checkout 强制要求 success_url：前端应传本字段；为空时后端按 public_base_url 兜底。

## Response `200`

OK

- PaymentV1CreateTopupReply
  - `order` PaymentV1TopupOrderInfo — TopupOrderInfo 充值订单信息
    - `amountMicros` string — amount_micros 充值金额（微单位，1 元 = 1,000,000 micros）
    - `createdAt` string, date-time
    - `creditedMicros` string — credited_micros 实际到账金额（微单位，扣除手续费后）
    - `currency` string
    - `id` string
    - `internalCredits` string — internal_credits 实际入账的内置积分（floor(credited_micros/1e6)，展示用）
    - `invoiceId` string — invoice_id 关联发票 id（有效票或最新已红冲票；0=无关联票；是否可申请以 invoice_status 为准）
    - `invoiceStatus` string — invoice_status 该订单开票状态：none=可开票/未开 not_invoiceable=不可开票 pending=申请中 approved=已审核 issued=已开具 reversed=已红冲 （有效/最新红冲发票投影优先；无发票时由订单状态与支付来源决定；1-3-4 购买历史列）。
    - `paidAt` string, date-time
    - `payMode` string — pay_mode 支付交互方式：redirect=跳转 pay_url qrcode=将 pay_url 渲染为二维码扫码支付。 仅创建订单时有值；历史订单查询为空。
    - `payUrl` string — pay_url 支付载荷：pay_mode=redirect 时为可跳转 URL；pay_mode=qrcode 时为二维码内容 （如微信 Native 的 weixin://wxpay/...），前端需渲染成二维码供用户扫码，不能跳转。
    - `provider` string — provider 订单来源：alipay/wechat/stripe；历史记录还可能为 redeem_code（不可退款、不可开票）
    - `status` string — status 订单状态：pending=待支付 paid=已支付 failed=失败 closed=已关闭 refunding=退款中 refunded=已退款
    - `tradeNo` string — trade_no 交易流水号（业务侧生成，唯一）
  - `payMode` string — pay_mode 支付交互方式：redirect=跳转 pay_url（支付宝网页/Stripe Checkout） qrcode=pay_url 是二维码内容（微信 Native 的 weixin://wxpay/...），前端渲染二维码扫码支付。
  - `payUrl` string — pay_url 支付载荷：pay_mode=redirect 时前端跳转；pay_mode=qrcode 时前端渲染二维码。

---

[API](https://skmtc.dev/apiqik/apis/apiqik-api.md) · [All operations](https://skmtc.dev/apiqik/apis/apiqik-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apiqik/apiqik-api/revisions/e06b96127408/schema)