@aepstore-dev/contracts 1.61.0 → 1.62.0

package/gen/payments.d.ts

@@ -13,16 +13,23 @@ export interface Purchase {
     productId: string;
     productName: string;
     userId: string;
+    /** settled RUB amount */
     price: string;
     /** PENDING | COMPLETED | FAILED | REFUNDED */
     status: string;
     paymentId: string;
-    /** BALANCE | YOOKASSA */
+    /** BALANCE | YOOKASSA | CRYPTO */
     paymentMethod: string;
     commissionPercent: string;
     sellerAmount: string;
     createdAt: string;
     completedAt: string;
+    /** FX snapshot at checkout (empty for legacy RUB purchases). */
+    listingCurrency: string;
+    /** Decimal as string, in listing_currency */
+    listingPrice: string;
+    /** listing→RUB rate used (Decimal as string) */
+    fxRate: string;
 }
 export interface TopupRequest {
     userId: string;
@@ -37,7 +44,7 @@ export interface TopupRequest {
 export interface CreateCheckoutRequest {
     userId: string;
     productId: string;
-    /** BALANCE | YOOKASSA | SAVED_CARD (default YOOKASSA) */
+    /** BALANCE | YOOKASSA | SAVED_CARD | CRYPTO (default YOOKASSA) */
     paymentMethod: string;
     returnUrl: string;
     /**
@@ -277,6 +284,38 @@ export interface ProviderCallbackRequest {
     /** exact raw JSON body as received (signature input) */
     rawBody: string;
 }
+/**
+ * ---------------------------------------------------------------------------
+ * FX rates / payment methods
+ * ---------------------------------------------------------------------------
+ */
+export interface GetRatesRequest {
+}
+export interface FxRate {
+    /** USD | EUR */
+    currency: string;
+    /** RUB per 1 unit, Decimal as string */
+    rate: string;
+}
+export interface GetRatesResponse {
+    /** always RUB */
+    base: string;
+    /** YYYY-MM-DD the rates are for */
+    asOf: string;
+    rates: FxRate[];
+}
+export interface GetPaymentMethodsRequest {
+}
+export interface PaymentMethodInfo {
+    /** YOOKASSA | SAVED_CARD | CRYPTO | BALANCE */
+    method: string;
+    /** yookassa | heleket | '' (BALANCE) */
+    provider: string;
+    currencies: string[];
+}
+export interface GetPaymentMethodsResponse {
+    methods: PaymentMethodInfo[];
+}
 /**
  * ---------------------------------------------------------------------------
  * Admin
@@ -624,6 +663,18 @@ export interface PaymentsServiceClient {
      * completion. Ownership-checked by user_id.
      */
     getPaymentIntent(request: GetPaymentIntentRequest): Observable<PaymentIntentStatus>;
+    /**
+     * ----- FX / available methods (public, cached) -----
+     * Daily CBR rates (RUB base). Frontend uses this for the "≈" display hint;
+     * the authoritative charge amount is always computed server-side at checkout.
+     */
+    getRates(request: GetRatesRequest): Observable<GetRatesResponse>;
+    /**
+     * Payment methods derived from live provider capabilities — the client
+     * renders only what is actually available (e.g. CRYPTO appears once the
+     * Heleket merchant is configured).
+     */
+    getPaymentMethods(request: GetPaymentMethodsRequest): Observable<GetPaymentMethodsResponse>;
     /** ----- payout details ----- */
     updatePayoutDetails(request: UpdatePayoutDetailsRequest): Observable<UpdatePayoutDetailsResponse>;
     getPayoutDetails(request: GetPayoutDetailsRequest): Observable<UpdatePayoutDetailsResponse>;
@@ -694,6 +745,18 @@ export interface PaymentsServiceController {
      * completion. Ownership-checked by user_id.
      */
     getPaymentIntent(request: GetPaymentIntentRequest): Promise<PaymentIntentStatus> | Observable<PaymentIntentStatus> | PaymentIntentStatus;
+    /**
+     * ----- FX / available methods (public, cached) -----
+     * Daily CBR rates (RUB base). Frontend uses this for the "≈" display hint;
+     * the authoritative charge amount is always computed server-side at checkout.
+     */
+    getRates(request: GetRatesRequest): Promise<GetRatesResponse> | Observable<GetRatesResponse> | GetRatesResponse;
+    /**
+     * Payment methods derived from live provider capabilities — the client
+     * renders only what is actually available (e.g. CRYPTO appears once the
+     * Heleket merchant is configured).
+     */
+    getPaymentMethods(request: GetPaymentMethodsRequest): Promise<GetPaymentMethodsResponse> | Observable<GetPaymentMethodsResponse> | GetPaymentMethodsResponse;
     /** ----- payout details ----- */
     updatePayoutDetails(request: UpdatePayoutDetailsRequest): Promise<UpdatePayoutDetailsResponse> | Observable<UpdatePayoutDetailsResponse> | UpdatePayoutDetailsResponse;
     getPayoutDetails(request: GetPayoutDetailsRequest): Promise<UpdatePayoutDetailsResponse> | Observable<UpdatePayoutDetailsResponse> | UpdatePayoutDetailsResponse;

package/gen/payments.js

@@ -40,6 +40,8 @@ function PaymentsServiceControllerMethods() {
             "updateSavedCard",
             "bindCard",
             "getPaymentIntent",
+            "getRates",
+            "getPaymentMethods",
             "updatePayoutDetails",
             "getPayoutDetails",
             "getAdminOverview",

package/gen/payments.ts

@@ -24,16 +24,23 @@ export interface Purchase {
   productId: string;
   productName: string;
   userId: string;
+  /** settled RUB amount */
   price: string;
   /** PENDING | COMPLETED | FAILED | REFUNDED */
   status: string;
   paymentId: string;
-  /** BALANCE | YOOKASSA */
+  /** BALANCE | YOOKASSA | CRYPTO */
   paymentMethod: string;
   commissionPercent: string;
   sellerAmount: string;
   createdAt: string;
   completedAt: string;
+  /** FX snapshot at checkout (empty for legacy RUB purchases). */
+  listingCurrency: string;
+  /** Decimal as string, in listing_currency */
+  listingPrice: string;
+  /** listing→RUB rate used (Decimal as string) */
+  fxRate: string;
 }
 
 export interface TopupRequest {
@@ -50,7 +57,7 @@ export interface TopupRequest {
 export interface CreateCheckoutRequest {
   userId: string;
   productId: string;
-  /** BALANCE | YOOKASSA | SAVED_CARD (default YOOKASSA) */
+  /** BALANCE | YOOKASSA | SAVED_CARD | CRYPTO (default YOOKASSA) */
   paymentMethod: string;
   returnUrl: string;
   /**
@@ -313,6 +320,44 @@ export interface ProviderCallbackRequest {
   rawBody: string;
 }
 
+/**
+ * ---------------------------------------------------------------------------
+ * FX rates / payment methods
+ * ---------------------------------------------------------------------------
+ */
+export interface GetRatesRequest {
+}
+
+export interface FxRate {
+  /** USD | EUR */
+  currency: string;
+  /** RUB per 1 unit, Decimal as string */
+  rate: string;
+}
+
+export interface GetRatesResponse {
+  /** always RUB */
+  base: string;
+  /** YYYY-MM-DD the rates are for */
+  asOf: string;
+  rates: FxRate[];
+}
+
+export interface GetPaymentMethodsRequest {
+}
+
+export interface PaymentMethodInfo {
+  /** YOOKASSA | SAVED_CARD | CRYPTO | BALANCE */
+  method: string;
+  /** yookassa | heleket | '' (BALANCE) */
+  provider: string;
+  currencies: string[];
+}
+
+export interface GetPaymentMethodsResponse {
+  methods: PaymentMethodInfo[];
+}
+
 /**
  * ---------------------------------------------------------------------------
  * Admin
@@ -739,6 +784,22 @@ export interface PaymentsServiceClient {
 
   getPaymentIntent(request: GetPaymentIntentRequest): Observable<PaymentIntentStatus>;
 
+  /**
+   * ----- FX / available methods (public, cached) -----
+   * Daily CBR rates (RUB base). Frontend uses this for the "≈" display hint;
+   * the authoritative charge amount is always computed server-side at checkout.
+   */
+
+  getRates(request: GetRatesRequest): Observable<GetRatesResponse>;
+
+  /**
+   * Payment methods derived from live provider capabilities — the client
+   * renders only what is actually available (e.g. CRYPTO appears once the
+   * Heleket merchant is configured).
+   */
+
+  getPaymentMethods(request: GetPaymentMethodsRequest): Observable<GetPaymentMethodsResponse>;
+
   /** ----- payout details ----- */
 
   updatePayoutDetails(request: UpdatePayoutDetailsRequest): Observable<UpdatePayoutDetailsResponse>;
@@ -884,6 +945,24 @@ export interface PaymentsServiceController {
     request: GetPaymentIntentRequest,
   ): Promise<PaymentIntentStatus> | Observable<PaymentIntentStatus> | PaymentIntentStatus;
 
+  /**
+   * ----- FX / available methods (public, cached) -----
+   * Daily CBR rates (RUB base). Frontend uses this for the "≈" display hint;
+   * the authoritative charge amount is always computed server-side at checkout.
+   */
+
+  getRates(request: GetRatesRequest): Promise<GetRatesResponse> | Observable<GetRatesResponse> | GetRatesResponse;
+
+  /**
+   * Payment methods derived from live provider capabilities — the client
+   * renders only what is actually available (e.g. CRYPTO appears once the
+   * Heleket merchant is configured).
+   */
+
+  getPaymentMethods(
+    request: GetPaymentMethodsRequest,
+  ): Promise<GetPaymentMethodsResponse> | Observable<GetPaymentMethodsResponse> | GetPaymentMethodsResponse;
+
   /** ----- payout details ----- */
 
   updatePayoutDetails(
@@ -944,6 +1023,8 @@ export function PaymentsServiceControllerMethods() {
       "updateSavedCard",
       "bindCard",
       "getPaymentIntent",
+      "getRates",
+      "getPaymentMethods",
       "updatePayoutDetails",
       "getPayoutDetails",
       "getAdminOverview",

package/gen/products.d.ts

@@ -71,15 +71,20 @@ export interface Product {
     id: string;
     name: string;
     description: string;
-    /** Decimal as string (D7) */
+    /** Decimal as string (D7), in `currency` */
     price: string;
     /** Decimal as string */
     discountPercent: string;
-    /** Decimal as string */
+    /** Decimal as string, in `currency` */
     finalPrice: string;
     /** double as string for consistency */
     averageRating: string;
     status: ProductStatus;
+    /**
+     * Listing currency the seller priced in: RUB | USD | EUR (default RUB).
+     * Settlement/ledger is always RUB — conversion is snapshotted at checkout.
+     */
+    currency: string;
     /** null while DRAFT / not yet submitted */
     moderation: ProductModeration | undefined;
     createdAt: string;
@@ -170,6 +175,8 @@ export interface CreateProductRequest {
     video: string;
     description: string;
     status: ProductStatus;
+    /** RUB | USD | EUR; empty → RUB */
+    currency: string;
 }
 export interface UpdateProductRequest {
     userId: string;
@@ -182,6 +189,8 @@ export interface UpdateProductRequest {
     tags: string[];
     categoryIds: string[];
     applicationIds: string[];
+    /** RUB | USD | EUR; empty → no change */
+    currency: string;
 }
 export interface QueryProductsRequest {
     search: string;

package/gen/products.js

@@ -2,7 +2,7 @@
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
 //   protoc-gen-ts_proto  v2.10.1
-//   protoc               v7.35.1
+//   protoc               v7.35.0
 // source: products.proto
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PRODUCTS_SERVICE_NAME = exports.PRODUCTS_V1_PACKAGE_NAME = exports.MediaType = exports.ModerationStatus = exports.ProductStatus = exports.protobufPackage = void 0;

package/gen/products.ts

@@ -1,7 +1,7 @@
 // Code generated by protoc-gen-ts_proto. DO NOT EDIT.
 // versions:
 //   protoc-gen-ts_proto  v2.10.1
-//   protoc               v7.35.1
+//   protoc               v7.35.0
 // source: products.proto
 
 /* eslint-disable */
@@ -91,15 +91,20 @@ export interface Product {
   id: string;
   name: string;
   description: string;
-  /** Decimal as string (D7) */
+  /** Decimal as string (D7), in `currency` */
   price: string;
   /** Decimal as string */
   discountPercent: string;
-  /** Decimal as string */
+  /** Decimal as string, in `currency` */
   finalPrice: string;
   /** double as string for consistency */
   averageRating: string;
   status: ProductStatus;
+  /**
+   * Listing currency the seller priced in: RUB | USD | EUR (default RUB).
+   * Settlement/ledger is always RUB — conversion is snapshotted at checkout.
+   */
+  currency: string;
   /** null while DRAFT / not yet submitted */
   moderation: ProductModeration | undefined;
   createdAt: string;
@@ -200,6 +205,8 @@ export interface CreateProductRequest {
   video: string;
   description: string;
   status: ProductStatus;
+  /** RUB | USD | EUR; empty → RUB */
+  currency: string;
 }
 
 export interface UpdateProductRequest {
@@ -213,6 +220,8 @@ export interface UpdateProductRequest {
   tags: string[];
   categoryIds: string[];
   applicationIds: string[];
+  /** RUB | USD | EUR; empty → no change */
+  currency: string;
 }
 
 export interface QueryProductsRequest {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aepstore-dev/contracts",
-  "version": "1.61.0",
+  "version": "1.62.0",
   "description": "Protobuf definitions for aepstore microservices",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/proto/payments.proto

@@ -56,6 +56,15 @@ service PaymentsService {
     // completion. Ownership-checked by user_id.
     rpc GetPaymentIntent(GetPaymentIntentRequest) returns (PaymentIntentStatus);
 
+    // ----- FX / available methods (public, cached) -----
+    // Daily CBR rates (RUB base). Frontend uses this for the "≈" display hint;
+    // the authoritative charge amount is always computed server-side at checkout.
+    rpc GetRates(GetRatesRequest) returns (GetRatesResponse);
+    // Payment methods derived from live provider capabilities — the client
+    // renders only what is actually available (e.g. CRYPTO appears once the
+    // Heleket merchant is configured).
+    rpc GetPaymentMethods(GetPaymentMethodsRequest) returns (GetPaymentMethodsResponse);
+
     // ----- payout details -----
     rpc UpdatePayoutDetails(UpdatePayoutDetailsRequest) returns (UpdatePayoutDetailsResponse);
     rpc GetPayoutDetails(GetPayoutDetailsRequest) returns (UpdatePayoutDetailsResponse);
@@ -78,14 +87,18 @@ message Purchase {
     string product_id = 2;
     string product_name = 3;
     string user_id = 4;
-    string price = 5;
+    string price = 5;              // settled RUB amount
     string status = 6;             // PENDING | COMPLETED | FAILED | REFUNDED
     string payment_id = 7;
-    string payment_method = 8;     // BALANCE | YOOKASSA
+    string payment_method = 8;     // BALANCE | YOOKASSA | CRYPTO
     string commission_percent = 9;
     string seller_amount = 10;
     string created_at = 11;
     string completed_at = 12;
+    // FX snapshot at checkout (empty for legacy RUB purchases).
+    string listing_currency = 13;  // RUB | USD | EUR
+    string listing_price = 14;     // Decimal as string, in listing_currency
+    string fx_rate = 15;           // listing→RUB rate used (Decimal as string)
 }
 
 message TopupRequest {
@@ -99,7 +112,7 @@ message TopupRequest {
 message CreateCheckoutRequest {
     string user_id = 1;
     string product_id = 2;
-    string payment_method = 3; // BALANCE | YOOKASSA | SAVED_CARD (default YOOKASSA)
+    string payment_method = 3; // BALANCE | YOOKASSA | SAVED_CARD | CRYPTO (default YOOKASSA)
     string return_url = 4;
     // When payment_method=SAVED_CARD — required. ID of a SavedCard row owned
     // by user_id. Ignored otherwise.
@@ -257,6 +270,34 @@ message ProviderCallbackRequest {
     string raw_body = 2; // exact raw JSON body as received (signature input)
 }
 
+// ---------------------------------------------------------------------------
+// FX rates / payment methods
+// ---------------------------------------------------------------------------
+message GetRatesRequest {}
+
+message FxRate {
+    string currency = 1; // USD | EUR
+    string rate = 2;     // RUB per 1 unit, Decimal as string
+}
+
+message GetRatesResponse {
+    string base = 1;  // always RUB
+    string as_of = 2; // YYYY-MM-DD the rates are for
+    repeated FxRate rates = 3;
+}
+
+message GetPaymentMethodsRequest {}
+
+message PaymentMethodInfo {
+    string method = 1;             // YOOKASSA | SAVED_CARD | CRYPTO | BALANCE
+    string provider = 2;           // yookassa | heleket | '' (BALANCE)
+    repeated string currencies = 3;
+}
+
+message GetPaymentMethodsResponse {
+    repeated PaymentMethodInfo methods = 1;
+}
+
 // ---------------------------------------------------------------------------
 // Admin
 // ---------------------------------------------------------------------------

package/proto/products.proto

@@ -116,11 +116,14 @@ message Product {
     string id = 1;
     string name = 2;
     string description = 3;
-    string price = 4;            // Decimal as string (D7)
+    string price = 4;            // Decimal as string (D7), in `currency`
     string discount_percent = 5; // Decimal as string
-    string final_price = 6;      // Decimal as string
+    string final_price = 6;      // Decimal as string, in `currency`
     string average_rating = 7;   // double as string for consistency
     ProductStatus status = 8;
+    // Listing currency the seller priced in: RUB | USD | EUR (default RUB).
+    // Settlement/ledger is always RUB — conversion is snapshotted at checkout.
+    string currency = 35;
     ProductModeration moderation = 32; // null while DRAFT / not yet submitted
     string created_at = 13;
     string updated_at = 14;
@@ -213,6 +216,7 @@ message CreateProductRequest {
     string video = 9;
     string description = 10;
     ProductStatus status = 11;
+    string currency = 12; // RUB | USD | EUR; empty → RUB
 }
 
 message UpdateProductRequest {
@@ -226,6 +230,7 @@ message UpdateProductRequest {
     repeated string tags = 8;
     repeated string category_ids = 9;
     repeated string application_ids = 10;
+    string currency = 11; // RUB | USD | EUR; empty → no change
 }
 
 message QueryProductsRequest {