@wix/bex-utils 1.28.0

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

@@ -0,0 +1,246 @@
+//flynt-disable missing-permission, missing-service-entity, missing-field-comments, missing-method-comments, request-response, missing-rest-mapping, missing-main-entity-fqdn
+syntax = "proto3";
+
+import "google/protobuf/wrappers.proto";
+import "wix/api/entity.proto";
+
+package wix.infra.asyncjobs.v1;
+option java_package = "com.wixpress.infra.asyncinfra.asyncjobservice.v1";
+
+import "google/api/annotations.proto";
+import "google/protobuf/timestamp.proto";
+import "google/protobuf/field_mask.proto";
+import "google/protobuf/struct.proto";
+
+import "wix/http/field_mask.proto";
+import "wix/api/annotations.proto";
+import "wix/api/validations.proto";
+import "wix/api/callback.proto";
+import "wix/api/permissions.proto";
+import "wix/common/paging.proto";
+import "wix/infra/asyncjobs/v1/upstream/wix/common/paging.proto";
+
+import "wix/infra/asyncjobs/v1/AsyncJobItem.proto";
+import "wix/infra/asyncjobs/v1/AsyncJob.proto";
+
+service AsyncJobService {
+  option (wix.api.service_entity).message = "wix.infra.asyncjobs.v1.AsyncJob";
+
+  option (wix.api.event) = {
+    event_type: ACTION,
+    payload: "wix.infra.asyncjobs.v1.AsyncJobFinishedEvent"
+  };
+
+  option (wix.api.event) = {
+    event_type: ACTION,
+    payload: "wix.infra.asyncjobs.v1.AsyncJobFailedEvent"
+  };
+
+  option (wix.api.event) = {
+    event_type: ACTION,
+    payload: "wix.infra.asyncjobs.v1.AsyncJobItemFailedEvent"
+  };
+
+  rpc CreateAsyncJob (CreateAsyncJobRequest) returns (CreateAsyncJobResponse) {
+    option (google.api.http) = {
+      post: "/v1/async-jobs"
+    };
+
+    option (wix.api.permission) = {
+      name: "INFRA.ASYNC_JOB_MANAGE",
+      type: MANUAL
+    };
+
+    option (wix.api.callback) = {
+      event_type: CREATED
+    };
+
+    option (wix.api.maturity) = ALPHA;
+    option (wix.api.exposure) = INTERNAL;
+  }
+
+  rpc GetAsyncJob (GetAsyncJobRequest) returns (GetAsyncJobResponse) {
+    option (google.api.http) = {
+      get: "/v1/async-jobs/{job_id}"
+    };
+
+    option (wix.api.permission) = {
+      name: "INFRA.ASYNC_JOB_READ",
+      type: MANUAL
+    };
+
+    option (wix.api.maturity) = ALPHA;
+    option (wix.api.exposure) = INTERNAL;
+    option (wix.api.required) = "GetAsyncJobRequest.job_id";
+  }
+
+  rpc UpdateAsyncJob (UpdateAsyncJobRequest) returns (UpdateAsyncJobResponse) {
+    option (google.api.http) = {
+      put: "/v1/async-jobs/{job.id}"
+    };
+
+    option (wix.api.permission) = {
+      name: "INFRA.ASYNC_JOB_MANAGE",
+      type: MANUAL
+    };
+
+    option (wix.api.callback) = {
+      event_type: UPDATED
+    };
+
+    option (wix.api.maturity) = ALPHA;
+    option (wix.api.exposure) = INTERNAL;
+    option (wix.api.required) = "UpdateAsyncJobRequest.job.id";
+    option (wix.http.infer_fieldmask) = {
+      from: "job"
+      fieldmask: "mask"
+    };
+  }
+
+  rpc DeleteAsyncJob (DeleteAsyncJobRequest) returns (DeleteAsyncJobResponse) {
+    option (google.api.http) = {
+      delete: "/v1/async-jobs/{job_id}"
+    };
+    option (wix.api.permission) = {
+      name: "INFRA.ASYNC_JOB_MANAGE",
+      type: MANUAL
+    };
+
+    option (wix.api.callback) = {
+      event_type: DELETED
+    };
+
+    option (wix.api.maturity) = ALPHA;
+    option (wix.api.exposure) = INTERNAL;
+    option (wix.api.required) = "DeleteAsyncJobRequest.job_id";
+  }
+
+  rpc CompleteAsyncJob (CompleteAsyncJobRequest) returns (CompleteAsyncJobResponse) {
+    option (google.api.http) = {
+      put: "/v1/async-jobs/{job_id}/complete"
+    };
+
+    option (wix.api.permission) = {
+      name: "INFRA.ASYNC_JOB_MANAGE",
+      type: MANUAL
+    };
+
+    option (wix.api.maturity) = ALPHA;
+    option (wix.api.exposure) = INTERNAL;
+    option (wix.api.required) = "CompleteAsyncJobRequest.job_id";
+  }
+
+  // items
+  rpc ReportAsyncJobProgress (ReportAsyncJobProgressRequest) returns (ReportAsyncJobProgressResponse) {
+
+    option (wix.api.permission) = {
+      name: "INFRA.ASYNC_JOB_MANAGE",
+      type: MANUAL
+    };
+
+    option (wix.api.callback) = {
+      event_type: ACTION
+      payload: "wix.infra.asyncjobs.v1.AsyncJobItemAddedEvent"
+    };
+    option (wix.api.callback) = {
+      event_type: UPDATED
+    };
+  }
+
+  rpc ListAsyncJobItems (ListAsyncJobItemsRequest) returns (ListAsyncJobItemsResponse) {
+    option (google.api.http) = {
+      get: "/v1/async-jobs/{job_id}/items"
+    };
+    option (wix.api.permission).name = "INFRA.ASYNC_JOB_READ";
+    option (wix.api.required) = "ListAsyncJobItemsRequest.job_id";
+  }
+
+}
+message CreateAsyncJobRequest {
+  AsyncJob job = 1;
+}
+
+message CreateAsyncJobResponse {
+  AsyncJob job = 1;
+}
+
+message GetAsyncJobRequest {
+  string job_id = 1;
+}
+
+message GetAsyncJobResponse {
+  AsyncJob job = 1;
+}
+
+
+message UpdateAsyncJobRequest {
+  AsyncJob job = 1;
+  google.protobuf.FieldMask mask = 2;
+}
+
+message UpdateAsyncJobResponse {
+  AsyncJob job = 1;
+}
+
+message DeleteAsyncJobRequest {
+  string job_id = 1;
+}
+
+message DeleteAsyncJobResponse {
+}
+
+
+message ReportAsyncJobProgressRequest {
+  // id of the job to report progress on
+  string job_id = 1;
+
+  repeated AsyncJobItem items = 2 [(wix.api.maxSize) = 100];
+}
+
+message ReportAsyncJobProgressResponse {}
+
+message ListAsyncJobItemsRequest {
+  string job_id = 1;
+  wix.common.CursorPaging paging = 2;
+}
+
+message ListAsyncJobItemsResponse {
+  repeated AsyncJobItem results = 1;
+  wix.infra.asyncjobs.v1.upstream.wix.common.PagingMetadataV2 paging_metadata = 2;
+}
+
+
+message CompleteAsyncJobRequest {
+  string job_id = 1;
+  CompleteStatus status = 2;
+
+  enum CompleteStatus {
+    // Job is finished.
+    FINISHED = 0; // default behaviour
+    // Job is failed
+    FAILED = 1;
+  }
+}
+
+message CompleteAsyncJobResponse {}
+
+// Events
+message AsyncJobFinishedEvent {
+  string job_id = 1;
+}
+
+message AsyncJobFailedEvent {
+  string job_id = 1;
+}
+
+message AsyncJobItemAddedEvent {
+  string job_id = 1;
+  AsyncJobItem job_item = 2;
+}
+
+message AsyncJobItemFailedEvent {
+  string job_id = 1;
+  AsyncJobItem job_item = 2;
+}
+
+

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

@@ -0,0 +1,34 @@
+syntax = "proto3";
+
+package wix.infra.asyncjobs.v1.upstream.wix.common;
+
+import "google/protobuf/wrappers.proto";
+import "wix/api/annotations.proto";
+import "wix/api/validations.proto";
+
+option java_multiple_files = true;
+option java_package = "com.wixpress.infra.asyncinfra.asyncjobservice.v1.upstream.wix.common";
+
+
+message PagingMetadataV2 {
+    option (.wix.api.decomposite_of) = "wix.common.PagingMetadataV2";
+    // Number of items returned in the response.
+    google.protobuf.Int32Value count = 1;
+    // Cursors to navigate through the result pages using `next` and `prev`. Returned if cursor paging is used.
+    Cursors cursors = 5;
+    // Indicates if there are more results after the current page.
+    // If `true`, another page of results can be retrieved.
+    // If `false`, this is the last page.
+    google.protobuf.BoolValue has_next = 6 [(.wix.api.field_exposure) = PRIVATE];
+}
+
+message Cursors {
+    option (.wix.api.decomposite_of) = "wix.common.Cursors";
+    option (.wix.api.decomposition_minimum_fields) = {
+        field: "next"
+    };
+    // Cursor pointing to next page in the list of results.
+    google.protobuf.StringValue next = 1;
+    // Cursor pointing to previous page in the list of results.
+    google.protobuf.StringValue prev = 2;
+}

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

@@ -0,0 +1,225 @@
+syntax = "proto3";
+
+package wix.inventory.api.v1;
+
+import "google/api/annotations.proto";
+import "wix/api/annotations.proto";
+import "wix/api/validations.proto";
+import "wix/api/entity.proto";
+import "wix/inventory/api/v1/inventoryItem.proto";
+import "wix/api/callback.proto";
+import "wix/api/permissions.proto";
+import "wix/inventory/api/v1/query.proto";
+import "google/protobuf/struct.proto";
+import "google/protobuf/wrappers.proto";
+import "wix/sdk/definitions.proto";
+
+
+option java_package = "com.wix.ecommerce.inventory.api.v1";
+
+service InventoryReadApi {
+    option (wix.api.service_exposure) = PUBLIC;
+    option (wix.api.service_maturity) = GA;
+    option (wix.api.service_entity).message = "wix.inventory.api.v1.InventoryItemV2";
+
+    rpc GetInventoryVariants (GetInventoryVariantsRequest) returns (GetInventoryVariantsResponse) {
+        option (google.api.http) = {
+            post: "/v2/inventoryItems/{inventory_id}/getVariants"
+            additional_bindings {
+                post: "/v2/inventoryItems/external/{external_id}/getVariants"
+            }
+            additional_bindings {
+                post: "/v2/inventoryItems/product/{product_id}/getVariants"
+            }
+        };
+        option (wix.api.permission).name = "WIX_STORES.READ_INVENTORY";
+    }
+
+    rpc GetInventoryItems (GetInventoryItemsRequest) returns (GetInventoryItemsResponse) {
+        option (wix.api.exposure) = PRIVATE;
+        option (wix.api.permission).name = "WIX_STORES.READ_INVENTORY";
+    }
+
+    // Returns a list of up inventory items, given the provided paging, sorting and filtering.
+    //See [Stores Pagination](https://dev.wix.com/api/rest/wix-stores/pagination) for more information.
+    rpc QueryInventory (QueryInventoryRequest) returns (QueryInventoryResponse) {
+        option (google.api.http) = {
+            post: "/v2/inventoryItems/query"
+        };
+        option (wix.api.permission).name = "WIX_STORES.READ_INVENTORY";
+    }
+    // Triggered when an inventory item is changed.
+    option (wix.api.event) = {
+       topic: "wixStores-inventory-item-changed"
+       payload: "com.wix.ecommerce.inventory.api.v1.InventoryItemChanged"
+       permission: "WIX_STORES.READ_INVENTORY"
+    };
+    // Triggered when inventory variants are changed.
+    option (wix.api.event) = {
+       topic: "wixStores-inventory-variant-changed"
+       payload: "com.wix.ecommerce.inventory.api.v1.InventoryVariantsChanged"
+       permission: "WIX_STORES.READ_INVENTORY"
+    };
+}
+
+service InventoryWriteApi {
+    option (wix.api.service_exposure) = PUBLIC;
+    option (wix.api.service_maturity) = GA;
+    option (wix.api.service_entity).message = "wix.inventory.api.v1.InventoryItemV2";
+
+    //Updates product inventory, including total quantity, whether the product is in stock, and whether the product inventory is tracked.
+    rpc UpdateInventoryVariants (UpdateInventoryVariantsRequest) returns (UpdateInventoryVariantsResponse) {
+        option (wix.api.required) = "UpdateInventoryVariantsRequest.inventory_item";
+        option (google.api.http) = {
+            patch: "/v2/inventoryItems/product/{inventoryItem.product_id}"
+            additional_bindings {
+                patch: "/v2/inventoryItems/{inventoryItem.id}"
+            }
+            additional_bindings {
+                patch: "/v2/inventoryItems/external/{inventoryItem.external_id}"
+            }
+        };
+        option (wix.api.permission).name = "WIX_STORES.MODIFY_INVENTORY";
+    }
+
+    //Updates variants in bulk by filter, including total quantity, whether the product is in stock, and whether the product inventory is tracked.
+    rpc BulkUpdateInventoryVariants (BulkUpdateInventoryVariantsRequest) returns (BulkUpdateInventoryVariantsResponse) {
+        option (wix.api.required) = "BulkUpdateInventoryVariantsRequest.filter";
+        option (google.api.http) = {
+            patch: "/v2/inventoryItems/variants/bulk-update"
+        };
+        option (wix.api.maturity) = ALPHA;
+        option (wix.api.exposure) = INTERNAL;
+        option (wix.api.permission).name = "WIX_STORES.MODIFY_INVENTORY";
+    }
+
+    //Updates inventory tracking method in bulk by filter.
+    rpc BulkUpdateInventoryItems (BulkUpdateInventoryItemsRequest) returns (BulkUpdateInventoryItemsResponse) {
+        option (wix.api.required) = "BulkUpdateInventoryItemsRequest.variants_filter";
+        option (wix.api.required) = "BulkUpdateInventoryItemsRequest.track_inventory";
+        option (google.api.http) = {
+            patch: "/v2/inventoryItems/bulk-update"
+        };
+        option (wix.api.maturity) = ALPHA;
+        option (wix.api.exposure) = INTERNAL;
+        option (wix.api.permission).name = "WIX_STORES.MODIFY_INVENTORY";
+    }
+
+    //Subtracts a set number of items from inventory.
+    rpc DecrementInventory (DecrementInventoryRequest) returns (DecrementInventoryResponse) {
+        option (google.api.http) = {
+            post: "/v2/inventoryItems/decrement"
+        };
+        option (wix.api.maturity) = BETA;
+        option (wix.api.permission).name = "WIX_STORES.MODIFY_INVENTORY";
+        option (.wix.sdk.signature) = {params: "decrement_data"};
+    }
+    //Adds a set number of items to inventory.
+    rpc IncrementInventory (IncrementInventoryRequest) returns (IncrementInventoryResponse) {
+        option (google.api.http) = {
+            post: "/v2/inventoryItems/increment"
+        };
+        option (wix.api.maturity) = BETA;
+        option (wix.api.permission).name = "WIX_STORES.MODIFY_INVENTORY";
+        option (.wix.sdk.signature) = {params: "increment_data"};
+
+    }
+}
+
+message GetInventoryVariantsRequest {
+    oneof id {
+        // Inventory item ID.
+        string inventory_id = 1;
+        // Deprecated (use productID instead).
+        string external_id = 2 [deprecated = true];
+        // Product ID.
+        string product_id = 4;
+    }
+
+    // Variant IDs to query for this inventory item (optional).
+    repeated string variant_ids = 3;
+}
+
+message GetInventoryVariantsResponse {
+    // Inventory item.
+    InventoryItemV2 inventory_item = 1;
+}
+
+message GetInventoryItemsRequest {
+    // Product IDs
+    repeated string product_ids = 1;
+}
+
+message GetInventoryItemsResponse {
+    // Inventory items.
+    repeated InventoryItemV2 inventory_items = 1;
+}
+
+message UpdateInventoryVariantsRequest {
+    // Inventory item.
+    InventoryItemV2 inventory_item = 1;
+    .wix.inventory.api.v1.ReasonTypeWrapper.ReasonType reason = 3 [(.wix.api.field_exposure) = PRIVATE];
+}
+
+message UpdateInventoryVariantsResponse {
+}
+
+message BulkUpdateInventoryVariantsRequest {
+    // Variants filter. See documentation [here](https://bo.wix.com/wix-docs/rnd/platformization-guidelines/api-query-language#platformization-guidelines_api-query-language_defining-in-protobuf)
+    google.protobuf.Struct filter = 1;
+    oneof action {
+        // Change availability.
+        google.protobuf.BoolValue set_in_stock = 2;
+        // Set new quantity.
+        google.protobuf.Int32Value set_quantity = 3;
+        // Number to increment inventory by.
+        google.protobuf.Int32Value increment_by = 4 [(wix.api.min) = 1];
+        // Number to decrement inventory by.
+        google.protobuf.Int32Value decrement_by = 5 [(wix.api.min) = 1];
+    }
+    .wix.inventory.api.v1.ReasonTypeWrapper.ReasonType reason = 6 [(.wix.api.field_exposure) = PRIVATE];
+    bool changeTrackingMethod = 7 [(.wix.api.field_exposure) = PRIVATE];
+}
+
+message BulkUpdateInventoryVariantsResponse {
+}
+
+message BulkUpdateInventoryItemsRequest {
+    // Variants filter
+    google.protobuf.Struct variants_filter = 1;
+    // Whether inventory is being tracked.
+    google.protobuf.BoolValue track_inventory = 2;
+}
+
+message BulkUpdateInventoryItemsResponse {
+}
+
+message QueryInventoryRequest {
+    Query query = 1;
+}
+
+message QueryInventoryResponse {
+    //Inventory items.
+    repeated InventoryItemV2 inventory_items = 1;
+    //Display metadata.
+    PagingMetadata metadata = 2;
+    //Number of total results.
+    int32 totalResults = 3;
+}
+
+message DecrementInventoryRequest {
+    repeated DecrementData decrement_data = 1 [(wix.api.minSize) = 1, (wix.api.maxSize) = 300];
+    .wix.inventory.api.v1.ReasonTypeWrapper.ReasonType reason = 3 [(.wix.api.field_exposure) = PRIVATE];
+    bool restrict_inventory_value = 4 [(.wix.api.field_exposure) = PRIVATE];
+}
+
+message DecrementInventoryResponse {
+}
+
+message IncrementInventoryRequest {
+    repeated IncrementData increment_data = 1 [(wix.api.minSize) = 1, (wix.api.maxSize) = 300];
+    .wix.inventory.api.v1.ReasonTypeWrapper.ReasonType reason = 3 [(.wix.api.field_exposure) = PRIVATE];
+}
+
+message IncrementInventoryResponse {
+}

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

@@ -0,0 +1,95 @@
+syntax = "proto3";
+
+package wix.inventory.api.v1;
+
+import "wix/api/validations.proto";
+import "wix/api/annotations.proto";
+import "wix/api/entity.proto";
+import "google/protobuf/wrappers.proto";
+import "google/protobuf/timestamp.proto";
+import "wix/inventory/api/v1/preOrderInfo.proto";
+
+option java_package = "com.wix.ecommerce.inventory.api.v1";
+
+
+message InventoryItemV2 {
+    option (wix.api.entity) = {
+        fqdn: "wix.stores.v2.inventory"
+        segment: USERS
+        appendix_files: {
+            type: AUTO_VELO
+            path: "appendices/velo"
+        }
+    };
+
+    // Inventory item ID.
+    google.protobuf.StringValue id = 1;
+    // Deprecated: use productId.
+    google.protobuf.StringValue external_id = 2 [(wix.api.readOnly) = true, deprecated = true];
+    // Product ID.
+    google.protobuf.StringValue product_id = 7 [(wix.api.readOnly) = true];
+    // Whether quantity is being tracked.
+    google.protobuf.BoolValue track_quantity = 3;
+    // Variants associated with this inventory item.
+    repeated InventoryVariantV2 variants = 4;
+    // Last updated timestamp.
+    google.protobuf.Timestamp last_updated = 5 [(wix.api.readOnly)=true];
+    // Inventory’s unique numeric ID (assigned in ascending order).
+    // Primarily for sorting and filtering when crawling all inventories.
+    uint64 numericId = 6 [(wix.api.readOnly) = true];
+    // Preorder information.
+    PreorderInfo preorder_info = 8;
+}
+
+message InventoryVariantV2 {
+    // Variant ID.
+    string variant_id = 1;
+    // Whether the product is listed as in stock.
+    google.protobuf.BoolValue in_stock = 2;
+    // Quantity currently left in inventory.
+    google.protobuf.Int32Value quantity = 3 [(wix.api.min) = 0];
+    // Whether the variant is available for preorder. When `true`, the variant is out of stock and preorder is enabled on inventory level.
+    bool available_for_preorder = 4 [(wix.api.readOnly) = true];
+}
+
+message DecrementData {
+    oneof id {
+        // Inventory item ID.
+        string inventory_id = 1 [(wix.api.maxLength) = 36];
+        // Deprecated: use productId.
+        string external_id = 2 [(wix.api.maxLength) = 36, deprecated = true];
+        // Product ID.
+        string product_id = 5 [(wix.api.maxLength) = 36];
+    }
+    // Variant ID.
+    string variant_id = 3 [(wix.api.format) = GUID];
+    // Number to decrement inventory by.
+    int32 decrement_by = 4 [(wix.api.min) = 1];
+    // Whether the request to decrement the item's inventory was made as part of a purchase that includes preorder items.
+    // If true and the item is available for preorder, we allow negative inventory.
+    // If false and the item is not available for preorder, we allow regular buy flow (no negative inventory).
+    bool preorder_request = 6;
+}
+
+message ReasonTypeWrapper {
+    enum ReasonType {
+        UNKNOWN = 0;
+        ORDER = 1;
+        MANUAL = 2;
+        REVERT_INVENTORY_CHANGE = 3;
+    }
+}
+
+message IncrementData {
+    oneof id {
+        // Inventory item ID.
+        string inventory_id = 1 [(wix.api.maxLength) = 36];
+        // Product ID.
+        string product_id = 5 [(wix.api.maxLength) = 36];
+    }
+    // Variant ID.
+    string variant_id = 3 [(wix.api.format) = GUID];
+    // Number to increment inventory by.
+    int32 increment_by = 4 [(wix.api.min) = 1];
+}
+

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

@@ -0,0 +1,16 @@
+syntax = "proto3";
+
+package wix.inventory.api.v1;
+
+import "wix/api/validations.proto";
+import "google/protobuf/wrappers.proto";
+
+option java_package = "com.wix.ecommerce.inventory.api.v1";
+message PreorderInfo {
+    // Whether the item is available for preorder.
+    bool enabled = 1;
+    // A message the buyer will see when the item is out of stock and preorder is enabled.
+    google.protobuf.StringValue message = 2 [(.wix.api.minLength) = 1, (.wix.api.maxLength) = 250];
+    // Number of products that can be preordered after stock reaches zero.
+    google.protobuf.Int32Value limit = 3 [(.wix.api.min) = 1, (.wix.api.max) = 100000];
+}

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

@@ -0,0 +1,30 @@
+syntax = "proto3";
+
+package wix.inventory.api.v1;
+
+import "wix/api/validations.proto";
+import "google/protobuf/wrappers.proto";
+
+option java_package = "com.wix.ecommerce.inventory.api.v1";
+
+message Query {
+    Paging paging = 1;
+    // Filter string
+    google.protobuf.StringValue filter = 2;
+    // Sort string
+    google.protobuf.StringValue sort = 3;
+}
+
+message Paging {
+    // Amount of items to load per page
+    google.protobuf.Int32Value limit = 1 [(wix.api.min) = 0, (wix.api.max) = 100];
+    // Number of items to skip in the display (relevant for all pages after the first)
+    google.protobuf.Int32Value offset = 2 [(wix.api.min) = 0];
+}
+
+message PagingMetadata {
+    // Amount of items to load per page
+    int32 items = 1;
+    // Number of items to skip in the display (relevant for all pages after the first)
+    int32 offset = 2;
+}

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

@@ -0,0 +1,30 @@
+syntax = "proto3";
+
+package wix.payment.api.pay.v2;
+
+import "google/api/annotations.proto";
+import "wix/payment/api/pay/v2/resources/account.proto";
+import "wix/api/entity.proto";
+
+option java_package = "com.wix.payment.api.pay.v2";
+
+// Accounts service
+service AccountService {
+
+    option (wix.api.service_entity).message = "wix.payment.api.pay.v2.Account";
+
+    // 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}" };
+    }
+}
+
+message GetAccountRequest {
+    // accountId (`appDefId:appInstanceId`) of requested account
+    string accountId = 1;
+}
+
+message GetAccountResponse {
+    // account information
+    Account account = 1;
+}