APapiqik
PaymentService

POST /v1/console/payment/topup/preview

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

Request

Request body

amountMicrosstring

amount_micros 法币进路径：用户应付法币 micros（>0）。与 credits/package_id 互斥。

creditsstring

credits 自定义路径：用户想要的积分数（>0）。与 amount_micros/package_id 互斥。

currencystring
packageIdstring

package_id 套餐路径：选定的充值套餐 id（>0）。与 amount_micros/credits 互斥。

Response

OK

appliedMultiplierBpsinteger

applied_multiplier_bps 实际应用倍率（10000=1.0x）

baseCreditedMicrosstring

base_credited_micros 未加成基础入账积分（微单位，倍率/赠送前）；赠送额 = credited_micros - base_credited_micros

bonusCreditsAppliedstring

bonus_credits_applied 命中规则的赠送积分（整数积分 CRD，非 micros），未命中为 0

creditedMicrosstring

credited_micros 实际到账积分（微单位，已含倍率与赠送，前端到账展示的权威值）

currencystring
internalCreditsstring

internal_credits 实际到账内置积分（floor(credited_micros/1e6)，展示用）

matchedRuleIdstring

matched_rule_id 命中的阶梯规则 id（0=未命中）

payAmountMicrosstring

pay_amount_micros 用户应付法币（微单位，1 元 = 1,000,000 micros）

Changes

No recorded changes to this operation across all 11 revisions of this API.