退款、扩容与订单对账
本页内容
企业签名订单符合规则时,可以退回原付款账号的站内余额并撤销该笔订单增加的权益。安装量不足时,可另行购买设备额度。本指南分别说明退款、扩容和对账步骤。
选择要办理的业务
| 业务 | 结果 | 操作入口 |
|---|---|---|
| 退回签名套餐订单 | 符合资格时全额退回原付款账号站内余额,并撤销该笔订单增加的有效期 | 先查询订单退款资格,再确认退款 |
| 增加安装设备额度 | 购买额外安装名额,不延长签名服务期限 | 创建扩容报价,确认后付款 |
| 核对收支 | 查看原订单、余额变动和当前预算 | 订单与资金流水查询 |
前提条件
退款与扩容付款都是独立授权的敏感操作。确认 API 应用有对应权限、功能接入许可和允许的来源 IP。扩容付款还受可用余额及 API 预算限制。账号账单查询只允许在本人账号的完整授权范围内使用。
申请退款
- 从原付款回执保存订单 ID,调用 查询订单退款资格。
- 检查
eligible、deadline和拒绝原因。向使用者展示金额、金额单位、退回去向,以及将撤销该笔签名权益。 - 取得确认后,使用查询得到的原金额与单位修订号提交退款。
- 保存退款回执,并查询原订单退款状态,核对余额和当前签名期限。
Python SDK
def refund_confirmed_order(client, app_id, order_id, shown_refund,
write_key, confirmed):
if confirmed is not True or shown_refund["eligible"] is not True:
raise ValueError("请先确认退款资格、金额及撤销权益的影响")
return client.refund_order(
app_id, order_id, shown_refund["amount"],
shown_refund["currency"]["revision"], write_key,
)["data"]退款期限由平台设置,以当前订单查询结果为准。开通密钥不支持退款;按天购买是否可退取决于配置及订单资格,不能只看购买方式就认定可以退款。
退款退到原付款账号的站内余额,不是原外部支付渠道。退款不恢复已经使用的 API 付款预算,请结合 budget_restored 核对。删除应用不会自动触发退款。
购买安装量扩容
- 确认当前安装设备上限和已安装数。填写的是要增加的设备数量,不是扩容后的总上限。
- 调用 创建安装量扩容报价,保存报价 ID、数量、金额和两个修订号。
- 向使用者展示扩容前后上限,并说明扩容购买不支持退款。确认后调用 使用余额购买安装量。
- 查询原扩容报价的付款回执,再核对当前权益。
Python SDK
def prepare_capacity(client, app_id, additional_devices, quote_key):
return client.create_capacity_quote(
app_id, additional_devices, quote_key
)["data"]
def pay_confirmed_capacity(client, app_id, shown_quote, pay_key, confirmed):
if confirmed is not True:
raise ValueError("请先确认扩容数量、金额以及不支持退款的规则")
return client.pay_capacity_quote(
app_id, shown_quote["id"], shown_quote["amount"],
shown_quote["pricing_revision"], shown_quote["currency"]["revision"],
pay_key,
)["data"]扩容报价不冻结余额,且 price_reserved=false,不表示锁定价格。价格、单位或安装量条件变化时,先核对失败原因;需要新报价时重新展示并确认,不能静默更换金额后扣款。
核对订单与资金流水
查询账号订单用于查看订单状态;查询账号资金流水用于核对余额变动。保留付款回执的订单 ID、报价 ID 和金额单位,以便对账。完整订单号和 API 订单 ID用途不同,调用退款接口需使用 API 返回的 order_id。
查询账号可用余额读取可用余额,查询费用预算与剩余额度读取账号及当前 API 应用预算。财务查询权限不会自动赋予付款或退款权限。
处理响应丢失
| 原操作 | 先查询什么 |
|---|---|
| 签名套餐付款 | 原购买报价 查询购买报价及付款结果中的付款回执。 |
| 扩容付款 | 原扩容报价 查询扩容报价及付款回执中的付款回执。 |
| 退款 | 原订单 查询订单退款资格中的退款状态及回执。 |
先确认原操作是否已经完成。同一次操作重试使用原请求和原幂等键;不要因页面没有收到响应就生成新键、换订单或再次扣款。当前资格与金额发生变化时,应重新展示并确认业务内容。
相关接口
- 查询订单退款资格GET
/api/v1/apps/{app_id}/orders/{order_id}/refund - 确认退款并撤销签名权益POST
/api/v1/apps/{app_id}/orders/{order_id}/refund - 创建安装量扩容报价POST
/api/v1/apps/{app_id}/capacity-quotes - 查询扩容报价及付款回执GET
/api/v1/apps/{app_id}/capacity-quotes/{quote_id} - 使用余额购买安装量POST
/api/v1/apps/{app_id}/capacity-quotes/{quote_id}/pay - 查询账号可用余额GET
/api/v1/billing/balance - 查询费用预算与剩余额度GET
/api/v1/billing/budget - 查询账号订单GET
/api/v1/billing/orders - 查询账号资金流水GET
/api/v1/billing/ledger