跳转到主要内容
1签 (OneSign)

退款、扩容与订单对账

本页内容

企业签名订单符合规则时,可以退回原付款账号的站内余额并撤销该笔订单增加的权益。安装量不足时,可另行购买设备额度。本指南分别说明退款、扩容和对账步骤。

选择要办理的业务

业务结果操作入口
退回签名套餐订单符合资格时全额退回原付款账号站内余额,并撤销该笔订单增加的有效期先查询订单退款资格,再确认退款
增加安装设备额度购买额外安装名额,不延长签名服务期限创建扩容报价,确认后付款
核对收支查看原订单、余额变动和当前预算订单与资金流水查询

前提条件

退款与扩容付款都是独立授权的敏感操作。确认 API 应用有对应权限、功能接入许可和允许的来源 IP。扩容付款还受可用余额及 API 预算限制。账号账单查询只允许在本人账号的完整授权范围内使用。

申请退款

  1. 从原付款回执保存订单 ID,调用 查询订单退款资格。
  2. 检查 eligible、deadline 和拒绝原因。向使用者展示金额、金额单位、退回去向,以及将撤销该笔签名权益。
  3. 取得确认后,使用查询得到的原金额与单位修订号提交退款。
  4. 保存退款回执,并查询原订单退款状态,核对余额和当前签名期限。
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 核对。删除应用不会自动触发退款。

购买安装量扩容

  1. 确认当前安装设备上限和已安装数。填写的是要增加的设备数量,不是扩容后的总上限。
  2. 调用 创建安装量扩容报价,保存报价 ID、数量、金额和两个修订号。
  3. 向使用者展示扩容前后上限,并说明扩容购买不支持退款。确认后调用 使用余额购买安装量。
  4. 查询原扩容报价的付款回执,再核对当前权益。
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 应用预算。财务查询权限不会自动赋予付款或退款权限。

处理响应丢失

原操作先查询什么
签名套餐付款原购买报价 查询购买报价及付款结果中的付款回执。
扩容付款原扩容报价 查询扩容报价及付款回执中的付款回执。
退款原订单 查询订单退款资格中的退款状态及回执。

先确认原操作是否已经完成。同一次操作重试使用原请求和原幂等键;不要因页面没有收到响应就生成新键、换订单或再次扣款。当前资格与金额发生变化时,应重新展示并确认业务内容。

相关接口