查询订阅相关信息

2026-05-29 07:43

订阅确认后，您可以查询以下订阅信息：

查询订阅列表：您可以通过 inquireSubscriptionList 接口查询符合特定筛选条件的订阅列表。
查询订阅详情：您可以使用 subscriptionId 调用 inquireSubscription 接口来获取订阅详情。
查询订阅交易信息：您可以使用 subscriptionId 调用 inquireSubscriptionPayment 接口来获取订阅交易的列表信息。

查询订阅列表

您可以通过 inquireSubscriptionList 接口查询符合特定筛选条件的订阅列表。调用成功后，接口将返回每个订阅的详细信息，包括其状态、计费周期、金额等。这有助于您更好地管理和访问订阅数据。此接口支持分页功能。

以下示例代码展示了如何调用 inquireSubscriptionList 接口：

copy
public static void inquireSubscriptionList() {
    AlipayInquireSubscriptionListRequest request = new AlipayInquireSubscriptionListRequest();
    request.setStartTimeFrom("2026-03-31T00:32:28+08:00");
    request.setStartTimeTo("2026-03-31T23:32:28+08:00");
    request.setStatuses(Arrays.asList(
            SubscriptionStatus.ACTIVE,
            SubscriptionStatus.CANCELLED,
            SubscriptionStatus.TERMINATED
    ));
    request.setPaymentMethodTypes(Arrays.asList("GCASH", "CARD"));
    request.setCurrencies(Arrays.asList("PHP", "USD", "SGD"));
    request.setPeriodTypes(Arrays.asList(PeriodType.YEAR));
    request.setCurrentPage(1);
    request.setPageSize(10);

    AlipayInquireSubscriptionListResponse response = null;
    try {
        response = CLIENT.execute(request);
    } catch (AlipayApiException e) {
        String errorMsg = e.getMessage();
        // 处置错误情况
    }
}

以下为请求报文示例：

注意：参数 startTimeFrom 和 startTimeTo 是基于初始订阅开始时间的。

copy
{
    "startTimeFrom": "2026-03-31T00:32:28+08:00",
    "startTimeTo": "2026-03-31T23:32:28+08:00",
    "statuses": ["ACTIVE", "CANCELLED", "TERMINATED"],
    "paymentMethodTypes": ["GCASH", "CARD"],
    "currencies": ["PHP", "USD", "SGD"],
    "periodTypes": ["YEAR"],
  "currentPage": 1,
  "pageSize": 10
}

以下代码展示了一个响应的示例：

copy
{
    "paginator": {
        "currentPage": 1,
        "pageSize": 10,
        "totalCount": 1,
        "totalPage": 1
    },
    "result": {
        "resultCode": "SUCCESS",
        "resultMessage": "success.",
        "resultStatus": "S"
    },
    "subscriptions": [
        {
            "currentPeriodEndTime": "2027-03-31T02:27:09Z",
            "currentPeriodStartTime": "2026-03-31T02:27:10Z",
            "currentPhaseNo": 1,
            "description": "paysuccess",
            "paymentAmount": {
                "currency": "PHP",
                "value": "122"
            },
            "paymentMethod": {
                "paymentMethodType": "GCASH"
            },
            "periodCount": 1,
            "periodType": "YEAR",
            "status": "TERMINATED",
            "subscriptionEndTime": "2026-03-28T02:27:10Z",
            "subscriptionId": "202603261900000000000000E0000123529",
            "subscriptionStartTime": "2026-03-31T02:27:10Z"
        }
    ]
}

查询订阅详情

您可以使用 subscriptionId 调用 inquireSubscription 接口来获取订阅详情，包括其状态、周期和金额等信息。这有助于您更好地管理和访问每个单独的订阅信息。

以下示例代码展示了如何调用 inquireSubscription 接口：

copy
public static void inquireSubscription() {
    AlipayInquireSubscriptionRequest request = new AlipayInquireSubscriptionRequest();
    // 替换为您的 subscriptionId
    request.setSubscriptionId("202604061900000000000000E0000131591");

    AlipayInquireSubscriptionResponse response = null;
    try {
        response = CLIENT.execute(request);
    } catch (AlipayApiException e) {
        String errorMsg = e.getMessage();
        // 处置错误情况
    }
}

以下为请求报文示例：

copy
{
    "result": {
        "resultCode": "SUCCESS",
        "resultMessage": "success.",
        "resultStatus": "S"
    },
    "subscription": {
        "currentPeriodEndTime": "2026-04-20T07:00:28Z",
        "currentPeriodStartTime": "2026-04-13T07:00:29Z",
        "currentPhaseNo": 2,
        "description": "Premium Annual Membership",
        "paymentAmount": {
            "currency": "USD",
            "value": "1"
        },
        "paymentMethod": {
            "paymentMethodType": "GOOGLEPAY"
        },
        "periodCount": 1,
        "periodType": "WEEK",
        "status": "ACTIVE",
        "subscriptionId": "202604061900000000000000E0000131591",
        "subscriptionStartTime": "2026-04-06T07:00:29Z"
    }
}

以下代码展示了一个响应的示例：

copy
{
    "result": {
        "resultCode": "SUCCESS",
        "resultMessage": "success.",
        "resultStatus": "S"
    },
    "subscription": {
        "currentPeriodEndTime": "2026-04-20T07:00:28Z",
        "currentPeriodStartTime": "2026-04-13T07:00:29Z",
        "currentPhaseNo": 2,
        "description": "Premium Annual Membership",
        "paymentAmount": {
            "currency": "USD",
            "value": "1"
        },
        "paymentMethod": {
            "paymentMethodType": "GOOGLEPAY"
        },
        "periodCount": 1,
        "periodType": "WEEK",
        "status": "ACTIVE",
        "subscriptionId": "202604061900000000000000E0000131591",
        "subscriptionStartTime": "2026-04-06T07:00:29Z"
    }
}

查询订阅交易信息

您可以使用 subscriptionId 调用 inquireSubscriptionPayment 接口来获取订阅交易的列表信息，包括交易时间、账期编号、支付方式、金额及争议记录等。此接口支持分页功能。

以下示例代码展示了如何调用 inquireSubscriptionPayment 接口：

copy
public static void inquireSubscriptionPayment() {
    AlipayInquireSubscriptionPaymentRequest request = new AlipayInquireSubscriptionPaymentRequest();
    // 替换为您的 subscriptionId
    request.setSubscriptionId("202604061900000000000000E000013****");
    request.setPaymentStatuses(Arrays.asList(PaymentStatus.SUCCESS));
    request.setCurrentPage(1);
    request.setPageSize(10);

    AlipayInquireSubscriptionPaymentResponse response = null;
    try {
        response = CLIENT.execute(request);
    } catch (AlipayApiException e) {
        String errorMsg = e.getMessage();
        // 处置错误情况
    }
}

以下为请求报文示例：

copy
{
    "subscriptionId": "202604061900000000000000E000013****",
 "paymentStatuses": ["SUCCESS"],
}

以下为响应报文示例：

copy
{
    "paginator": {
        "currentPage": 1,
        "pageSize": 10,
        "totalCount": 6,
        "totalPage": 1
    },
    "payments": [
        {
            "paymentAmount": {
                "currency": "USD",
                "value": "1"
            },
            "paymentId": "202604061940108001001880F0288069590",
            "paymentMethod": {
                "paymentMethodType": "GOOGLEPAY"
            },
            "paymentTime": "2026-04-06T07:16:00Z",
            "phaseNo": 6,
            "status": "SUCCESS"
        },
        {
            "paymentAmount": {
                "currency": "USD",
                "value": "1"
            },
            "paymentId": "202604061940108001001885C0287017432",
            "paymentMethod": {
                "paymentMethodType": "GOOGLEPAY"
            },
            "paymentTime": "2026-04-06T07:13:00Z",
            "phaseNo": 5,
            "status": "SUCCESS"
        },
        {
            "paymentAmount": {
                "currency": "USD",
                "value": "1"
            },
            "paymentId": "202604061940108001001881F0287544932",
            "paymentMethod": {
                "paymentMethodType": "GOOGLEPAY"
            },
            "paymentTime": "2026-04-06T07:10:01Z",
            "phaseNo": 4,
            "status": "SUCCESS"
        },
        {
            "paymentAmount": {
                "currency": "USD",
                "value": "1"
            },
            "paymentId": "202604061940108001001880E0286132632",
            "paymentMethod": {
                "paymentMethodType": "GOOGLEPAY"
            },
            "paymentTime": "2026-04-06T07:07:00Z",
            "phaseNo": 3,
            "status": "SUCCESS"
        },
        {
            "paymentAmount": {
                "currency": "USD",
                "value": "1"
            },
            "paymentId": "202604061940108001001883J0284535142",
            "paymentMethod": {
                "paymentMethodType": "GOOGLEPAY"
            },
            "paymentTime": "2026-04-06T07:04:00Z",
            "phaseNo": 2,
            "status": "SUCCESS"
        },
        {
            "paymentAmount": {
                "currency": "USD",
                "value": "1"
            },
            "paymentId": "202604061940108001001882H0286415444",
            "paymentMethod": {
                "paymentMethodType": "GOOGLEPAY"
            },
            "paymentTime": "2026-04-06T06:57:21Z",
            "phaseNo": 1,
            "status": "SUCCESS"
        }
    ],
    "result": {
        "resultCode": "SUCCESS",
        "resultMessage": "success.",
        "resultStatus": "S"
    }
}