退款后退款

<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 软件包的标识。 。

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

• 要退款的购买交易的标识。
• 购买交易的收入类型（GROSS 或 NET）。
• 退款金额。
• 说明退款原因的备注。

或者，您也可以将接收退款的 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 的退款配置设置

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

后续步骤

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