@wix/bex-utils 2.1.0 → 2.2.0

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/common/wixlink.proto

@@ -39,6 +39,9 @@ message WixLink {
     option (.wix.api.decomposition_minimum_fields) = {
         field: "whats_app"
     };
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "tpa_page_link"
+    };
     oneof Link {
         ExternalLink external = 1; // External link type
         PageLink page = 2; // Page link type
@@ -49,6 +52,7 @@ message WixLink {
         PhoneLink phone = 7; // Phone link type
         AddressLink address = 8; // Address link type
         WhatsAppLink whats_app = 9; // WhatsApp link type
+        TpaPageLink tpa_page = 10; // TPA link type
     }
 }
 
@@ -70,6 +74,8 @@ message PageLink {
     string page_id = 1;
     //Where this link should open, supports _self and _blank or any name the user chooses. _self means same page, _blank means new page.
     google.protobuf.StringValue target = 2;
+    //rel of link
+    repeated LinkRel rel = 3 [(wix.api.maxSize) = 20];
 }
 
 message AnchorLink {
@@ -84,6 +90,8 @@ message AnchorLink {
     string anchor_data_id = 2;
     //The page id we want from the site
     string page_id = 3;
+    //rel of link
+    repeated LinkRel rel = 4 [(wix.api.maxSize) = 20];
 }
 
 message DynamicPageLink {
@@ -98,6 +106,8 @@ message DynamicPageLink {
     string inner_route = 2;
     //The data id (from the JSON page) of the anchor that should be used
     google.protobuf.StringValue anchor_data_id = 3;
+    //rel of link
+    repeated LinkRel rel = 4 [(wix.api.maxSize) = 20];
 }
 
 message DocumentLink {
@@ -149,4 +159,43 @@ message WhatsAppLink {
     };
     //The whatsApp phone number we want to connect with
     string phone_number = 1 [(.wix.api.pii) = true, (.wix.api.format) = PHONE];
-}
+}
+
+//Link to a TPA page
+message TpaPageLink {
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "item_type_identifier"
+        field: "item_id"
+        field: "page_id"
+        field: "app_definition_id"
+        field: "path"
+    };
+    //Type of item (e.g. 'wix.stores.sub_pages.product')
+    string item_type_identifier = 1;
+    //Id of linked item
+    string item_id = 2;
+    //Id of linked page
+    string page_id = 3;
+    //Id of app being linked to (AppDefId)
+    string app_definition_id = 4;
+    //The relativepath of linked page
+    string path = 5;
+    //rel of link
+    repeated LinkRel rel = 6 [(wix.api.maxSize) = 20];
+}
+
+//The 'rel' attribute of the link. The rel attribute defines the relationship between a linked resource and the current document.
+//Further reading (also about different possible rel types): https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/rel
+//Following are the accepted 'rel' types by Wix applications.
+enum LinkRel {
+    // default (not implemented)
+    unknown_link_rel = 0 [(.wix.api.enum_maturity) = NOT_IMPLEMENTED];
+    //Indicates that the current document's original author or publisher does not endorse the referenced document.
+    nofollow = 1;
+    //Instructs the browser to navigate to the target resource without granting the new browsing context access to the document that opened it.
+    noopener = 2;
+    //No Referer header will be included. Additionally, has the same effect as noopener.
+    noreferrer = 3;
+    //Indicates a link that resulted from advertisements or paid placements.
+    sponsored = 4;
+}

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/coupons/api/v1/coupons-adapter.proto

@@ -10,92 +10,92 @@ import "google/protobuf/wrappers.proto";
 option java_package = "com.wix.coupons.api.v1";
 
 service CouponsAdapter {
-    option (wix.api.service_exposure) = PRIVATE;
-
-    rpc GetItemsForCoupons (GetItemsForCouponsRequest) returns (GetItemsForCouponsResponse) {
-        option (google.api.http) = {
-            get: "/api/v1/items-for-coupons/group/{group}/ids/{ids}"
-            additional_bindings {
-                get: "/api/v1/items-for-coupons/group/{group}/limit/{limit}/offset/{offset}"
-            }
-        };
-        option (wix.api.maturity) = ALPHA;
-        option (wix.api.exposure) = INTERNAL;
-    }
+  option (wix.api.service_exposure) = PRIVATE;
+
+  rpc GetItemsForCoupons (GetItemsForCouponsRequest) returns (GetItemsForCouponsResponse) {
+    option (google.api.http) = {
+      get: "/api/v1/items-for-coupons/group/{group}/ids/{ids}"
+      additional_bindings {
+        get: "/api/v1/items-for-coupons/group/{group}/limit/{limit}/offset/{offset}"
+      }
+    };
+    option (wix.api.maturity) = ALPHA;
+    option (wix.api.exposure) = INTERNAL;
+  }
 }
 
 message GetItemsForCouponsRequest {
-    string group = 1;
-    string ids = 2;
-    int32 limit = 3;
-    int32 offset = 4;
+  string group = 1;
+  string ids = 2;
+  int32 limit = 3;
+  int32 offset = 4;
 }
 
 message ItemForCoupon {
-    string id = 1;
-    string name = 2;
-    MediaItem mediaItem = 3;
-    google.protobuf.StringValue formattedPrice = 4;
+  string id = 1;
+  string name = 2;
+  MediaItem mediaItem = 3;
+  google.protobuf.StringValue formattedPrice = 4;
 }
 
 message GetItemsForCouponsResponse {
-    repeated ItemForCoupon items = 1;
+  repeated ItemForCoupon items = 1;
 }
 
 
 service CouponsManagerUI {
-    option (wix.api.service_exposure) = PRIVATE;
+  option (wix.api.service_exposure) = PRIVATE;
 
-    rpc GetAllScopeConfigs (AllScopeConfigsRequest) returns (AllScopeConfigsResponse) {
-        option (google.api.http) = {
-            get: "/api/v1/coupons-scope-configs"
-        };
-    }
+  rpc GetAllScopeConfigs (AllScopeConfigsRequest) returns (AllScopeConfigsResponse) {
+    option (google.api.http) = {
+      get: "/api/v1/coupons-scope-configs"
+    };
+  }
 }
 
 message AllScopeConfigsRequest {
 }
 
 message AllScopeConfigsResponse {
-    repeated string supportedCouponTypes = 1; // coupon types from all scopes
-    repeated ScopeConfig scopeConfigs = 2; // scopeConfigs from all verticals
+  repeated string supportedCouponTypes = 1; // coupon types from all scopes
+  repeated ScopeConfig scopeConfigs = 2; // scopeConfigs from all verticals
 }
 
 message ScopeConfig {
-    string namespace = 1; // stores / bookings / events
-    google.protobuf.StringValue group = 2; // group - optional
-    string displayName = 3; // name in drop down
-    string type = 4; // "SCOPE"/"MINSUBTOTAL"/"DEFAULT"
-    InputDataConfig inputDataConfig = 5; // right drop down data - optional
-    LimitedToOneItemConfig limitedToOneItem = 6;
-    LimitPerCustomerConfig limitPerCustomer = 8;
-    SubscriptionConfig subscriptionConfig = 9;
-    repeated string supportedCouponTypes = 7;
+  string namespace = 1; // stores / bookings / events
+  google.protobuf.StringValue group = 2; // group - optional
+  string displayName = 3; // name in drop down
+  string type = 4; // "SCOPE"/"MINSUBTOTAL"/"DEFAULT"
+  InputDataConfig inputDataConfig = 5; // right drop down data - optional
+  LimitedToOneItemConfig limitedToOneItem = 6;
+  LimitPerCustomerConfig limitPerCustomer = 8;
+  SubscriptionConfig subscriptionConfig = 9;
+  repeated string supportedCouponTypes = 7;
 }
 
 message InputDataConfig {
-    string label = 1;
-    string placeholder = 2;
-    bool shouldShowMedia = 3;
+  string label = 1;
+  string placeholder = 2;
+  bool shouldShowMedia = 3;
 }
 
 message LimitedToOneItemConfig {
-    bool visible = 1;
-    bool default = 2;
+  bool visible = 1;
+  bool default = 2;
 }
 
 message SubscriptionConfig {
-    bool visible = 1;
-    bool default = 2;
+  bool visible = 1;
+  bool default = 2;
 }
 
 message LimitPerCustomerConfig {
-    bool visible = 1;
-    bool default = 2;
+  bool visible = 1;
+  bool default = 2;
 }
 
 message MediaItem {
-    string url = 1 [(wix.api.format)=URI]; // Media item URL
-    int32 width = 2 [(wix.api.min)=0,(wix.api.max)=5000]; // Media item width
-    int32 height = 3 [(wix.api.min)=0,(wix.api.max)=5000]; // Media item height
+  string url = 1 [(wix.api.format) = WEB_URL]; // Media item URL
+  int32 width = 2 [(wix.api.min) = 0, (wix.api.max) = 5000]; // Media item width
+  int32 height = 3 [(wix.api.min) = 0, (wix.api.max) = 5000]; // Media item height
 }

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/coupons/api/v2/mediaitem.proto

@@ -7,7 +7,7 @@ import "wix/api/validations.proto";
 option java_package = "com.wix.coupons.api.v2";
 
 message MediaItem {
-    string url = 1 [(wix.api.format)=URI]; // Media item URL.
-    int32 width = 2 [(wix.api.min)=0,(wix.api.max)=5000]; // Media item width.
-    int32 height = 3 [(wix.api.min)=0,(wix.api.max)=5000]; // Media item height.
+  string url = 1 [(wix.api.format) = WEB_URL]; // Media item URL.
+  int32 width = 2 [(wix.api.min) = 0, (wix.api.max) = 5000]; // Media item width.
+  int32 height = 3 [(wix.api.min) = 0, (wix.api.max) = 5000]; // Media item height.
 }

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/fedinfra/exportservice/v1/export.proto

@@ -60,6 +60,7 @@ message ExportAsyncJobData {
   int32 iterations_count = 9;
   int32 processed_items_count = 16;
   .google.protobuf.StringValue completion_step = 17;
+  // how many times the export was reset
   int32 reset_count = 10;
 
   // at final step update the signed_url to download the result from

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/infra/asyncjobs/v1/AsyncJob.proto

@@ -73,6 +73,8 @@ message AsyncJob {
             string wix_user_id = 4 [(.wix.api.format) = GUID];
             // ID of an app.
             string app_id = 5 [(.wix.api.format) = GUID];
+            // ID of service.
+            string service_id = 6 [(.wix.api.format) = GUID];
         }
     }
 

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/infra/asyncjobs/v1/AsyncJobService.proto

@@ -1,4 +1,4 @@
-//flynt-disable missing-permission, missing-service-entity, missing-field-comments, missing-method-comments, request-response, missing-rest-mapping, missing-main-entity-fqdn
+//flynt-disable missing-permission, missing-field-comments, missing-method-comments, request-response, missing-rest-mapping, missing-main-entity-fqdn
 syntax = "proto3";
 
 import "google/protobuf/wrappers.proto";
@@ -42,6 +42,14 @@ service AsyncJobService {
   };
 
   rpc CreateAsyncJob (CreateAsyncJobRequest) returns (CreateAsyncJobResponse) {
+
+    option (.wix.api.crud) = {
+      method: CREATE
+      create_options: {
+        item_field: "job"
+      }
+    };
+
     option (google.api.http) = {
       post: "/v1/async-jobs"
     };
@@ -60,6 +68,15 @@ service AsyncJobService {
   }
 
   rpc GetAsyncJob (GetAsyncJobRequest) returns (GetAsyncJobResponse) {
+
+    option (.wix.api.crud) = {
+      method: GET_ITEM
+      get_options: {
+        id_field: "job_id"
+        item_field: "job"
+      }
+    };
+
     option (google.api.http) = {
       get: "/v1/async-jobs/{job_id}"
     };
@@ -75,6 +92,15 @@ service AsyncJobService {
   }
 
   rpc UpdateAsyncJob (UpdateAsyncJobRequest) returns (UpdateAsyncJobResponse) {
+
+    option (.wix.api.crud) = {
+      method: UPDATE
+      update_options: {
+        item_field: "job"
+        fieldmask_field: "mask"
+      }
+    };
+
     option (google.api.http) = {
       put: "/v1/async-jobs/{job.id}"
     };
@@ -98,6 +124,14 @@ service AsyncJobService {
   }
 
   rpc DeleteAsyncJob (DeleteAsyncJobRequest) returns (DeleteAsyncJobResponse) {
+
+    option (.wix.api.crud) = {
+      method: DELETE
+      delete_options: {
+        id_field: "job_id"
+      }
+    };
+
     option (google.api.http) = {
       delete: "/v1/async-jobs/{job_id}"
     };
@@ -194,7 +228,7 @@ message ReportAsyncJobProgressRequest {
   // id of the job to report progress on
   string job_id = 1;
 
-  repeated AsyncJobItem items = 2 [(wix.api.maxSize) = 100];
+  repeated AsyncJobItem items = 2 [(wix.api.maxSize) = 1000];
 }
 
 message ReportAsyncJobProgressResponse {}

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/inventory/api/v1/inventoryItem.proto

@@ -15,6 +15,7 @@ option java_package = "com.wix.ecommerce.inventory.api.v1";
 message InventoryItemV2 {
     option (wix.api.entity) = {
         fqdn: "wix.stores.v2.inventory"
+        app_def_id: "215238eb-22a5-4c36-9e7b-e7c08025e04e"
         segment: USERS
         appendix_files: {
             type: AUTO_VELO

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/inventory/api/v1/locationInventory.proto

@@ -0,0 +1,27 @@
+syntax = "proto3";
+
+package wix.inventory.api.v1;
+
+import "google/api/annotations.proto";
+import "wix/api/annotations.proto";
+import "wix/api/entity.proto";
+import "wix/api/permissions.proto";
+import "wix/inventory/api/v1/locationInventoryMessages.proto";
+
+option java_package = "com.wix.ecommerce.inventory.api.v1";
+
+service LocationInventoryReadApi {
+  option (.wix.api.service_exposure) = PRIVATE;
+  option (.wix.api.service_maturity) = ALPHA;
+  option (.wix.api.service_entity).message = "wix.inventory.api.v1.LocationInventoryItem";
+
+  /**
+   * Returns a specific inventory for an item at a given location
+   */
+  rpc FetchLocationInventoryItem (FetchLocationInventoryItemRequest) returns (FetchLocationInventoryItemResponse) {
+    option (.google.api.http).get = "/v2/location-inventory-items/location/{location_id}/product/{product_id}";
+    option (.wix.api.maturity) = ALPHA;
+    option (.wix.api.exposure) = INTERNAL;
+    option (.wix.api.permission).name = "WIX_STORES.READ_LOCATION_INVENTORY";
+  }
+}

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/inventory/api/v1/locationInventoryItem.proto

@@ -0,0 +1,75 @@
+syntax = "proto3";
+
+package wix.inventory.api.v1;
+
+import "google/protobuf/timestamp.proto";
+import "google/protobuf/wrappers.proto";
+import "wix/api/annotations.proto";
+import "wix/api/entity.proto";
+import "wix/api/validations.proto";
+import "wix/inventory/api/v1/preOrderInfo.proto";
+
+option java_package = "com.wix.ecommerce.inventory.api.v1";
+
+/**
+ * An inventory item is the record of inventory for a product and its variants at a given location
+ */
+message LocationInventoryItem {
+  option (.wix.api.entity) = {
+    fqdn: "wix.stores.v1.location_inventory"
+    segment: USERS
+  };
+
+  /**
+   * The ID of the inventory record for a given product.
+   * The value matches the ID of the product itself.
+   */
+  .google.protobuf.StringValue id = 1 [(.wix.api.readOnly) = true, (.wix.api.maxLength) = 36];
+
+  // The ID of the product that this inventory item is against
+  string product_id = 2 [
+    (.wix.api.immutable) = true,
+    (.wix.api.minLength) = 1,
+    (.wix.api.maxLength) = 36,
+    (.wix.api.referenced_entity) = "wix.stores.catalog.v1.product"
+  ];
+
+  // Variants associated with this inventory item.
+  repeated LocationInventoryVariant variants = 3 [(.wix.api.maxSize) = 1000000];
+
+  // The timestamp of when this record was last updated
+  .google.protobuf.Timestamp updated_date = 4 [(.wix.api.readOnly) = true];
+
+  // Inventory’s unique numeric ID (assigned in ascending order).
+  // Primarily for sorting and filtering when crawling all inventories.
+  //flynt-disable unsigned-integers-not-allowed
+  uint64 numeric_id = 5 [(.wix.api.readOnly) = true];
+
+  // Preorder information.
+  PreorderInfo preorder_info = 6;
+}
+
+message LocationInventoryVariant {
+  // The ID of the related product-variant.
+  string variant_id = 1 [(.wix.api.format) = GUID, (.wix.api.immutable) = true];
+
+  // The location that this variant-inventory is for.
+  string location_id = 2 [
+    (.wix.api.format) = GUID,
+    (.wix.api.immutable) = true,
+    (.wix.api.referenced_entity) = "wix.stores.catalog.v3.stores_location"
+  ];
+
+  // Whether the product is listed as in stock.
+  bool in_stock = 3;
+
+  // Quantity currently left in inventory.
+  .google.protobuf.Int32Value quantity = 4 [(.wix.api.min) = 0];
+
+  // Whether quantity is being tracked.
+  bool track_quantity = 5;
+
+  // Whether the variant is available for preorder.
+  // When `true`, the variant is out of stock and preorder is enabled on inventory item level.
+  bool available_for_preorder = 6 [(.wix.api.readOnly) = true];
+}

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/inventory/api/v1/locationInventoryMessages.proto

@@ -0,0 +1,33 @@
+syntax = "proto3";
+
+package wix.inventory.api.v1;
+
+import "wix/api/annotations.proto";
+import "wix/api/validations.proto";
+import "wix/inventory/api/v1/locationInventoryItem.proto";
+
+option java_package = "com.wix.ecommerce.inventory.api.v1";
+
+message FetchLocationInventoryItemRequest {
+  // The ID of the product which we're retrieving inventory item for
+  string product_id = 1 [
+    (.wix.api.immutable) = true,
+    (.wix.api.minLength) = 1,
+    (.wix.api.maxLength) = 36,
+    (.wix.api.referenced_entity) = "wix.stores.catalog.v1.product"
+  ];
+
+  // The ID of the location that the inventory is specific to
+  string location_id = 2 [
+    (.wix.api.format) = GUID,
+    (.wix.api.immutable) = true,
+    (.wix.api.referenced_entity) = "wix.stores.catalog.v3.stores_location"
+  ];
+}
+
+message FetchLocationInventoryItemResponse {
+
+  // The inventory item at the location
+  LocationInventoryItem location_inventory_item = 1;
+
+}

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/payment/api/pay/v2/accounts.proto

@@ -4,6 +4,7 @@ package wix.payment.api.pay.v2;
 
 import "google/api/annotations.proto";
 import "wix/payment/api/pay/v2/resources/account.proto";
+import "wix/api/annotations.proto";
 import "wix/api/entity.proto";
 
 option java_package = "com.wix.payment.api.pay.v2";
@@ -16,6 +17,13 @@ service AccountService {
     // Returns information about cashier account by its accountId (`appDefId:appInstanceId`)
     rpc Get(GetAccountRequest) returns (GetAccountResponse) {
         option (google.api.http) = { get: "/api/payments/v2/accounts/{accountId}" };
+        option (.wix.api.crud) = {
+            method: GET_ITEM
+            get_options: {
+                id_field: "accountId"
+                item_field: "account"
+            }
+        };
     }
 }
 

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/payment/api/pay/v2/orders.proto

@@ -148,6 +148,9 @@ service OrderService {
     //   [1]: ../../guides/Authentication%20and%20authorization
     rpc Get(GetOrderRequest) returns (GetOrderResponse) {
         option (google.api.http) = { get: "/api/payments/v2/orders/{order_id}" };
+        option (.wix.api.crud) = {
+            method: GET_ITEM
+        };
     };
 
     // If order is a subscription - cancels it. Otherwise, `CancelSubscriptionException` is thrown.
@@ -359,6 +362,8 @@ message CreateOrderRequest {
     // Idempotency key
     google.protobuf.StringValue idempotency_key = 5;
 
+    // Updated order expiration date
+    google.protobuf.Timestamp expiration_date = 6;
 }
 
 // Describing `Create` order response.
@@ -381,6 +386,9 @@ message UpdateOrderRequest {
 
     // Third party system urls which should be used when as callback/event_hook (required).
     OrderUrls urls               = 4;
+
+    // Updated order expiration date
+    google.protobuf.Timestamp expiration_date = 5;
 }
 
 message UpdateOrderResponse {
@@ -395,6 +403,8 @@ message SetupRequest {
     OrderBuyerInfo buyer_info         = 2;
     // Is this order creation initiated by merchant
     bool merchant_initiated           = 3;
+    // Order expiration date
+    google.protobuf.Timestamp expiration_date = 4;
 }
 
 message SetupResponse {

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/payment/api/pay/v2/payment-methods.proto

@@ -73,6 +73,7 @@ service PaymentMethodService {
     // - 403 - passed identity does not have permission to perform this action.
     //
     //   [1]: ../../guides/Authentication%20and%20authorization
+    //flynt-disable crud-add-get-annotation
     rpc Get(GetPaymentMethodRequest) returns (GetPaymentMethodResponse) {
         option (google.api.http) = {
             get: "/api/payments/v2/accounts/{account_id}/payment-methods/{payment_method}"
@@ -151,6 +152,9 @@ message ListPaymentMethodsRequest {
     // buyer's contactId
     // it's required to display saved payment methods that are allowed for MIT in case contact is a site member
     google.protobuf.StringValue buyer_contact_id    = 13;
+
+    // return only payment methods which support Setup Future Usages option
+    bool support_setup_future_usages                = 14;
 }
 
 message ListPaymentMethodsResponse {
@@ -183,6 +187,9 @@ message GetPaymentMethodRequest {
 
     // indicate that saving payment method for merchant use is enabled
     bool merchant_use_save_enabled      = 8;
+
+    // return payment method only if it supports Setup Future Usages option
+    bool support_setup_future_usages    = 9;
 }
 
 message GetPaymentMethodResponse {

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/payment/api/pay/v2/payments.proto

@@ -11,6 +11,7 @@ import "wix/payment/api/pay/v2/resources/payment.proto";
 import "google/api/annotations.proto";
 import "google/protobuf/timestamp.proto";
 import "google/protobuf/wrappers.proto";
+import "wix/api/annotations.proto";
 import "wix/api/validations.proto";
 import "wix/api/permissions.proto";
 
@@ -233,6 +234,9 @@ service PaymentService {
         option (google.api.http) = {
             get: "/api/payments/v2/charges/{charge_id}"
         };
+        option (.wix.api.crud) = {
+            method: GET_ITEM
+        };
     };
 
     // Updates info about given charge
@@ -281,6 +285,9 @@ message ChargeRequest {
 
     // for an idempotency key only one charge will be performed or error returned if approved/pending transactions already exist
     string idempotency_key         = 7;
+
+    // Order expiration date
+    google.protobuf.Timestamp expiration_date = 8;
 }
 
 message ChargeForOrderRequest {

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/payment/api/pay/v2/resources/charge.proto

@@ -156,7 +156,7 @@ message ChargeResponseToken {
 message GetMethodRedirect {
 
     // a properly encoded URL to perform an HTTP GET request
-    string url = 1 [(wix.api.format) = URI];
+    string url = 1 [(wix.api.format) = WEB_URL];
 }
 
 message PostMethodRedirect {
@@ -171,7 +171,7 @@ message PostMethodRedirect {
     }
 
     // a properly encoded URL to perform an HTTP POST request
-    string url = 1 [(wix.api.format) = URI];
+    string url = 1 [(wix.api.format) = WEB_URL];
 
     // not yet encoded form fields to send with the POST request using the application/x-www-form-urlencoded content type
     repeated FormField fields = 2;
@@ -208,7 +208,7 @@ message QrCodeDisplay {
 message WebPageDisplay {
 
     // a properly encoded URL to perform an HTTP GET request
-    string url = 1 [(wix.api.format) = URI];
+    string url = 1 [(wix.api.format) = WEB_URL];
 
     // date until charge should be completed
     google.protobuf.Timestamp expiration_date = 2;

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/payment/api/pay/v2/resources/order-description.proto

@@ -58,6 +58,12 @@ message OrderDescription {
   // information about subscription (required for `SUBSCRIPTION` order, not allowed for `ONE_TIME` order)
   Subscription subscription         = 20;
 
+  // should this order during its payment setup the Payment Agreement entity to allow other payments in future using this Payment Agreement
+  google.protobuf.BoolValue setup_future_usages = 21;
+
+  // the id of Payment Agreement which is suggested for payment for this order
+  google.protobuf.StringValue suggested_payment_agreement_id = 25;
+
   // order reference in third party system (required)
   string vertical_order_id          = 40;
   // buyer information which can use to provide better service (optional)

package/@wix/ambassador-fedinfra-exportservice-v1-export-async-job/src/main/proto/wix/payment/api/pay/v2/resources/payment-method.proto

@@ -97,6 +97,7 @@ message PaymentMethod {
     google.protobuf.BoolValue primary = 22;
 
     oneof saved_payment_method_details {
+        PayPalDetails pay_pal_details = 24;
         SavedCreditCardDetails saved_credit_card_details = 25;
     }
 
@@ -147,7 +148,8 @@ message SavedCreditCardDetails {
 }
 
 message PayPalDetails {
-
+    // Can be an email (obfuscated) of PayPal account
+    google.protobuf.StringValue account_name = 1 [(.wix.api.minLength) = 1, (.wix.api.maxLength) = 1000];
 }
 
 message SavedPaymentMethodDetails {