购买分发套餐
本页内容
根据当前应用可用的套餐创建报价,再由使用者确认后通过余额付款。参考价格用于展示,实际付款使用已创建的有效报价。
前提条件
已有普通分发应用和对应报价、付款权限,并满足账号功能、来源 IP及预算条件。读取价格不会扣费,只有明确确认付款才会使用余额。
选择可用套餐
先查询当前应用的价格表,使用返回的分发 SKU,按金额单位展示下载点数或会员服务内容。不要套用企业签名套餐的 SKU。估价接口只用于参考,实际购买需创建报价。
创建并展示报价
为本次报价保存幂等键,取得报价 ID、金额、单位及价格修订号。向使用者展示具体服务和有效期,检查 expires_at。创建报价不冻结余额。
Python SDK
def prepare_purchase(client, app_id, sku, quote_key, days=None):
return client.create_purchase_quote(
app_id, sku, quote_key, days=days
)["data"]
def pay_confirmed_purchase(client, app_id, shown_quote, pay_key, confirmed):
if confirmed is not True:
raise ValueError("请先向使用者展示报价并取得付款确认")
# 使用已展示并确认的原报价,不能在付款前悄悄替换金额或单位。
return client.pay_purchase_quote(
app_id, shown_quote["id"], shown_quote["amount"],
shown_quote["pricing_revision"], shown_quote["currency"]["revision"],
pay_key,
)["data"]确认付款
取得确认后,使用已展示的原报价金额、价格修订号和单位修订号付款。报价创建与付款是两次独立写操作,分别保存幂等键。金额保留十进制字符串,不转换为浮点数重新计算。
确认到账与恢复
保存付款回执,并查询原报价的 receipt 与 order_id。请求超时先核对原结果,不换报价重复付款。价格或单位变化时重新展示并确认,不能静默替换。
订单和流水核对见账号账单指南。企业签名退款、密钥核销和安装量扩容不适用于普通分发。