---
title: "POST /v1/console/payment/topup/preview"
method: POST
path: "/v1/console/payment/topup/preview"
tags: ["PaymentService"]
---

# POST /v1/console/payment/topup/preview

`POST /v1/console/payment/topup/preview`

PreviewTopup 充值预览：输入金额返回到账积分 + 阶梯赠送报价（不下单、不调支付）。

## Request body

- PaymentV1PreviewTopupRequest — PreviewTopup 充值预览：与 CreateTopupRequest 同构但不需要 provider（不实际下单）。
  - `amountMicros` string — amount_micros 法币进路径：用户应付法币 micros（>0）。与 credits/package_id 互斥。
  - `credits` string — credits 自定义路径：用户想要的积分数（>0）。与 amount_micros/package_id 互斥。
  - `currency` string
  - `packageId` string — package_id 套餐路径：选定的充值套餐 id（>0）。与 amount_micros/credits 互斥。

## Response `200`

OK

- PaymentV1PreviewTopupReply — PreviewTopupReply 报价结果，供前端展示「应付 / 到账 / 赠送」。
  - `appliedMultiplierBps` integer — applied_multiplier_bps 实际应用倍率（10000=1.0x）
  - `baseCreditedMicros` string — base_credited_micros 未加成基础入账积分（微单位，倍率/赠送前）；赠送额 = credited_micros - base_credited_micros
  - `bonusCreditsApplied` string — bonus_credits_applied 命中规则的赠送积分（整数积分 CRD，非 micros），未命中为 0
  - `creditedMicros` string — credited_micros 实际到账积分（微单位，已含倍率与赠送，前端到账展示的权威值）
  - `currency` string
  - `internalCredits` string — internal_credits 实际到账内置积分（floor(credited_micros/1e6)，展示用）
  - `matchedRuleId` string — matched_rule_id 命中的阶梯规则 id（0=未命中）
  - `payAmountMicros` string — pay_amount_micros 用户应付法币（微单位，1 元 = 1,000,000 micros）

---

[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)