应用如何接入退款及常见问题
=============

#### 问题现象

1.  用户购买虚拟数字商品后需要退款如何申请，开发者可以在哪儿处理退款申请，整个IAP退款的流程是怎样的？
2.  开发者如何在应用内接入退款入口以及用户申请退款后服务器是否会收到退款相关的事件通知？
3.  沙盒环境下，发起退款申请，服务端接收不到退款申请事件通知仅有退款成功事件通知？
4.  应用的用户发起退款申请后，如何核对退款金额，是否有可以查询退款金额的方式？
5.  用户退款申请通过并成功退款后，应用服务端未收到退款成功回调，如何解决？

#### 背景知识

*   退款主要分为两部分：[开发者审核退款订单](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/iap-refund#开发者审核退款订单)和[用户申请退款](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/iap-refund#用户申请退款)。
*   [应用内接入退款入口](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/iap-refund#应用内接入退款入口)：应用中通过接口的方式拉起退款界面，仅支持非游戏类应用接入和应用本身所产生的订单的退款。
*   [接收退款申请事件通知](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-server-refund-receive-notify)：用户申请退款时，IAP服务器调用此接口向开发者服务器发送退款审核事件通知。

#### 解决方案

1.  用户和开发者可以分别通过如下的途径去申请和处理退款：
    
    用户侧：
    
    *   IAP订单退款设备侧操作入口：设置-华为账号-付款与账单-购买记录-详情-对订单有疑问-申请退款；
    *   或者通过设置-华为账号-付款与账单-帮助和反馈，通过客服申请退款。开发者侧：
    *   开发者登录[AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/)，选择“App与元服务”，在“运营”页签下，点击“产品运营>退款管理”，查看用户提交的退款申请，处理退款订单，退款申请后到退款完成非实时，一般从发起申请退款到完成需要7个工作日左右。

2.  用户发起退款后，应用客户端可以调用[iap.createRefundRequest](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-iap#iapcreaterefundrequest)接口传入退款的订单号（purchaseOrderId）从而拉起退款页面完成退款申请。同时开发者服务器会收到[NotificationType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-key-event-notifications#notificationtype)对应字段是：REVOKE的退款事件通知，完成退款后则会收到[NotificationSubtype](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-key-event-notifications#notificationsubtype)对应字段是REFUND\_TRANSACTION的退款成功事件通知。
3.  沙盒环境下订单退款不支持退款申请事件通知，用户提交退款请求后，IAP会跳过退款审核流程，直接完成退款，同时给开发者服务器发送[NotificationSubtype](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-key-event-notifications#notificationsubtype)对应字段是REFUND\_TRANSACTION的退款成功事件通知。
4.  IAP提供了两种方式让开发者来查询到用户退款相关信息：
    *   服务端API查询：用户申请退款后，IAP服务器会向开发者服务器发起请求，请求中会携带[RefundRequestData](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-server-refund-receive-notify#refundrequestdata)结构体，该结构体中的applyAmount字段就说明了用户申请的退款金额（单位：分），除此外还有refundReason（用户申请退款理由）和refundOrders（退款申请工单下的订单号）等参数。
    *   AGC管理台查询退款信息：开发者登录AppGallery Connect，选择“App与元服务”，在“运营”页签下，点击“产品运营>退款管理”，查看用户提交的退款申请，处理退款订单。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/8e/v3/qsnPN-xHSTWbiXQcPFFclg/zh-cn_image_0000002628394574.png?HW-CC-KV=V1&HW-CC-Date=20260709T134323Z&HW-CC-Expire=86400&HW-CC-Sign=F6154B34101B1C0F8492E556D742734C36B450457B1C53B3C76053A556015E92 "点击放大")
        

5.  检查开发者在AppGallery Connect配置的通知版本是否设置为v3，配置的接收退款申请事件通知服务器地址是否有修改、变更等情形，有变动可以通过[测试服务通知](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-server-notifications-test)验证是否可以调用成功，除此外https证书失效或者不符合要求也会出现该问题。

#### 常见FAQ

Q：消耗型商品是否可以退款？

A：可以的，虚拟数字商品退款不限制商品类型。

Q：订阅商品升级购买后，产生多笔订单，订单申请退款，退款逻辑是怎么样的？

A：按照每笔订单金额申请退款，审核通过后，将按开发者输入退款金额（小于等于订单金额）退至用户账户。

Q：沙箱环境下订阅类型的订单退款，有的时候会收到退款成功的事件通知，有的时候收不到事件通知，且和订单购买时间会相差较大？

A：沙盒环境下的订阅续订时间会比正常情况更快，引入“时光机”概念，沙盒环境中的订阅换算时间为10秒/天，沙箱环境下订阅类型商品过期后，半个小时后就会清理掉订阅关系，此时再来退款，就不会发送通知。请在未过保留期之前进行操作。以免订阅已经过了保留期订阅关系已经清除。

Q：“返回退款审核结果”接口和“处理退款订单”功能是什么关系，用户申请了退款，AGC管理界面上操作退款审核了，还需要再通过接口通知华为的IAP服务器吗？

A：需要的，审核同意退款后，华为财务系统会发起原路退回款项流程，但是款项不会实时退回给用户，请勿在审核退款后直接回收用户权益，具体的权益回收时间建议以华为服务器发送的订单退款/撤销订阅事件通知为准。

Q：华为开发者账号登录AppGallery Connect管理台后看不到退款管理功能，如何解决？

A：开发者使用退款管理功能，需要拥有至少一个具备退款权限的角色：账号持有者、管理员、App管理员、财务。具体可查看[添加成员账号](https://developer.huawei.com/consumer/cn/doc/app/agc-help-manageaccount-0000001099996700#section151241455193313)。