<ph type="x-smartling-placeholder"></ph>
您正在查看 Apigee Edge 文档。
转到
Apigee X 文档。 信息
简介
借助创收功能,您可以向开发者发布针对“购买交易”的退款。假设您 您是移动运营商,并且您为开发者提供付款 API, 购买应用或应用内的内容。每当订阅者使用 API 时 这就是一次购买交易。
购买交易可能会引发退款。例如,可能无法传送相应内容 或者第三方对购买交易不满意。在这种情况下,开发者 向该第三方退款。借助创收功能,您可以进行类似的退款。这是 尤其与收益分成方案有关
假设向移动订阅者发放退款的开发者购买了收入项 共享方案假设方案要求开发者接收 购买交易的净/总价。发布退款即表示您 购买交易,也就是说,从您当月应向开发者支付的款项中扣除 70% 退款发放日期(月份可能不同于实际退款月份) 发生了购买交易)。
使用经典 Edge 界面发布退款(仅限适用于私有云的 Edge)
对于任何“成功”付款,您都可以发布退款。购买交易,也就是 但您尚未向该第三方支付全额费用 退款。发布退款会导致创建与父级的退款交易 交易 ID,其中交易 ID 是购买交易的 ID。
您可以针对原始购买交易的全额退款或 部分金额。您还可以发布多笔部分退款,但退款总金额不变 不能超过原始交易额。
要发布退款,请执行以下操作:
- 在“创收”标签页中,选择“退款”。
此操作会打开“退款”页面。
- 在“结算月份”下拉菜单中,选择发生购买交易的月份
事件。然后点击“+ 退款”。
这里会显示所选客户的所有成功购买交易 。
您可以按开发者名称或搜索实际的退款列表来过滤退款列表 交易。
要按开发者进行过滤,请从“开发者”下拉菜单中选择相应开发者。本次 仅显示与所选开发者相关的交易列表。
如需按交易 ID 过滤,请输入您之前执行的原始购买交易的交易 ID 想要退款。此操作会返回与该 ID 对应的交易。
- 在您想要退款的交易所在的行中,选中“选择”复选框。
- 在 类型 下拉菜单中选择“总计”或“部分”。
如果您选择“总计”,系统会退还购买交易的总金额。如果您选择 系统会退还所购商品的部分金额。
如果您选择“部分退款”,请在“金额”字段中输入部分退款的金额。您可以 仅退款(不超过交易总额)。如果您已经发布了部分 退款金额,您只能输入最高为交易额的剩余金额。此外,如果 原始购买交易同时包含总价和净价,您还需要说明 您要退还的部分金额是总额还是净额。
- 点击“保存”处理退款(或点击“取消”取消)。
如果结算月份仍未解除,退款将计入原始购买交易的当月 未结,否则退款将汇至当前日期。
对于部分退款,系统将根据部分金额和所有收益分成退款 。在 部分退款示例,则部分金额是总价的 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 的退款配置设置
可以在退款申请中指定以下查询参数:
名称 | 说明 | 默认 | 是否必需? |
---|---|---|---|
monetizationPackageId |
退款适用的 API 软件包。 |
不适用 | 否 |
parentTxId |
要退款的购买交易。 |
不适用 | 是 |
revenueType |
购买交易的收入类型( |
不适用 | 是 |
refundAmount |
退款金额。 |
不适用 | 是 |
transactionNote |
说明退款原因的文字备注。 |
不适用 | 是 |
后续步骤
了解如何安排与创收相关的作业以及已安排的作业 自动预定 创收职位。