退款原因

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件。 資訊

簡介

啟用營利功能後，開發人員即可針對「購買交易交易」提供退款資訊。假設您 是行動電信業者，且你提供付款 API，可讓開發人員根據 在應用程式中購買應用程式或內容。每當訂閱者使用該 API 時 「交易」就屬於購買交易交易

購買交易可能會退款。比方說，內容可能無法提交 或第三方對該筆交易不滿意。在這種情況下，開發人員 向第三方退款。啟用營利功能後，您就能進行類似的退款。這是 這與收益分潤計畫有關

假設開發人員辦理退款給行動訂閱者購買了 共用 API 產品方案假設這項方案要求開發人員將收到 70% 的廣告 購買交易的淨額/總價。發布退款即代表您生效 購買交易，也就是由開發人員針對當月應付款項，扣除 70% 的費用 退款入帳時間 (月份可能與實際結算的月份不同) 已進行購買交易)。

透過傳統版 Edge UI 發布退款 (僅限 Private Cloud 的邊緣)

您可以核發退款，任何「成功」的項目也就是 API 已成功向第三方收費，且對方尚未全額核發款項 退款。發布退款後，你將與家長建立退款交易 交易 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 的退款配置設定

您可以在退款要求中指定下列查詢參數：

後續步驟

瞭解如何排定營利相關工作的時間，以及已排定的工作 自動於排程中 營利工作。