退款后退款

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档
信息

简介

借助创收功能,您可以向开发者发布针对“购买交易”的退款。假设您 您是移动运营商,并且您为开发者提供付款 API, 购买应用或应用内的内容。每当订阅者使用 API 时 这就是一次购买交易。

购买交易可能会引发退款。例如,可能无法传送相应内容 或者第三方对购买交易不满意。在这种情况下,开发者 向该第三方退款。借助创收功能,您可以进行类似的退款。这是 尤其与收益分成方案有关

假设向移动订阅者发放退款的开发者购买了收入项 共享方案假设方案要求开发者接收 购买交易的净/总价。发布退款即表示您 购买交易,也就是说,从您当月应向开发者支付的款项中扣除 70% 退款发放日期(月份可能不同于实际退款月份) 发生了购买交易)。

使用经典 Edge 界面发布退款(仅限适用于私有云的 Edge)

对于任何“成功”付款,您都可以发布退款。购买交易,也就是 但您尚未向该第三方支付全额费用 退款。发布退款会导致创建与父级的退款交易 交易 ID,其中交易 ID 是购买交易的 ID。

您可以针对原始购买交易的全额退款或 部分金额。您还可以发布多笔部分退款,但退款总金额不变 不能超过原始交易额。

要发布退款,请执行以下操作:

  1. 在“创收”标签页中,选择“退款”。

    此操作会打开“退款”页面。

  2. 在“结算月份”下拉菜单中,选择发生购买交易的月份 事件。然后点击“+ 退款”。

    这里会显示所选客户的所有成功购买交易 。

    您可以按开发者名称或搜索实际的退款列表来过滤退款列表 交易。

    要按开发者进行过滤,请从“开发者”下拉菜单中选择相应开发者。本次 仅显示与所选开发者相关的交易列表。

    如需按交易 ID 过滤,请输入您之前执行的原始购买交易的交易 ID 想要退款。此操作会返回与该 ID 对应的交易。

  3. 在您想要退款的交易所在的行中,选中“选择”复选框。
  4. 在 类型 下拉菜单中选择“总计”或“部分”。

    如果您选择“总计”,系统会退还购买交易的总金额。如果您选择 系统会退还所购商品的部分金额。

    如果您选择“部分退款”,请在“金额”字段中输入部分退款的金额。您可以 仅退款(不超过交易总额)。如果您已经发布了部分 退款金额,您只能输入最高为交易额的剩余金额。此外,如果 原始购买交易同时包含总价和净价,您还需要说明 您要退还的部分金额是总额还是净额。

  5. 点击“保存”处理退款(或点击“取消”取消)。

    如果结算月份仍未解除,退款将计入原始购买交易的当月 未结,否则退款将汇至当前日期。

    对于部分退款,系统将根据部分金额和所有收益分成退款 。在 部分退款示例,则部分金额是总价的 0.50/1.12 = 总价的 45%,因此 我们将扣除 45% 的开发者收益分成。

在界面中检查是否已退款 已处理

您可以选择顶部的结算月份,确定退款是否已处理 “退款”页面如果结算月份尚未结束,则表示该月份是购买月份,或者 如果结算月份已结束,则会在当月结束。这一列显示了所有已完成的退款 发布了信息。

使用 API 发布退款

要发布退款,请向以下地址发出 POST 请求: /organizations/{org_name}/monetization-packages/{package_id}/refund-transactions, 其中 {package_id} 是接收退款的 API 软件包的标识。 。

发出请求时,需要将以下内容指定为查询参数:

  • 要退款的购买交易的标识。
  • 购买交易的收入类型(GROSSNET)。
  • 退款金额。
  • 说明退款原因的备注。

或者,您也可以将接收退款的 API 软件包标识为网址参数 。

如需查看完整的网址列表,请参阅退款配置设置 参数。

例如,以下请求针对某笔购买交易办理退款。退款 是购买交易总额的 50%。

$ curl -H "Content-Type:application/json" -X POST \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/payment/refund-transactions?revenueType=GROSS&refundAmount=0.5&parentTxId=abf50909-2492-4bf5-8704-ade05f4d43b3&transactionNote=Refund for purchase transaction" \
-u email:password

响应应类似如下所示(仅显示部分响应):

{
  "application" : {
    ...
    },
    "product" : [ {
      ...
      
     {
      "customAtt1Name" : "user",
      "description" : "Payment",
      "displayName" : "Payment",
      "id" : "payment",
      "name" : "payment",
      "organization" : {
        ...
      },
      "status" : "CREATED",
      "transactionSuccessCriteria" : "Status=='200 OK'"
    } ],
    ...
  },
  "currency" : "USD",
  "developer" : {
    ...
    "legalName" : "DEV ONE",
    "name" : "Dev One",
    "organization" : {
      ...
    },
    ...
  },
  "endTime" : "2013-09-01 21:59:59",
  "environment" : "PROD",
  "euroExchangeRate" : 0.8123,
  "gbpExchangeRate" : 0.6910,
  "grossPrice" : 0.5,
  "id" : "61f7eb88-f8cc-4cda-afd8-4a61fba3dd33",
  "isRevOnGrossOrNet" : "NET",
  "isVirtualCurrency" : false,
  "notes" : "Refund for purchase transaction",
  "itemDesc" : "test application",
  "netPrice" : 0.4464,
  "orgRevenueShareAmount" : 0.1339,
  "parentId" : "abf50909-2492-4bf5-8704-ade05f4d43b3",
  "pkgId" : "myorg@@@payment",
  "pkgRatePlanProductName" : "Payment",
  ...
  },
  "ratePlanLevel" : "STANDARD",
  "revenueShareAmount" : 0.3125,
  "startTime" : "2013-09-01 21:59:59",
  "status" : "SUCCESS",
  "tax" : 0.0536,
  "taxModel" : "UNDISCLOSED",
  "txProviderStatus" : "SUCCESS",
  "type" : "REFUND",
  "usdExchangeRate" : 1.0724,
  "utcEndTime" : "2013-09-01 21:59:59",
  "utcStartTime" : "2013-09-01 21:59:59"
}

API 的退款配置设置

可以在退款申请中指定以下查询参数:

名称 说明 默认 是否必需?
monetizationPackageId

退款适用的 API 软件包。

不适用
parentTxId

要退款的购买交易。

不适用
revenueType

购买交易的收入类型(GROSSNET) 交易。

不适用
refundAmount

退款金额。

不适用
transactionNote

说明退款原因的文字备注。

不适用

后续步骤

了解如何安排与创收相关的作业以及已安排的作业 自动预定 创收职位