@aepstore-dev/contracts 1.46.0 → 1.47.0

package/gen/payments.d.ts

@@ -55,6 +55,25 @@ export interface BindCardRequest {
     userId: string;
     returnUrl: string;
 }
+export interface GetPaymentIntentRequest {
+    intentId: string;
+    /** ownership check */
+    userId: string;
+}
+export interface PaymentIntentStatus {
+    id: string;
+    userId: string;
+    /** TOPUP | PREMIUM */
+    purpose: string;
+    /** PENDING | COMPLETED | FAILED | CANCELED */
+    status: string;
+    amount: string;
+    currency: string;
+    /** set when purpose=PREMIUM (else empty) */
+    purchaseId: string;
+    createdAt: string;
+    updatedAt: string;
+}
 export interface CheckoutResponse {
     purchaseId: string;
     paymentId: string;
@@ -562,6 +581,11 @@ export interface PaymentsServiceClient {
      * persisted and the 1₽ credits USER_SPENDING so the user keeps it.
      */
     bindCard(request: BindCardRequest): Observable<CheckoutResponse>;
+    /**
+     * Poll an intent after returnUrl redirect: TOPUP/PREMIUM completion, bind-card
+     * completion. Ownership-checked by user_id.
+     */
+    getPaymentIntent(request: GetPaymentIntentRequest): Observable<PaymentIntentStatus>;
     /** ----- payout details ----- */
     updatePayoutDetails(request: UpdatePayoutDetailsRequest): Observable<UpdatePayoutDetailsResponse>;
     getPayoutDetails(request: GetPayoutDetailsRequest): Observable<UpdatePayoutDetailsResponse>;
@@ -619,6 +643,11 @@ export interface PaymentsServiceController {
      * persisted and the 1₽ credits USER_SPENDING so the user keeps it.
      */
     bindCard(request: BindCardRequest): Promise<CheckoutResponse> | Observable<CheckoutResponse> | CheckoutResponse;
+    /**
+     * Poll an intent after returnUrl redirect: TOPUP/PREMIUM completion, bind-card
+     * completion. Ownership-checked by user_id.
+     */
+    getPaymentIntent(request: GetPaymentIntentRequest): Promise<PaymentIntentStatus> | Observable<PaymentIntentStatus> | PaymentIntentStatus;
     /** ----- payout details ----- */
     updatePayoutDetails(request: UpdatePayoutDetailsRequest): Promise<UpdatePayoutDetailsResponse> | Observable<UpdatePayoutDetailsResponse> | UpdatePayoutDetailsResponse;
     getPayoutDetails(request: GetPayoutDetailsRequest): Promise<UpdatePayoutDetailsResponse> | Observable<UpdatePayoutDetailsResponse> | UpdatePayoutDetailsResponse;

package/gen/payments.js

@@ -36,6 +36,7 @@ function PaymentsServiceControllerMethods() {
             "setDefaultSavedCard",
             "updateSavedCard",
             "bindCard",
+            "getPaymentIntent",
             "updatePayoutDetails",
             "getPayoutDetails",
             "getAdminOverview",

package/gen/payments.ts

@@ -70,6 +70,27 @@ export interface BindCardRequest {
   returnUrl: string;
 }
 
+export interface GetPaymentIntentRequest {
+  intentId: string;
+  /** ownership check */
+  userId: string;
+}
+
+export interface PaymentIntentStatus {
+  id: string;
+  userId: string;
+  /** TOPUP | PREMIUM */
+  purpose: string;
+  /** PENDING | COMPLETED | FAILED | CANCELED */
+  status: string;
+  amount: string;
+  currency: string;
+  /** set when purpose=PREMIUM (else empty) */
+  purchaseId: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
 export interface CheckoutResponse {
   purchaseId: string;
   paymentId: string;
@@ -665,6 +686,13 @@ export interface PaymentsServiceClient {
 
   bindCard(request: BindCardRequest): Observable<CheckoutResponse>;
 
+  /**
+   * Poll an intent after returnUrl redirect: TOPUP/PREMIUM completion, bind-card
+   * completion. Ownership-checked by user_id.
+   */
+
+  getPaymentIntent(request: GetPaymentIntentRequest): Observable<PaymentIntentStatus>;
+
   /** ----- payout details ----- */
 
   updatePayoutDetails(request: UpdatePayoutDetailsRequest): Observable<UpdatePayoutDetailsResponse>;
@@ -785,6 +813,15 @@ export interface PaymentsServiceController {
 
   bindCard(request: BindCardRequest): Promise<CheckoutResponse> | Observable<CheckoutResponse> | CheckoutResponse;
 
+  /**
+   * Poll an intent after returnUrl redirect: TOPUP/PREMIUM completion, bind-card
+   * completion. Ownership-checked by user_id.
+   */
+
+  getPaymentIntent(
+    request: GetPaymentIntentRequest,
+  ): Promise<PaymentIntentStatus> | Observable<PaymentIntentStatus> | PaymentIntentStatus;
+
   /** ----- payout details ----- */
 
   updatePayoutDetails(
@@ -841,6 +878,7 @@ export function PaymentsServiceControllerMethods() {
       "setDefaultSavedCard",
       "updateSavedCard",
       "bindCard",
+      "getPaymentIntent",
       "updatePayoutDetails",
       "getPayoutDetails",
       "getAdminOverview",

package/package.json

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

package/proto/payments.proto

@@ -46,6 +46,9 @@ service PaymentsService {
     // save_payment_method=true; after the webhook the SavedCard row is
     // persisted and the 1₽ credits USER_SPENDING so the user keeps it.
     rpc BindCard(BindCardRequest) returns (CheckoutResponse);
+    // Poll an intent after returnUrl redirect: TOPUP/PREMIUM completion, bind-card
+    // completion. Ownership-checked by user_id.
+    rpc GetPaymentIntent(GetPaymentIntentRequest) returns (PaymentIntentStatus);
 
     // ----- payout details -----
     rpc UpdatePayoutDetails(UpdatePayoutDetailsRequest) returns (UpdatePayoutDetailsResponse);
@@ -105,6 +108,23 @@ message BindCardRequest {
     string return_url = 2;
 }
 
+message GetPaymentIntentRequest {
+    string intent_id = 1;
+    string user_id = 2; // ownership check
+}
+
+message PaymentIntentStatus {
+    string id = 1;
+    string user_id = 2;
+    string purpose = 3;          // TOPUP | PREMIUM
+    string status = 4;           // PENDING | COMPLETED | FAILED | CANCELED
+    string amount = 5;
+    string currency = 6;
+    string purchase_id = 7;      // set when purpose=PREMIUM (else empty)
+    string created_at = 8;
+    string updated_at = 9;
+}
+
 message CheckoutResponse {
     string purchase_id = 1;
     string payment_id = 2;