取消订阅和退款

2026-02-10 08:46

取消订阅

在以下任一情况下调用 cancel 接口：

买家不想续订服务
因支付失败，商户主动终止订阅服务

成功调用 cancel 接口后，订阅周期中未支付的账单将自动失效。你可以通过 cancelRequestType 参数的值来确定取消类型：

订阅取消原因	cancelRequestType
买家发起取消订阅	`CANCEL`
因支付失败，商户主动取消订阅	`CANCEL`
因买家投诉，订阅被取消并退款	`TERMINATED`

订阅取消后，Antom 会向您发送异步通知。

以下是调用 cancel 接口的示例代码：

copy
public static void cancelSubscription() {
    AlipaySubscriptionCancelRequest alipaySubscriptionCancelRequest = new AlipaySubscriptionCancelRequest();
    // 替换为您的 subscriptionId
    alipaySubscriptionCancelRequest.setSubscriptionRequestId("34ffedef-28aa-410e-ba28-cea7376d1c5b");

    // 设置取消类型
    alipaySubscriptionCancelRequest.setCancellationType("CANCEL");

    AlipaySubscriptionCancelResponse alipaySubscriptionCancelResponse;
    try {
        alipaySubscriptionCancelResponse = CLIENT.execute(alipaySubscriptionCancelRequest);
    } catch (AlipayApiException e) {
        String errorMsg = e.getMessage();
        // 处理错误情况
    }
}

退款

如果订阅取消涉及退款（例如，因买家投诉导致退款），您可以调用 refund 接口进行处理。

退款的相关规则如下：

规则	描述
退款期限	交易完成后的 12 个月内。
手续费是否退还	是否退还手续费取决于合同约定。
部分退款	允许部分退款。
多次退款	允许多次退款。
退款汇率	如涉及跨币种结算，则使用退款申请次日的 Antom 汇率。如结算货币与定价货币相同，无需进行汇率转换。

Antom 在成功退款后不会发送异步通知。有关详情，请参阅 refund 接口，或使用 inquiryRefund 接口来确认退款结果。