@just-education-org/rpc-contracts 1.18.0 → 1.18.1

package/dist/generated/ts/payment.d.ts

@@ -8,12 +8,16 @@ export interface CreatePaymentRequest {
     savePaymentMethod: boolean;
     /** ISO 4217, lowercase (e.g. "usd or uah"), as required by Stripe */
     currency: string;
+    bookingId: string;
 }
 export interface CreatePaymentResponse {
     url: string;
 }
 export interface ProcessPaymentEventRequest {
-    /** Payment Success | Cancelled | Waiting for Captured? */
+    /**
+     * Our own normalized event type (PAYMENT_SUCCEEDED | PAYMENT_FAILED),
+     * not the provider's raw event type — keeps payment-service provider-agnostic
+     */
     event: string;
     paymentId: string;
     bookingId: string;
@@ -25,6 +29,11 @@ export interface ProcessPaymentEventRequest {
     cardLast4?: string | undefined;
     bank?: string | undefined;
     brand?: string | undefined;
+    /**
+     * Final payment id at the provider (e.g. Stripe PaymentIntent) —
+     * written to Payment.providerId, replacing the intermediate id (e.g. Checkout Session)
+     */
+    providerIntentId?: string | undefined;
 }
 export interface ProcessPaymentEventResponse {
     ok: boolean;

package/dist/generated/ts/payment_method.d.ts

@@ -14,11 +14,13 @@ export interface CreatePaymentMethodResponse {
     url: string;
 }
 /**
- * - Що таке verify?
- * - youkassa не присилає вебхук, коли в нас прив"язаний paymeth method.
- * / і нам треба це самим в ручну перевіряти, і тому коли  в нас буде відбуватесь стврення, ми буде створювать paymetnMethod в насшій БД(без даних карти) та привязка до юзера
- * / і коли юзер це все прив"язує його на фронті перекидує на сторінку де в квері параметрі прикинутий ід пеймент метода в нашій системі і там ми як раз викликаємо verify payment method
- * Відбувається пошук платіжного способу, в нашій системі і далі вже його прив"язка
+ * - What is verify for?
+ * - The provider doesn't send a webhook when a payment method gets linked.
+ * We have to check this ourselves: on creation we make a PaymentMethod row
+ * in our DB (no card data yet) linked to the user, and once the user
+ * finishes linking it on the provider's page, the frontend redirects back
+ * with our internal payment method id as a query param — that's when we
+ * call VerifyPaymentMethod to look it up and confirm the link.
  */
 export interface VerifyPaymentMethodRequest {
     userId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@just-education-org/rpc-contracts",
-  "version": "1.18.0",
+  "version": "1.18.1",
   "description": "Protobuf definitions and generated TS types",
   "main": "dist/index.js",
   "types": "./dist/index.d.ts",

package/proto/payment.proto

@@ -14,6 +14,7 @@ message CreatePaymentRequest {
   optional string payment_method_id = 4;
   bool save_payment_method = 5;
   string currency = 6; // ISO 4217, lowercase (e.g. "usd or uah"), as required by Stripe
+  string booking_id = 7;
 }
 
 message CreatePaymentResponse {
@@ -21,7 +22,9 @@ message CreatePaymentResponse {
 }
 
 message ProcessPaymentEventRequest {
-  string event = 1; // Payment Success | Cancelled | Waiting for Captured?
+  // Our own normalized event type (PAYMENT_SUCCEEDED | PAYMENT_FAILED),
+  // not the provider's raw event type — keeps payment-service provider-agnostic
+  string event = 1;
   string payment_id = 2;
   string booking_id = 3;
   string user_id = 4;
@@ -33,6 +36,10 @@ message ProcessPaymentEventRequest {
 
   optional string bank = 9;
   optional string brand = 10;
+
+  // Final payment id at the provider (e.g. Stripe PaymentIntent) —
+  // written to Payment.providerId, replacing the intermediate id (e.g. Checkout Session)
+  optional string provider_intent_id = 11;
 }
 
 message ProcessPaymentEventResponse {

package/proto/payment_method.proto

@@ -26,11 +26,13 @@ message CreatePaymentMethodResponse {
 }
 
 message VerifyPaymentMethodRequest {
-  // - Що таке verify?
-  // - youkassa не присилає вебхук, коли в нас прив"язаний paymeth method.
-  /// і нам треба це самим в ручну перевіряти, і тому коли  в нас буде відбуватесь стврення, ми буде створювать paymetnMethod в насшій БД(без даних карти) та привязка до юзера
-  /// і коли юзер це все прив"язує його на фронті перекидує на сторінку де в квері параметрі прикинутий ід пеймент метода в нашій системі і там ми як раз викликаємо verify payment method
-  // Відбувається пошук платіжного способу, в нашій системі і далі вже його прив"язка
+  // - What is verify for?
+  // - The provider doesn't send a webhook when a payment method gets linked.
+  // We have to check this ourselves: on creation we make a PaymentMethod row
+  // in our DB (no card data yet) linked to the user, and once the user
+  // finishes linking it on the provider's page, the frontend redirects back
+  // with our internal payment method id as a query param — that's when we
+  // call VerifyPaymentMethod to look it up and confirm the link.
 
   string user_id = 1;
   string method_id = 2;