feat(payment): support user-bound seven-discount offers

src/data/services/api/payment_api.ts

@@ -7,6 +7,8 @@ import {
   CreatePaymentOrderRequest,
   CreatePaymentOrderResponse,
   CreatePaymentOrderResponseSchema,
+  CommercialOfferResponse,
+  CommercialOfferResponseSchema,
   GiftProductsResponse,
   GiftProductsResponseSchema,
   PaymentOrderStatusResponse,
@@ -24,13 +26,26 @@ import { ApiEnvelope, unwrap } from "./response_helper";
 
 export class PaymentApi {
   /** 获取 VIP 与 Top-up 套餐列表。 */
-  async getPlans(): Promise<PaymentPlansResponse> {
-    const env = await httpClient<ApiEnvelope<unknown>>(ApiPath.paymentPlans);
+  async getPlans(commercialOfferId?: string): Promise<PaymentPlansResponse> {
+    const env = await httpClient<ApiEnvelope<unknown>>(ApiPath.paymentPlans, {
+      ...(commercialOfferId ? { query: { commercialOfferId } } : {}),
+    });
     return PaymentPlansResponseSchema.parse(
       unwrap(env) as Record<string, unknown>,
     );
   }
 
+  /** 用户确认后激活一份后端签发的专属优惠。 */
+  async acceptCommercialOffer(offerId: string): Promise<CommercialOfferResponse> {
+    const env = await httpClient<ApiEnvelope<unknown>>(
+      ApiPath.paymentCommercialOfferAccept(offerId),
+      { method: "POST" },
+    );
+    return CommercialOfferResponseSchema.parse(
+      unwrap(env) as Record<string, unknown>,
+    );
+  }
+
   /** 一次获取当前角色的完整礼物目录。 */
   async getGiftProducts(characterId: string): Promise<GiftProductsResponse> {
     const env = await httpClient<ApiEnvelope<unknown>>(