{
  "openapi": "3.1.1",
  "info": {
    "title": "PayNow Management API",
    "description": "The Management API provides tools for store administration, accessible by a store API key. It enables operations such as updating product prices, creating promotional coupons, managing customer inventories, and other backend store management functions.This API must be called from a secure server and requires proper authentication.",
    "termsOfService": "https://paynow.gg/terms-of-use",
    "contact": {
      "name": "PayNow Services, Inc.",
      "url": "https://paynow.gg",
      "email": "support@paynow.gg"
    },
    "version": "v1"
  },
  "paths": {
    "/v1/stores/{storeId}/affiliate-links": {
      "get": {
        "tags": [
          "affiliate-links"
        ],
        "summary": "Get affiliate links",
        "description": "Retrieves all affiliate links for the specified store.",
        "operationId": "AffiliateLinks_GetAffiliateLinks",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve affiliate links for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AffiliateLinkDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_affiliate_links",
          "description": "Lists every affiliate link. Not paginated. Use it to find a link's ID.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "affiliate-links"
        ],
        "summary": "Create affiliate link",
        "description": "Creates a new affiliate link in the specified store.",
        "operationId": "AffiliateLinks_CreateAffiliateLink",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the affiliate link in.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The affiliate link to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAffiliateLinkDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAffiliateLinkDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateAffiliateLinkDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AffiliateLinkDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_affiliate_link",
          "description": "Creates an affiliate (referral) link. Reminder: percentages are tenths of a percent (125 = 12.5%), fixed amounts are in the smallest currency unit, and a fixed 'commission_type' is not supported yet.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/affiliate-links/{affiliateLinkId}": {
      "get": {
        "tags": [
          "affiliate-links"
        ],
        "summary": "Get affiliate link by ID",
        "description": "Retrieves an affiliate link by the ID for the specified store.",
        "operationId": "AffiliateLinks_GetAffiliateLink",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the affiliate link for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "affiliateLinkId",
            "in": "path",
            "description": "The ID of the affiliate link.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AffiliateLinkDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_affiliate_link",
          "description": "Returns one affiliate link by ID. Lookup is by ID, not by code.",
          "readOnly": true
        }
      },
      "patch": {
        "tags": [
          "affiliate-links"
        ],
        "summary": "Update affiliate link by ID",
        "description": "Performs a delta update of an affiliate link by the ID for the specified store.",
        "operationId": "AffiliateLinks_UpdateAffiliateLink",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update the affiliate link for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "affiliateLinkId",
            "in": "path",
            "description": "The ID of the affiliate link.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The affiliate link fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAffiliateLinkDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAffiliateLinkDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateAffiliateLinkDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AffiliateLinkDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_affiliate_link",
          "description": "Partial update. Send only the fields to change. Changing 'code' changes the live referral URL. Same units as create.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "affiliate-links"
        ],
        "summary": "Delete affiliate link by ID",
        "description": "Deletes an affiliate link by the ID for the specified store.",
        "operationId": "AffiliateLinks_DeleteAffiliateLink",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to delete the affiliate link for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "affiliateLinkId",
            "in": "path",
            "description": "The ID of the affiliate link.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_affiliate_link",
          "description": "Permanently deletes an affiliate link. To pause one instead, set 'enabled' to false.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/bans": {
      "get": {
        "tags": [
          "bans"
        ],
        "summary": "Get bans",
        "description": "Retrieves all bans for the specified store.",
        "operationId": "Bans_GetBans",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve bans for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "ban_type",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/BanType"
            }
          },
          {
            "name": "ban_type_value",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "reason",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/BanDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_bans",
          "description": "Lists bans, newest first, with optional filters and cursor paging. To check a specific identity, use paynow_check_ban instead.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "bans"
        ],
        "summary": "Create ban",
        "description": "Creates a new ban in the specified store.",
        "operationId": "Bans_CreateBan",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the ban in.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The ban to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertBanRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertBanRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertBanRequestDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BanDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_ban",
          "description": "Bans one or more identities (Steam ID, IP, customer, customer name or email). If you dont provide an expiry the ban is permanent.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/bans/{banId}": {
      "get": {
        "tags": [
          "bans"
        ],
        "summary": "Get ban by ID",
        "description": "Retrieves a ban by the ID for the specified store.",
        "operationId": "Bans_GetBan",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the ban for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "banId",
            "in": "path",
            "description": "The ID of the ban.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BanDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_ban",
          "description": "Returns one ban by ID, including every identity it covers.",
          "readOnly": true
        }
      },
      "patch": {
        "tags": [
          "bans"
        ],
        "summary": "Update ban by ID",
        "description": "Updates a ban by the ID for the specified store.",
        "operationId": "Bans_UpdateBan",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update the ban for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "banId",
            "in": "path",
            "description": "The ID of the ban.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The ban details to store.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertBanRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertBanRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertBanRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BanDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_ban",
          "description": "Full replace, not a partial update. omitted identities are dropped. Read the ban first and send back the complete list.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "bans"
        ],
        "summary": "Delete ban by ID",
        "description": "Deletes a ban by the ID for the specified store.",
        "operationId": "Bans_DeleteBan",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to delete the ban for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "banId",
            "in": "path",
            "description": "The ID of the ban.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_ban",
          "description": "Removes a ban and unbans every identity it covers. Cannot be undone.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/bans/check": {
      "post": {
        "tags": [
          "bans"
        ],
        "summary": "Check for ban by identities",
        "description": "Checks whether any of the supplied identities are banned in the specified store.",
        "operationId": "Bans_CheckForBanByIdentities",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to check the identities for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The identities to check.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CheckForBanIDByIdentitiesRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CheckForBanIDByIdentitiesRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CheckForBanIDByIdentitiesRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CheckForBanIDByIdentitiesResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_check_ban",
          "description": "Checks whether any of the given identities is banned and returns the matching ban ID. Read-only despite being a POST.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/billing/plans": {
      "get": {
        "tags": [
          "billing"
        ],
        "summary": "Get available plans",
        "description": "Retrieves the plans a store can subscribe to.",
        "operationId": "StoreBilling_GetPublicPlans",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PlanPreviewDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/billing/plans/change": {
      "post": {
        "tags": [
          "billing"
        ],
        "summary": "Change subscription plan",
        "description": "Moves the store onto a different plan. When the change needs paying for, the response\ncarries a 'session_url' the store owner must complete.",
        "operationId": "StoreBilling_ChangeSubscriptionPlan",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to change the plan for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The plan to move onto and how often it should renew.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangeSubscriptionPlanDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangeSubscriptionPlanDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ChangeSubscriptionPlanDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CheckoutSessionDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/billing/plans/continue": {
      "post": {
        "tags": [
          "billing"
        ],
        "summary": "Continue current subscription",
        "description": "Cancels a pending downgrade or cancellation, keeping the store on its current plan.",
        "operationId": "StoreBilling_ContinueCurrentSubscription",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to keep on its current plan.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/billing/payment-method/change": {
      "post": {
        "tags": [
          "billing"
        ],
        "summary": "Create payment method update session",
        "description": "Returns a customer portal session scoped to updating the payment method of the store's\nactive subscription. The store owner has to visit the returned 'session_url' to complete\nthe update.",
        "operationId": "StoreBilling_CreatePaymentMethodUpdateSession",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to change the payment method for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentMethodUpdateSessionDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/billing/orders": {
      "get": {
        "tags": [
          "billing"
        ],
        "summary": "Get billing orders",
        "description": "Retrieves the orders placed for the store's own subscription. Only the store owner may\ncall this.",
        "operationId": "StoreBilling_GetStoreBillingOrders",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve billing orders for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StorefrontOrderDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/billing/orders/{orderId}/invoice": {
      "get": {
        "tags": [
          "billing"
        ],
        "summary": "Get billing order invoice",
        "description": "Generates the invoice for one of the store's billing orders, if it does not exist yet, and returns a\ntemporary URL to download it. Only the store owner may call this.",
        "operationId": "StoreBilling_GetStoreBillingOrderInvoice",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the billing order belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "The ID of the billing order to retrieve the invoice for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DownloadUrlResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/billing/invoices/legacy": {
      "get": {
        "tags": [
          "billing"
        ],
        "summary": "Get legacy invoices",
        "description": "Retrieves the invoices Stripe Billing raised for the store's subscription before the store moved to\nPayNow, newest first. Only the store owner may call this.",
        "operationId": "StoreBilling_GetLegacyStoreInvoices",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve legacy invoices for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/LegacyStoreInvoiceDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/billing/invoices/legacy/{invoiceId}": {
      "get": {
        "tags": [
          "billing"
        ],
        "summary": "Get legacy invoice",
        "description": "Returns a URL to download one of the store's Stripe Billing invoices. Only the store owner may\ncall this.",
        "operationId": "StoreBilling_GetLegacyStoreInvoice",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the invoice belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "invoiceId",
            "in": "path",
            "description": "The Stripe identifier of the invoice, starting with 'in_'.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DownloadUrlResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/billing/details": {
      "get": {
        "tags": [
          "billing"
        ],
        "summary": "Get billing details",
        "description": "Retrieves the billing address and tax details the store is invoiced under.",
        "operationId": "StoreBilling_GetStoreBillingDetails",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve billing details for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StoreBillingDetailsDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      },
      "put": {
        "tags": [
          "billing"
        ],
        "summary": "Update billing details",
        "description": "Replaces the billing address and tax details the store is invoiced under.",
        "operationId": "StoreBilling_UpdateStoreBillingDetails",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update billing details for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The billing address and tax details to store.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/StoreBillingDetailsDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/StoreBillingDetailsDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/StoreBillingDetailsDto"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/billing/status": {
      "get": {
        "tags": [
          "billing"
        ],
        "summary": "Get billing status",
        "description": "Retrieves the store's plan, limits, feature flags and subscription state.",
        "operationId": "StoreBilling_GetStoreBillingStatus",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve billing status for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StoreBillingStatusDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/chargebacks": {
      "get": {
        "tags": [
          "chargebacks"
        ],
        "summary": "Get chargebacks",
        "description": "Retrieves all chargebacks and pre-chargeback inquiries for the specified store using the filter specified.",
        "operationId": "StoreChargebacks_GetChargebacks",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve chargebacks for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "order_id",
            "in": "query",
            "description": "Filter by order ID.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customer_id",
            "in": "query",
            "description": "Filter by customer ID.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "status",
            "in": "query",
            "description": "Filter by chargeback statuses.",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/TrustChargebackStatus"
              }
            }
          },
          {
            "name": "stage",
            "in": "query",
            "description": "Filter by chargeback stage.",
            "schema": {
              "$ref": "#/components/schemas/TrustChargebackStage"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StoreChargebackDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/chargebacks/{chargebackId}": {
      "get": {
        "tags": [
          "chargebacks"
        ],
        "summary": "Get chargeback by ID",
        "description": "Retrieves a chargeback or pre-chargeback inquiry by an ID.",
        "operationId": "StoreChargebacks_GetChargebackById",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the chargeback for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "chargebackId",
            "in": "path",
            "description": "The ID of the chargeback.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StoreChargebackDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/checkouts": {
      "post": {
        "tags": [
          "checkout"
        ],
        "summary": "Create a checkout session",
        "description": "Creates a checkout session from a secure server using an API Key.\nIf you have a Customer token, see the Storefront API Create Checkout endpoint.",
        "operationId": "StoreCheckouts_CreateCheckoutSession",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckoutSessionManagementDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckoutSessionManagementDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCheckoutSessionManagementDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateCheckoutSessionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/checkout-style": {
      "get": {
        "tags": [
          "checkout-style"
        ],
        "summary": "Get store checkout style",
        "description": "Retrieves the checkout styling for the store.",
        "operationId": "StoreCheckoutStyle_GetStoreCheckoutStyle",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CheckoutStyleDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_checkout_style",
          "description": "Returns the hosted checkout's styling: font family, border radius, colours and the background image URL.",
          "readOnly": true
        }
      },
      "patch": {
        "tags": [
          "checkout-style"
        ],
        "summary": "Update store checkout style",
        "description": "Updates the stores checkout style.",
        "operationId": "StoreCheckoutStyle_UpdateStoreCheckoutStyle",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCheckoutStyleDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCheckoutStyleDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCheckoutStyleDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CheckoutStyleDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_checkout_style",
          "description": "Partial update. Send only the fields to change. Colours are hex strings. The background image is uploaded through the dashboard, not set here.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/checkout-style/background-image": {
      "delete": {
        "tags": [
          "checkout-style"
        ],
        "summary": "Delete checkout background image",
        "description": "Removes the hosted checkout background image for the store.",
        "operationId": "StoreCheckoutStyle_DeleteStoreCheckoutStyleBackgroundImage",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/coupons": {
      "post": {
        "tags": [
          "coupons"
        ],
        "summary": "Create coupon",
        "description": "Creates a new coupon in the specified store.",
        "operationId": "Coupons_CreateCoupon",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the coupon in.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The coupon to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCouponDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCouponDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCouponDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CouponDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_coupon",
          "description": "Creates a coupon code customers enter at checkout. Reminder: percentage discounts are tenths of a percent (100 = 10%), amounts are in the smallest currency unit, and redeem limits only apply when both the enabled flag and the amount are set.",
          "readOnly": false
        }
      },
      "get": {
        "tags": [
          "coupons"
        ],
        "summary": "Get coupons",
        "description": "Retrieves all coupons for the specified store.",
        "operationId": "Coupons_GetCoupons",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve coupons for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "status",
            "in": "query",
            "description": "Filter by status",
            "schema": {
              "$ref": "#/components/schemas/CouponFilterStatusDto"
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "Filter by creation type of coupons.",
            "schema": {
              "$ref": "#/components/schemas/CouponFilterTypeDto"
            }
          },
          {
            "name": "usable_by_customer_id",
            "in": "query",
            "description": "Filter by ID of the customer this coupon is assigned to.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CouponDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_coupons",
          "description": "Lists coupons, newest first, with cursor paging. Filter 'type' to manual to exclude coupons generated automatically by marketing flows.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/coupons/{couponId}": {
      "get": {
        "tags": [
          "coupons"
        ],
        "summary": "Get coupon by ID",
        "description": "Retrieves a coupon by the ID for the specified store.",
        "operationId": "Coupons_GetCouponById",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the coupon for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "couponId",
            "in": "path",
            "description": "The ID of the coupon.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CouponDto"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_coupon",
          "description": "Returns one coupon by ID. Lookup is by ID, not by code; find IDs with paynow_list_coupons or paynow_search_dashboard. Use paynow_search_dashboard when you need to fuzzy search.",
          "readOnly": true
        }
      },
      "patch": {
        "tags": [
          "coupons"
        ],
        "summary": "Update coupon by ID",
        "description": "Performs a delta update of a coupon by the ID for the specified store.",
        "operationId": "Coupons_UpdateCoupon",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update the coupon for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "couponId",
            "in": "path",
            "description": "The ID of the coupon.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The coupon fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCouponDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCouponDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateCouponDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CouponDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_coupon",
          "description": "Partial update. Send only the fields to change. 'apply_to_products' and 'apply_to_tags' are replaced wholesale when present. Same units as create.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "coupons"
        ],
        "summary": "Delete coupon by ID",
        "description": "Deletes a coupon by the ID for the specified store.",
        "operationId": "Coupons_DeleteCoupon",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to delete the coupon for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "couponId",
            "in": "path",
            "description": "The ID of the coupon.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_coupon",
          "description": "Permanently deletes a coupon. To stop it working instead, set 'enabled' to false.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/custom-variables": {
      "post": {
        "tags": [
          "custom-variables"
        ],
        "summary": "Create custom variable",
        "description": "Creates a new custom variable for the specified store.\nCustom variables allow customers to provide additional input when purchasing products.",
        "operationId": "CustomVariables_CreateCustomVariable",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the custom variable in.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The custom variable data to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertCustomVariableRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertCustomVariableRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertCustomVariableRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomVariableDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_custom_variable",
          "description": "Creates a custom variable customers fill in at checkout, substituted into delivery commands. Reminder: 'value_regex' is RE2 (no lookarounds), dropdowns need 'options', and option percentage prices are tenths of a percent.",
          "readOnly": false
        }
      },
      "get": {
        "tags": [
          "custom-variables"
        ],
        "summary": "Get custom variables",
        "description": "Retrieves all custom variables for the specified store.",
        "operationId": "CustomVariables_GetCustomVariables",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve custom variables for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CustomVariableDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_custom_variables",
          "description": "Lists every custom variable with its options. Not paginated.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/custom-variables/{customVariableId}": {
      "get": {
        "tags": [
          "custom-variables"
        ],
        "summary": "Get custom variable",
        "description": "Retrieves a specific custom variable by ID from the specified store.",
        "operationId": "CustomVariables_GetCustomVariableById",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the custom variable belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customVariableId",
            "in": "path",
            "description": "The ID of the custom variable to retrieve.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomVariableDto"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_custom_variable",
          "description": "Returns one custom variable by ID with its options.",
          "readOnly": true
        }
      },
      "patch": {
        "tags": [
          "custom-variables"
        ],
        "summary": "Update custom variable",
        "description": "Performs a partial update of a custom variable using field mask.\nOnly the fields specified in the request will be updated.",
        "operationId": "CustomVariables_UpdateCustomVariable",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the custom variable belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customVariableId",
            "in": "path",
            "description": "The ID of the custom variable to update.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The custom variable data to update with field mask.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertCustomVariableRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertCustomVariableRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertCustomVariableRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomVariableDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_custom_variable",
          "description": "Partial update. Send only the fields to change, but 'options' replaces the entire option list. Read the variable first and include every option to keep, with its 'id'.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "custom-variables"
        ],
        "summary": "Delete custom variable",
        "description": "Deletes a custom variable from the specified store.\nThis will also delete all associated options and cannot be undone.",
        "operationId": "CustomVariables_DeleteCustomVariable",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the custom variable belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customVariableId",
            "in": "path",
            "description": "The ID of the custom variable to delete.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_custom_variable",
          "description": "Permanently deletes a custom variable and all of its options. Commands that reference its identifier stop receiving a value.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/customers/{customerId}/portal-sessions": {
      "post": {
        "tags": [
          "customer-portal-sessions"
        ],
        "summary": "Create a customer portal session",
        "description": "Creates a customer portal session from a secure server using an API Key.\nThe returned session contains the token and URL to hand to the customer.",
        "operationId": "CustomersPortalSessions_CreateCustomerPortalSession",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the portal session for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "description": "The ID of the customer to create the portal session for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The portal session data.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerPortalSessionRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerPortalSessionRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateCustomerPortalSessionRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomerPortalSessionDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/customers": {
      "get": {
        "tags": [
          "customers"
        ],
        "summary": "Get customers",
        "description": "Retrieves all customers for the specified store.",
        "operationId": "Customers_GetCustomers",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve customers for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "search",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "customer_id",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/FlakeId"
              }
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CustomerDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_customers",
          "description": "Lists or searches customers with cursor paging. Passing 'customer_id' values loads platform profiles and ignores paging. For finding a customer by name or identity, paynow_search_dashboard is preferred.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "customers"
        ],
        "summary": "Create customer",
        "description": "Creates a new customer based on the fields passed.",
        "operationId": "Customers_CreateCustomer",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the customer for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The customer to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertCustomerRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertCustomerRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertCustomerRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomerDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_customer",
          "description": "Creates a customer from at least one platform identity.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/customers/{customerId}": {
      "get": {
        "tags": [
          "customers"
        ],
        "summary": "Get customer by ID",
        "description": "Retrieves a customer by the ID for the specified store.",
        "operationId": "Customers_GetCustomerById",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the customer for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "description": "The ID of the customer.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomerDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_customer",
          "description": "Returns one customer by ID with their platform profiles.",
          "readOnly": true
        }
      },
      "patch": {
        "tags": [
          "customers"
        ],
        "summary": "Update customer",
        "description": "Updates an existing customer based on the fields passed.",
        "operationId": "Customers_UpdateCustomer",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update the customer for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "description": "The ID of the customer.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The customer fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertCustomerRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertCustomerRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertCustomerRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomerDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_customer",
          "description": "Partial update. Send only the fields to change. 'metadata' keys are merged, and identities cannot be cleared by sending null.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/customers/{customerId}/tokens": {
      "post": {
        "tags": [
          "customers"
        ],
        "summary": "Create customer token",
        "description": "Generates a customer token that can be used by the Storefront (Headless) API.",
        "operationId": "Customers_CreateCustomerToken",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to generate the customer token for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "description": "The ID of the customer to generate the customer token for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomerTokenResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_customer_token",
          "description": "Creates a storefront access token that acts as this customer. The token is a secret: return it only when the user explicitly asked for one. Tokens cannot be revoked through MCP.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "customers"
        ],
        "summary": "Invalidate customer tokens",
        "description": "Invalidates all generated customer tokens.",
        "operationId": "Customers_InvalidateCustomerTokens",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to invalidate the customer tokens for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "description": "The ID of the customer to invalidate the customer tokens for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/customers/lookup": {
      "get": {
        "tags": [
          "customers"
        ],
        "summary": "Lookup customer",
        "description": "Looks up a customer by an external platform ID.",
        "operationId": "Customers_LookupCustomer",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the customer for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "id",
            "in": "query",
            "description": "Looks up customer by PayNow Customer ID.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "steam_id",
            "in": "query",
            "description": "Looks up customer by Steam ID 64.",
            "schema": {
              "$ref": "#/components/schemas/SteamId"
            }
          },
          {
            "name": "minecraft_uuid",
            "in": "query",
            "description": "Looks up customer by a Minecraft UUID.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "xbox_xuid",
            "in": "query",
            "description": "Looks up customer by an Xbox XUID.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "minecraft_java_name",
            "in": "query",
            "description": "Looks up customer by Minecraft Java name.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "minecraft_bedrock_name",
            "in": "query",
            "description": "Looks up customer by Minecraft Bedrock name.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "name",
            "in": "query",
            "description": "Looks up customer by a PayNow Customer Name.\nName has to be explicitly set in the Customer entity - profile names won't be matched.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomerDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_lookup_customer",
          "description": "Finds one customer by a single platform identity (PayNow ID, Steam ID 64, Minecraft UUID, Xbox XUID or name). Pass exactly one identity. Extra ones are ignored.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/customers/bulk": {
      "post": {
        "tags": [
          "customers"
        ],
        "summary": "Bulk create customers",
        "description": "Creates up to 200 customers at once.",
        "operationId": "Customers_BulkCreateCustomers",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the customers for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The customers to create.",
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/UpsertCustomerRequestDto"
                }
              }
            },
            "text/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/UpsertCustomerRequestDto"
                }
              }
            },
            "application/*+json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/UpsertCustomerRequestDto"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CustomerDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_customers_bulk",
          "description": "Creates up to 200 customers in one call. Same fields as paynow_create_customer.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/dashboard/search": {
      "get": {
        "tags": [
          "dashboard"
        ],
        "summary": "Search dashboard",
        "description": "Performs a fast search across all searchable dashboard resources.\n            \nThis endpoint should always be preferred when searching for anything within a store. It is backed by a dedicated search index and is significantly faster than the\nper-resource search filters, such as the search parameter on GET /v1/stores/{storeId}/customers\n            \nResults can be narrowed to a single resource with search_result_type, or refined with search_hints\nCall the search hints endpoint to discover the supported hint prefixes",
        "operationId": "Dashboard_SearchDashboard",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to search within.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "query",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search_hints",
            "in": "query",
            "style": "deepObject",
            "schema": {
              "type": "object",
              "additionalProperties": {
                "type": "string"
              }
            }
          },
          {
            "name": "search_result_type",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/DashboardSearchResultTypeDto"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchDashboardResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_search_dashboard",
          "description": "Searches the whole store at once (customers, orders, products, coupons, sales, gift cards, tags, affiliate links, trials, subscriptions, bans, game servers, API keys, tier groups, custom variables, global commands, webhooks, email templates, email deliveries). Prefer this for finding an ID by name, email, code or identity. Use paynow_list_dashboard_search_hints for the supported qualifiers.",
          "readOnly": true,
          "standalone": true
        }
      }
    },
    "/v1/stores/{storeId}/dashboard/search-hints": {
      "get": {
        "tags": [
          "dashboard"
        ],
        "summary": "Get dashboard search hints",
        "description": "Retrieves the search hints supported by dashboard search. Each hint describes a prefix (for example a field qualifier), an example usage, and what it filters on.\n            \nUse this endpoint to discover which hints are available before building a query for the dashboard search endpoint, which is the preferred way of searching a store\nbecause it is far faster than the per-resource search filters, such as the search parameter on GET /v1/stores/{storeId}/customers",
        "operationId": "Dashboard_GetDashboardSearchHints",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DashboardSearchHintDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_list_dashboard_search_hints",
          "description": "Lists the qualifiers paynow_search_dashboard accepts in 'search_hints'.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/data-migrations": {
      "get": {
        "tags": [
          "data-migrations"
        ],
        "summary": "Get data migrations",
        "description": "Retrieves all data migration tasks for the specified store.",
        "operationId": "DataMigrations_GetDataMigrations",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve data migrations for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DataMigrationTaskDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_data_migrations",
          "description": "Lists imports from other platforms such as Tebex with their progress. A task with neither 'completed_at' nor 'failed_at' is still running. Migrations can only be started from the dashboard.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/data-migrations/tebex": {
      "post": {
        "tags": [
          "data-migrations"
        ],
        "operationId": "DataMigrations_StartDataMigrationFromTebex",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/StartDataMigrationFromTebexRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/StartDataMigrationFromTebexRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/StartDataMigrationFromTebexRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DataMigrationTaskDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/orders/{orderId}/delivery/items": {
      "get": {
        "tags": [
          "delivery"
        ],
        "summary": "Get delivery items associated with an order",
        "description": "Retrieves all delivery items associated with a specific order.",
        "operationId": "OrdersDelivery_GetOrderDeliveryItems",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "The ID of the order to retrieve delivery items from.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "activeOnly",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DeliveryItemDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/orders/{orderId}/command-delivery": {
      "get": {
        "tags": [
          "delivery"
        ],
        "summary": "Get delivery items associated with an order",
        "description": "**Deprecated:** \n\nRetrieves all delivery items associated with a specific order.",
        "operationId": "LegacyOrdersCommandDeliveryControllerWithDash_GetOrderDeliveryItems",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "The ID of the order to retrieve delivery items from.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "activeOnly",
            "in": "query",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DeliveryItemDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/gameservers/{gameServerId}/delivery/items": {
      "get": {
        "tags": [
          "delivery"
        ],
        "summary": "Returns delivery items in which an associated command attempt is for the gameserver",
        "description": "Retrieves all delivery items that have a command attempt targeting the game server.",
        "operationId": "GameServersDelivery_GetGameServerDeliveryItems",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the game server belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "gameServerId",
            "in": "path",
            "description": "The ID of the game server.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "activeOnly",
            "in": "query",
            "description": "Whether to only retrieve delivery items that are currently active.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DeliveryItemDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_game_server_delivery_items",
          "description": "Lists delivery items whose commands target one game server, with cursor paging. Set active only to hide expired and revoked items.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/gameservers/{gameServerId}/delivery/commands/resend": {
      "post": {
        "tags": [
          "delivery"
        ],
        "summary": "Resend commands for a given Gameserver",
        "description": "Re-enqueues delivery commands for a game server, narrowed by the filters in the request body.",
        "operationId": "GameServersDelivery_ResendDeliveryCommandsForGameServer",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the game server belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "gameServerId",
            "in": "path",
            "description": "The ID of the game server.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "Filters to select which commands to resend.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ResendCommandsForGameServerRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ResendCommandsForGameServerRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ResendCommandsForGameServerRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResendCommandsForGameServerResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_resend_game_server_delivery_commands",
          "description": "Re-runs delivery commands on a game server for players who did not receive their items. Always pass at least one filter. An empty body resends every command on the server. Each call runs the commands in game again, so confirm with the user first.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/delivery/items": {
      "get": {
        "tags": [
          "delivery"
        ],
        "summary": "Get all delivery items",
        "description": "Retrieves all delivery items associated with this store (paginated)",
        "operationId": "Delivery_GetStoreDeliveryItems",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve delivery items for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "activeOnly",
            "in": "query",
            "description": "Whether to only retrieve delivery items that are currently active.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DeliveryItemDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_delivery_items",
          "description": "Lists every delivery item in the store with cursor paging. Set active only to hide expired and revoked items. To narrow by customer or game server, use the customer or game server delivery item tools.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "delivery"
        ],
        "summary": "Assign delivery items in bulk",
        "description": "Allows you to assign multiple delivery items for multiple customers in bulk",
        "operationId": "Delivery_AssignDeliveryItemsBulk",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to assign the delivery items in.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The delivery item assignments to create.",
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/DeliveryItemAssignmentBulkDto"
                }
              }
            },
            "text/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/DeliveryItemAssignmentBulkDto"
                }
              }
            },
            "application/*+json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/DeliveryItemAssignmentBulkDto"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DeliveryItemDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_assign_delivery_items_bulk",
          "description": "Grants products to many customers at once and queues their delivery commands. Takes a product version ID, not a product ID. Has real in-game effects for every customer listed and cannot be revoked through MCP, so confirm with the user first.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/delivery/commands/unqueue": {
      "post": {
        "tags": [
          "delivery"
        ],
        "summary": "Unqueue commands by Attempt IDs",
        "operationId": "Delivery_UnqueueDeliveryCommandAttemptByAttemptIDs",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UnqueueCommandsRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UnqueueCommandsRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UnqueueCommandsRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UnqueueCommandsResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/command-delivery": {
      "post": {
        "tags": [
          "delivery"
        ],
        "description": "**Deprecated:** ",
        "operationId": "LegacyCommandDelivery_AssignDeliveryItemsBulk",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/DeliveryItemAssignmentBulkDto"
                }
              }
            },
            "text/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/DeliveryItemAssignmentBulkDto"
                }
              }
            },
            "application/*+json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/DeliveryItemAssignmentBulkDto"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DeliveryItemDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/command-delivery/unqueue": {
      "post": {
        "tags": [
          "delivery"
        ],
        "description": "**Deprecated:** ",
        "operationId": "LegacyCommandDelivery_UnqueueDeliveryCommandAttemptByAttemptIDs",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UnqueueCommandsRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UnqueueCommandsRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UnqueueCommandsRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UnqueueCommandsResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/customers/{customerId}/delivery/items": {
      "get": {
        "tags": [
          "delivery"
        ],
        "summary": "Get delivery items associated with a customer",
        "description": "Retrieves delivery items associated with a customer",
        "operationId": "CustomersDelivery_GetCustomerDeliveryItems",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve delivery items for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "description": "The ID of the customer.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "activeOnly",
            "in": "query",
            "description": "Whether to only retrieve delivery items that are currently active.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DeliveryItemDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_customer_delivery_items",
          "description": "Lists the delivery items (products granted or bought) for one customer, with cursor paging. Set active only to hide expired and revoked items.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "delivery"
        ],
        "summary": "Assign a delivery item to a customer",
        "description": "Allows you to assign a delivery item to a customer",
        "operationId": "CustomersDelivery_AssignDeliveryItem",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to assign the delivery item in.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "description": "The ID of the customer to assign the delivery item to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The delivery item assignment to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DeliveryItemAssignmentDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/DeliveryItemAssignmentDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/DeliveryItemAssignmentDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DeliveryItemDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_assign_customer_delivery_item",
          "description": "Grants a product to a customer for free and queues its delivery commands on a game server. Has real in-game effects and cannot be revoked through MCP, so confirm with the user first. Needs a game server ID from paynow_list_game_servers.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/customers/{customerId}/delivery/items/{deliveryItemId}": {
      "delete": {
        "tags": [
          "delivery"
        ],
        "summary": "Revoke a delivery item from a customer",
        "description": "Allows you to revoke a delivery item associated with a customer",
        "operationId": "CustomersDelivery_RevokeDeliveryItem",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "deliveryItemId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/customers/{customerId}/delivery/commands": {
      "get": {
        "tags": [
          "delivery"
        ],
        "summary": "Get command attempts associated with a customer",
        "description": "Retrieves command attempts associated with a customer",
        "operationId": "CustomersDelivery_GetCommandAttemptsForCustomer",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve command attempts for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "description": "The ID of the customer.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CommandAttemptDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_customer_delivery_commands",
          "description": "Lists the game server command attempts for one customer. An attempt with no 'executed_at' and no 'unqueued_at' is still pending. Use it to check whether a player actually received their items.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/customers/{customerId}/command-delivery": {
      "get": {
        "tags": [
          "delivery"
        ],
        "description": "**Deprecated:** ",
        "operationId": "LegacyCustomersDeliveryControllerWithDash_GetDeliveryItems",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DeliveryItemDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      },
      "post": {
        "tags": [
          "delivery"
        ],
        "description": "**Deprecated:** ",
        "operationId": "LegacyCustomersDeliveryControllerWithDash_AssignDeliveryItem",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DeliveryItemAssignmentDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/DeliveryItemAssignmentDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/DeliveryItemAssignmentDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DeliveryItemDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/customers/{customerId}/command-delivery/{deliveryItemId}": {
      "delete": {
        "tags": [
          "delivery"
        ],
        "description": "**Deprecated:** ",
        "operationId": "LegacyCustomersDeliveryControllerWithDash_RevokeDeliveryItem",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "deliveryItemId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/product_versions/{productVersionId}/discord_actions": {
      "get": {
        "tags": [
          "discord"
        ],
        "summary": "Get product version Discord actions",
        "description": "Retrieves all Discord actions configured for a product version in the specified store.",
        "operationId": "ProductsDiscord_GetActions",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the product version belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "productVersionId",
            "in": "path",
            "description": "The ID of the product version.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DiscordActionDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_product_version_discord_actions",
          "description": "Lists the Discord actions for a product version. Takes the product's 'version_id', not its 'id'.",
          "readOnly": true
        }
      },
      "put": {
        "tags": [
          "discord"
        ],
        "summary": "Set product version Discord actions",
        "description": "Replaces the Discord actions configured for a product version in the specified store.",
        "operationId": "ProductsDiscord_CreateAction",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the product version belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "productVersionId",
            "in": "path",
            "description": "The ID of the product version.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The Discord actions to set.",
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/SetDiscordActionDto"
                }
              }
            },
            "text/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/SetDiscordActionDto"
                }
              }
            },
            "application/*+json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/SetDiscordActionDto"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DiscordActionDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_product_version_discord_action",
          "description": "Replaces the full set of Discord actions for a product version; anything not in the array is removed. List the existing actions first and include the ones to keep. Takes the product's 'version_id', not its 'id'.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/orders/{orderId}/discord": {
      "get": {
        "tags": [
          "discord"
        ],
        "summary": "Get linked Discord accounts",
        "description": "Retrieves the Discord accounts linked to an order for the specified store.",
        "operationId": "OrdersDiscord_GetLinkedDiscordAccounts",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the linked Discord accounts for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "The ID of the order.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "$ref": "#/components/schemas/DiscordProfileDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_order_discord_accounts",
          "description": "Returns the Discord accounts linked to an order's lines, keyed by order line ID. Lines without a link are omitted.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/orders/{orderId}/discord/queued": {
      "get": {
        "tags": [
          "discord"
        ],
        "summary": "Get Discord action execution history",
        "description": "Retrieves the history of Discord actions executed for an order in the specified store.",
        "operationId": "OrdersDiscord_GetDiscordActionExecutionHistory",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the Discord action history for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "The ID of the order.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/QueuedDiscordActionDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_order_discord_action_history",
          "description": "Lists every Discord action queued or executed for an order. Use it to check whether roles, messages or bans were applied after purchase.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/inventory/{inventoryItemId}/discord/queued": {
      "get": {
        "tags": [
          "discord"
        ],
        "summary": "Get queued Discord actions for delivery item",
        "description": "Retrieves all queued Discord actions for a delivery item in the specified store.",
        "operationId": "DiscordInventoryItem_GetQueuedDiscordActionForDeliveryItem",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the delivery item belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "inventoryItemId",
            "in": "path",
            "description": "The ID of the delivery item.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/QueuedDiscordActionDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_delivery_item_queued_discord_actions",
          "description": "Lists the Discord actions queued or executed for one delivery item, with status and execution results. Use it to diagnose why a customer did not receive a Discord role.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/inventory/{inventoryItemId}/discord/link": {
      "get": {
        "tags": [
          "discord"
        ],
        "summary": "Get Discord user linked to delivery item",
        "description": "Retrieves the Discord profile linked to a delivery item in the specified store.",
        "operationId": "DiscordInventoryItem_GetUserToDeliveryItemLinks",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the delivery item belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "inventoryItemId",
            "in": "path",
            "description": "The ID of the delivery item.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DiscordProfileDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_delivery_item_discord_links",
          "description": "Returns the Discord account linked to a delivery item. Save the 'discord_id' before removing a link.",
          "readOnly": true
        }
      },
      "put": {
        "tags": [
          "discord"
        ],
        "summary": "Link Discord user to delivery item",
        "description": "Links a Discord user to a delivery item in the specified store.",
        "operationId": "DiscordInventoryItem_SetUserToDeliveryItemLink",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the delivery item belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "inventoryItemId",
            "in": "path",
            "description": "The ID of the delivery item.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "discordUserId",
            "in": "query",
            "description": "The ID of the Discord user to link.",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_delivery_item_discord_link",
          "description": "Links a delivery item to a Discord account by raw Discord user ID, replacing any existing link. Returns nothing.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "discord"
        ],
        "summary": "Unlink Discord user from delivery item",
        "description": "Removes the Discord user link from a delivery item in the specified store.",
        "operationId": "DiscordInventoryItem_DeleteUserToDeliveryItemLink",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the delivery item belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "inventoryItemId",
            "in": "path",
            "description": "The ID of the delivery item.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_delivery_item_discord_link",
          "description": "Removes the Discord account link from a delivery item. Read the current link first so it can be restored.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/discord/links": {
      "post": {
        "tags": [
          "discord"
        ],
        "summary": "Create Discord server link",
        "description": "Creates a new link token that can be used to connect a Discord server to the specified store.",
        "operationId": "DiscordServers_CreateDiscordServerLink",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the Discord server link for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DiscordServerLinkDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_discord_server_link",
          "description": "Creates a pending link token the store owner redeems in Discord to connect a server. Nothing is connected until it is redeemed. Each call creates another pending token.",
          "readOnly": false
        }
      },
      "get": {
        "tags": [
          "discord"
        ],
        "summary": "Get Discord server links",
        "description": "Retrieves all Discord server links for the specified store.",
        "operationId": "DiscordServers_GetDiscordServerLinks",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve Discord server links for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DiscordServerLinkDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_discord_server_links",
          "description": "Lists Discord server links, pending and connected. Use it for the 'server_id' the roles and channels tools need, or the 'token' to delete a link.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/discord/links/{token}": {
      "delete": {
        "tags": [
          "discord"
        ],
        "summary": "Delete Discord server link",
        "description": "Deletes a Discord server link by the token for the specified store.",
        "operationId": "DiscordServers_DeleteDiscordServerLinks",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to delete the Discord server link for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "token",
            "in": "path",
            "description": "The token of the Discord server link.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_discord_server_link",
          "description": "Deletes a Discord server link by its token, disconnecting the server. Discord actions for that server stop working. Cannot be undone.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/discord/{discordServerId}/roles": {
      "get": {
        "tags": [
          "discord"
        ],
        "summary": "Get Discord server roles",
        "description": "Retrieves all roles for a Discord server linked to the specified store.",
        "operationId": "DiscordServers_GetDiscordServerRoles",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the Discord server is linked to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "discordServerId",
            "in": "path",
            "description": "The ID of the Discord server.",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DiscordServerRoleDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_discord_server_roles",
          "description": "Lists a linked Discord server's roles, for configuring persist_role actions on products.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/discord/{discordServerId}/discord/text_channels": {
      "get": {
        "tags": [
          "discord"
        ],
        "summary": "Get Discord server text channels",
        "description": "Retrieves all text channels for a Discord server linked to the specified store.",
        "operationId": "DiscordServers_GetDiscordServerTextChannels",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the Discord server is linked to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "discordServerId",
            "in": "path",
            "description": "The ID of the Discord server.",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DiscordServerChannelDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_discord_server_text_channels",
          "description": "Lists a linked Discord server's text channels, for configuring send_message actions on products.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/products/{productId}/downloadable-files": {
      "get": {
        "tags": [
          "downloadable-files"
        ],
        "summary": "Get downloadable files",
        "description": "Retrieves all downloadable files for a product in the specified store.",
        "operationId": "ProductsDownloadableFile_GetDownloadableFiles",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the product belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "productId",
            "in": "path",
            "description": "The ID of the product.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProductDownloadableFileDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      },
      "post": {
        "tags": [
          "downloadable-files"
        ],
        "operationId": "ProductsDownloadableFile_StartDownloadableFileUpload",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "productId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/StartDownloadableFileUploadRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/StartDownloadableFileUploadRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/StartDownloadableFileUploadRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StartDownloadableFileUploadResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/products/{productId}/downloadable-files/{downloadableFileId}/finish": {
      "post": {
        "tags": [
          "downloadable-files"
        ],
        "operationId": "ProductsDownloadableFile_FinishDownloadableFileUpload",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "productId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "downloadableFileId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/products/{productId}/downloadable-files/{downloadableFileId}/download-url": {
      "get": {
        "tags": [
          "downloadable-files"
        ],
        "operationId": "ProductsDownloadableFile_CreateDownloadUrl",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "productId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "downloadableFileId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateDownloadableFileDownloadUrlResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/products/{productId}/downloadable-files/{downloadableFileId}": {
      "delete": {
        "tags": [
          "downloadable-files"
        ],
        "operationId": "ProductsDownloadableFile_DeleteDownloadableFile",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "productId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "downloadableFileId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/gameservers/{gameServerId}/console": {
      "get": {
        "tags": [
          "game-servers"
        ],
        "summary": "Get the associated console for a game server.",
        "description": "Retrieves the console associated with a game server in the specified store.",
        "operationId": "GameServersConsole_GetGameServerConsole",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the game server belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "gameServerId",
            "in": "path",
            "description": "The ID of the game server.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GameServerConsoleDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_game_server_console",
          "description": "Returns a game server's live console (RCON) settings and connection status. The response includes the console 'password'. Do not repeat it unless asked.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "game-servers"
        ],
        "summary": "Create a console for a game server.",
        "description": "Creates a new console for a game server in the specified store.",
        "operationId": "GameServersConsole_CreateGameServerConsole",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the game server belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "gameServerId",
            "in": "path",
            "description": "The ID of the game server.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The console to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGameServerConsoleDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGameServerConsoleDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGameServerConsoleDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GameServerConsoleDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_game_server_console",
          "description": "Connects PayNow to a game server's console (RCON). PayNow starts connecting immediately. One console per game server; only Rust is supported today.",
          "readOnly": false
        }
      },
      "patch": {
        "tags": [
          "game-servers"
        ],
        "summary": "Update a console for a game server.",
        "description": "Performs a delta update of the console for a game server in the specified store.",
        "operationId": "GameServersConsole_UpdateGameServerConsole",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the game server belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "gameServerId",
            "in": "path",
            "description": "The ID of the game server.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The console fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGameServerConsoleDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGameServerConsoleDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGameServerConsoleDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GameServerConsoleDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_game_server_console",
          "description": "Partial update. Send only the fields to change. type cannot be changed after creation. Changing the address or password reconnects.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "game-servers"
        ],
        "summary": "Delete an associated game server console.",
        "description": "Deletes the console associated with a game server in the specified store.",
        "operationId": "GameServersConsole_DeleteGameServerConsole",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the game server belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "gameServerId",
            "in": "path",
            "description": "The ID of the game server.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_game_server_console",
          "description": "Disconnects and deletes a game server's console settings. The host, port and password are lost, so read them first if they may be needed again. Cannot be undone.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/gameservers/{gameServerId}/console/messages": {
      "get": {
        "tags": [
          "game-servers"
        ],
        "summary": "Get console messages for a game server.",
        "description": "Retrieves recent console messages for a game server in the specified store.",
        "operationId": "GameServersConsole_GetGameServerConsoleMessages",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the game server belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "gameServerId",
            "in": "path",
            "description": "The ID of the game server.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/GameServerConsoleMessageDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_game_server_console_messages",
          "description": "Returns recent console output for a game server. Not paginated. Use it to verify that delivery commands ran in game.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/gameservers": {
      "get": {
        "tags": [
          "game-servers"
        ],
        "summary": "Get Game Servers for a store",
        "description": "Retrieves all game servers for the specified store.",
        "operationId": "GameServers_GetGameServers",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve game servers for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/GameServerDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_game_servers",
          "description": "Lists every game server. Not paginated. Use it to find the game server ID for delivery assignments. Responses include each server's secret 'token' if the user has the correct permissions. Do not repeat it unless asked.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "game-servers"
        ],
        "summary": "Create a new Game Server for a store",
        "description": "Creates a new game server in the specified store.",
        "operationId": "GameServers_CreateGameServer",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the game server in.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The game server to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGameServerDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGameServerDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGameServerDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GameServerDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_game_server",
          "description": "Registers a game server and returns the token the operator installs in the plugin.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/gameservers/{gameServerId}": {
      "get": {
        "tags": [
          "game-servers"
        ],
        "summary": "Get a Game Server by ID for a store",
        "description": "Retrieves a game server by the ID for the specified store.",
        "operationId": "GameServers_GetGameServer",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the game server for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "gameServerId",
            "in": "path",
            "description": "The ID of the game server.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GameServerDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_game_server",
          "description": "Returns one game server by ID. 'linked_to.last_fetched_commands_at' shows whether it is actually connected. The response includes the secret 'token' if the user has the correct permissions. Do not repeat it unless asked.",
          "readOnly": true
        }
      },
      "patch": {
        "tags": [
          "game-servers"
        ],
        "summary": "Update a Game Server By ID for a store",
        "description": "Performs a delta update of a game server by the ID for the specified store.",
        "operationId": "GameServers_UpdateGameServer",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update the game server for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "gameServerId",
            "in": "path",
            "description": "The ID of the game server.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The game server fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGameServerDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGameServerDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGameServerDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GameServerDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_game_server",
          "description": "Partial update. Send only the fields to change. Disabling a server stops command delivery to it. Servers cannot be deleted or have their token reset through MCP.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "game-servers"
        ],
        "summary": "Delete a Game Server by ID for a store",
        "operationId": "GameServers_DeleteGameServer",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "gameServerId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/gameservers/{gameServerId}/reset-token": {
      "post": {
        "tags": [
          "game-servers"
        ],
        "summary": "Reset the API Key Token for a Game Server for a store",
        "operationId": "GameServers_ResetGameServerToken",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "gameServerId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GameServerDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/giftcards": {
      "get": {
        "tags": [
          "giftcards"
        ],
        "summary": "Get Gift Cards for a store",
        "description": "Retrieves all gift cards for the specified store.",
        "operationId": "GiftCards_GetGiftCards",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve gift cards for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "code",
            "in": "query",
            "description": "A gift card code to filter by.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "include_canceled",
            "in": "query",
            "description": "Should canceled gift cards be included in the response?",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/GiftCardDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_gift_cards",
          "description": "Lists gift cards, newest first, with cursor paging. Canceled cards are hidden unless 'include_canceled' is true. Use the 'code' filter to find a card by code.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "giftcards"
        ],
        "summary": "Create a Gift Card for a store",
        "description": "Creates a new gift card in the specified store.",
        "operationId": "GiftCards_CreateGiftCard",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the gift card in.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The gift card to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGiftCardDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGiftCardDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateGiftCardDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GiftCardDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_gift_card",
          "description": "Creates a gift card. Reminder: 'balance' is in the smallest currency unit.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/giftcards/{giftCardId}": {
      "get": {
        "tags": [
          "giftcards"
        ],
        "summary": "Get a Gift Card By ID for a store",
        "description": "Retrieves a gift card by the ID for the specified store.",
        "operationId": "GiftCards_GetGiftCard",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the gift card for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "giftCardId",
            "in": "path",
            "description": "The ID of the gift card.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GiftCardDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_gift_card",
          "description": "Returns one gift card by ID. To find a card by its code, use paynow_list_gift_cards. If you do not have the ID, you can use paynow_search_dashboard to search.",
          "readOnly": true
        }
      },
      "delete": {
        "tags": [
          "giftcards"
        ],
        "summary": "Delete a Gift Card By ID for a store",
        "description": "Deletes a gift card by the ID for the specified store.",
        "operationId": "GiftCards_DeleteGiftCard",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to delete the gift card for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "giftCardId",
            "in": "path",
            "description": "The ID of the gift card.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GiftCardDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_gift_card",
          "description": "Cancels a gift card so it can no longer be redeemed. Cannot be undone.",
          "readOnly": false
        }
      },
      "patch": {
        "tags": [
          "giftcards"
        ],
        "summary": "Update a Gift Card By ID for a store",
        "description": "Performs a delta update of a gift card by the ID for the specified store.",
        "operationId": "GiftCards_UpdateGiftCard",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update the gift card for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "giftCardId",
            "in": "path",
            "description": "The ID of the gift card.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The gift card fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGiftCardDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGiftCardDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateGiftCardDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GiftCardDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_gift_card",
          "description": "Partial update. Send only the fields to change. Changing 'balance' changes real redeemable value, so confirm with the user first.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/global-commands": {
      "get": {
        "tags": [
          "global-commands"
        ],
        "summary": "Get global commands",
        "description": "Retrieves all global commands for the specified store.",
        "operationId": "GlobalCommands_GetGlobalCommands",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve this data for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/GlobalCommandDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_global_commands",
          "description": "Lists global commands: game server commands that run for every product at a lifecycle stage. Per-product commands live on the product instead.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "global-commands"
        ],
        "summary": "Create global command",
        "description": "Creates a global command for a store.",
        "operationId": "GlobalCommands_CreateGlobalCommand",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create this data for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The global command to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertGlobalCommandDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertGlobalCommandDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertGlobalCommandDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GlobalCommandDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_global_command",
          "description": "Creates a global command that runs on game servers for every product at the given stage. It starts running on real customer events immediately.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/global-commands/{globalCommandId}": {
      "patch": {
        "tags": [
          "global-commands"
        ],
        "summary": "Update global command",
        "description": "Updates a global command for a store.",
        "operationId": "GlobalCommands_UpdateGlobalCommand",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update this data for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "globalCommandId",
            "in": "path",
            "description": "The ID of the global command.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The global command fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertGlobalCommandDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertGlobalCommandDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertGlobalCommandDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GlobalCommandDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_global_command",
          "description": "Partial update. Send only the fields to change.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "global-commands"
        ],
        "summary": "Delete global command",
        "description": "Deletes a global command for a store.",
        "operationId": "GlobalCommands_DeleteGlobalCommand",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to delete this data for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "globalCommandId",
            "in": "path",
            "description": "The ID of the command to delete.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_global_command",
          "description": "Permanently deletes a global command.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/invites": {
      "get": {
        "tags": [
          "invites"
        ],
        "summary": "Get invites",
        "description": "Retrieves all store member invites for the specified store.",
        "operationId": "Invites_GetInvites",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/InviteDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      },
      "post": {
        "tags": [
          "invites"
        ],
        "summary": "Create an invite",
        "description": "Invites a user to join the store with the specified role.",
        "operationId": "Invites_CreateInvite",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateInviteDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateInviteDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateInviteDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InviteDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/invites/{inviteId}": {
      "get": {
        "tags": [
          "invites"
        ],
        "summary": "Get an invite",
        "description": "Retrieves a single store member invite.",
        "operationId": "Invites_GetInvite",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "inviteId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InviteDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "invites"
        ],
        "summary": "Cancel an invite",
        "description": "Cancels a pending store member invite.",
        "operationId": "Invites_CancelInvite",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "inviteId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/invoices": {
      "get": {
        "tags": [
          "invoices"
        ],
        "summary": "Get invoices",
        "description": "Retrieves all invoices for the specified store.",
        "operationId": "StoreInvoices_ListInvoices",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve invoices for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "type",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/InvoiceTypeDto"
            }
          },
          {
            "name": "customer_id",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "order_id",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "reference",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "billing_email",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/InvoiceDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/invoices/{invoiceId}/download": {
      "get": {
        "tags": [
          "invoices"
        ],
        "summary": "Download invoice",
        "description": "Retrieves a temporary download URL for the invoice PDF.",
        "operationId": "StoreInvoices_DownloadInvoice",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the invoice belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "invoiceId",
            "in": "path",
            "description": "The ID of the invoice to download.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DownloadUrlResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/marketing/email/templates": {
      "get": {
        "tags": [
          "marketing"
        ],
        "summary": "Get email templates",
        "description": "Retrieves all email templates for the specified store.",
        "operationId": "Email_GetEmailTemplates",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve email templates for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EmailTemplateDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_email_templates",
          "description": "Lists the store's custom email templates with cursor paging. Any type without an active custom template sends PayNow's default, which paynow_list_email_template_definitions returns.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "marketing"
        ],
        "summary": "Create email template",
        "description": "Creates a new email template in the specified store.",
        "operationId": "Email_CreateEmailTemplate",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the email template in.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The email template to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEmailTemplateDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEmailTemplateDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateEmailTemplateDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EmailTemplateDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_email_template",
          "description": "Creates a custom email template for one 'email_template_type'. Start 'content' from that type's 'default_content' in paynow_list_email_template_definitions, which also lists the components and variables it can use. Make it the one customers receive with paynow_activate_email_template.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/marketing/email/templates/{templateId}": {
      "get": {
        "tags": [
          "marketing"
        ],
        "summary": "Get email template by ID",
        "description": "Retrieves an email template by the ID for the specified store.",
        "operationId": "Email_GetEmailTemplate",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the email template for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the email template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EmailTemplateDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_email_template",
          "description": "Returns one custom email template by ID, content included. Read it before updating.",
          "readOnly": true
        }
      },
      "patch": {
        "tags": [
          "marketing"
        ],
        "summary": "Update email template by ID",
        "description": "Performs a delta update of an email template by the ID for the specified store.",
        "operationId": "Email_UpdateEmailTemplate",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update the email template for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the email template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The email template fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEmailTemplateDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEmailTemplateDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEmailTemplateDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EmailTemplateDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_email_template",
          "description": "Partial update of a template's 'name' or 'content'. Send only the fields to change. 'email_template_type' cannot be changed after creation.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "marketing"
        ],
        "summary": "Delete email template by ID",
        "description": "Deletes an email template by the ID for the specified store.",
        "operationId": "Email_DeleteEmailTemplate",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to delete the email template for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the email template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_email_template",
          "description": "Permanently deletes a custom email template. Cannot be undone. To revert to PayNow's default but keep the template, use paynow_deactivate_email_template instead.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/marketing/email/templates/{templateId}/activate": {
      "post": {
        "tags": [
          "marketing"
        ],
        "summary": "Activate email template by ID",
        "description": "Activates an email template by the ID for the specified store, so it is sent in place of the\ndefault template for its type.",
        "operationId": "Email_ActivateEmailTemplate",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to activate the email template for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the email template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_activate_email_template",
          "description": "Makes the template the one customers receive for its type, in place of PayNow's default. This changes real customer emails, so confirm with the user first. Returns nothing.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/marketing/email/templates/{templateId}/deactivate": {
      "post": {
        "tags": [
          "marketing"
        ],
        "summary": "Deactivate email template by ID",
        "description": "Deactivates an email template by the ID for the specified store, so the default template for\nits type is sent instead.",
        "operationId": "Email_DeactivateEmailTemplate",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to deactivate the email template for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the email template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_deactivate_email_template",
          "description": "Deactivates a template so PayNow's default for its type is sent instead. The template is kept. Returns nothing.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/marketing/email/templates/deactivate": {
      "post": {
        "tags": [
          "marketing"
        ],
        "summary": "Deactivate email template by type",
        "description": "Deactivates the active email template of the supplied type for the specified store.",
        "operationId": "Email_DeactivateEmailTemplateByType",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to deactivate the email template for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The email template type to deactivate.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DeactivateEmailTemplateRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/DeactivateEmailTemplateRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/DeactivateEmailTemplateRequestDto"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_deactivate_email_template_by_type",
          "description": "Deactivates whichever template is active for an 'email_template_type', so PayNow's default is sent instead. Use it when you know the type but not the template ID. Returns nothing.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/marketing/email/template-definitions": {
      "get": {
        "tags": [
          "marketing"
        ],
        "summary": "Get email template definitions",
        "description": "Retrieves the email template definitions available to the specified store.",
        "operationId": "Email_GetEmailTemplateDefinitions",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve email template definitions for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EmailTemplateDefinitionDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_email_template_definitions",
          "description": "Lists every email type the store can customise, with its display name, the components and example variables its content can use, and PayNow's 'default_content'. Read it before creating or editing a template.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/marketing/email/branding": {
      "get": {
        "tags": [
          "marketing"
        ],
        "summary": "Get email branding",
        "description": "Retrieves the email branding for the specified store.",
        "operationId": "Email_GetEmailBranding",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve email branding for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EmailBrandingDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_email_branding",
          "description": "Returns the email branding: the accent 'color' and the light and dark header image URLs used across the store's emails.",
          "readOnly": true
        }
      },
      "patch": {
        "tags": [
          "marketing"
        ],
        "summary": "Update email branding",
        "description": "Performs a delta update of the email branding for the specified store.",
        "operationId": "Email_UpdateEmailBranding",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update email branding for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The email branding fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEmailBrandingDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEmailBrandingDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateEmailBrandingDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EmailBrandingDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_email_branding",
          "description": "Partial update of the email branding. Send only the fields to change. Applies to every email the store sends.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/marketing/email/deliveries": {
      "get": {
        "tags": [
          "marketing"
        ],
        "summary": "Get email deliveries",
        "description": "Retrieves all email deliveries for the specified store.",
        "operationId": "Email_GetEmailDeliveries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve email deliveries for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "store_id",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "email_delivery_id",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "receiver_email",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "subject",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "email_template_type",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/EmailTemplateTypeDto"
            }
          },
          {
            "name": "status",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/EmailDeliveryStatusDto"
              }
            }
          },
          {
            "name": "message_id",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/EmailDeliveryDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_email_deliveries",
          "description": "Lists emails the store has sent, with cursor paging. Filter by 'receiver_email', 'email_template_type' or 'status' to check whether a customer received an email.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/marketing/email/deliveries/{emailDeliveryId}": {
      "get": {
        "tags": [
          "marketing"
        ],
        "summary": "Get email delivery by ID",
        "description": "Retrieves an email delivery by the ID for the specified store.",
        "operationId": "Email_GetEmailDelivery",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the email delivery for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "emailDeliveryId",
            "in": "path",
            "description": "The ID of the email delivery.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EmailDeliveryDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_email_delivery",
          "description": "Returns one email delivery by ID. Find IDs with paynow_list_email_deliveries.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/marketing/abandoned-checkouts/configuration": {
      "get": {
        "tags": [
          "marketing"
        ],
        "summary": "Gets the abandoned checkout behaviour for a store",
        "description": "Retrieves the abandoned checkout configuration for the specified store.",
        "operationId": "StoreAbandonedCheckouts_GetStoreAbandonedCheckoutConfigurationOptions",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the configuration for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AbandonedCheckoutStoreConfigurationDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_abandoned_checkout_settings",
          "description": "Returns the abandoned checkout recovery configuration. Always read this before updating, because updates replace the whole configuration.",
          "readOnly": true
        }
      },
      "put": {
        "tags": [
          "marketing"
        ],
        "summary": "Sets the abandoned checkout behaviour for a store",
        "description": "Updates the abandoned checkout configuration for the specified store.",
        "operationId": "StoreAbandonedCheckouts_SetStoreAbandonedCheckoutConfigurationOptions",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update the configuration for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The abandoned checkout configuration to apply.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AbandonedCheckoutStoreConfigurationUpdateDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/AbandonedCheckoutStoreConfigurationUpdateDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/AbandonedCheckoutStoreConfigurationUpdateDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AbandonedCheckoutStoreConfigurationDto"
                }
              }
            }
          },
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_abandoned_checkout_settings",
          "description": "Full replace, not a partial update. Omitted fields reset to defaults, so start from the current configuration. Reminder: durations are ISO 8601 (PT2H) and coupon percentages are tenths of a percent. Enabling this emails customers and issues real discount coupons.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/marketing/purchase-follow-ups/configuration": {
      "get": {
        "tags": [
          "marketing"
        ],
        "summary": "Gets the purchase follow up behaviour for a store",
        "description": "Retrieves the purchase follow up configuration for the specified store.",
        "operationId": "StorePurchaseFollowUps_GetStorePurchaseFollowUpConfigurationOptions",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the configuration for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PurchaseFollowUpStoreConfigurationDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_purchase_follow_up_settings",
          "description": "Returns the purchase follow-up configuration, the marketing email sent after a completed purchase. Always read this before updating, because updates replace the whole configuration.",
          "readOnly": true
        }
      },
      "put": {
        "tags": [
          "marketing"
        ],
        "summary": "Sets the purchase follow up behaviour for a store",
        "description": "Updates the purchase follow up configuration for the specified store.",
        "operationId": "StorePurchaseFollowUps_SetStorePurchaseFollowUpConfigurationOptions",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update the configuration for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The purchase follow up configuration to apply.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PurchaseFollowUpStoreConfigurationUpdateDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/PurchaseFollowUpStoreConfigurationUpdateDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/PurchaseFollowUpStoreConfigurationUpdateDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PurchaseFollowUpStoreConfigurationDto"
                }
              }
            }
          },
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_purchase_follow_up_settings",
          "description": "Full replace, not a partial update. Omitted fields reset to defaults, so start from the current configuration. Reminder: durations are ISO 8601 (P3D) and coupon percentages are tenths of a percent. Enabling this emails customers after purchase and issues real discount coupons.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/media": {
      "get": {
        "tags": [
          "media"
        ],
        "summary": "List media",
        "description": "Lists the store's uploaded images and videos, newest first.",
        "operationId": "Media_ListMediaAssets",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to list media for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "type",
            "in": "query",
            "description": "Only return media of this type.",
            "schema": {
              "$ref": "#/components/schemas/MediaAssetTypeDto"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/MediaAssetDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/media/{mediaAssetId}": {
      "get": {
        "tags": [
          "media"
        ],
        "summary": "Get media asset",
        "description": "Retrieves a single uploaded image or video.",
        "operationId": "Media_GetMediaAsset",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the media asset belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "mediaAssetId",
            "in": "path",
            "description": "The ID of the media asset.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MediaAssetDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "media"
        ],
        "summary": "Delete media asset",
        "description": "Removes the media asset from the store's media so it can no longer be attached. Products, tags and logos\nalready using it keep showing it.",
        "operationId": "Media_DeleteMediaAsset",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the media asset belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "mediaAssetId",
            "in": "path",
            "description": "The ID of the media asset.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/media/uploads": {
      "post": {
        "tags": [
          "media"
        ],
        "summary": "Start media upload",
        "description": "Starts uploading an image or video of at most 20 MB. Upload the file to the returned 'upload_url' with a PUT\nrequest whose Content-Type and Content-Length headers match the request, then call the finish route.",
        "operationId": "Media_CreateMediaUpload",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to upload media to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The type and size of the file to upload.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateMediaUploadRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateMediaUploadRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateMediaUploadRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateMediaUploadResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/media/{mediaAssetId}/finish": {
      "post": {
        "tags": [
          "media"
        ],
        "summary": "Finish media upload",
        "description": "Checks the uploaded file and makes the media asset ready to be used on products, tags and store logos.",
        "operationId": "Media_FinishMediaUpload",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the media asset belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "mediaAssetId",
            "in": "path",
            "description": "The ID of the media asset returned when the upload was started.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MediaAssetDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/navlinks": {
      "get": {
        "tags": [
          "navlinks"
        ],
        "summary": "Get all NavLinks for a store",
        "description": "Retrieves all navigation links for the specified store.",
        "operationId": "NavLinks_GetNavLinks",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve navigation links for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/NavLinkDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_navlinks",
          "description": "Lists the storefront navigation links. Each points at a tag and nests via 'parent_node_id'.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "navlinks"
        ],
        "summary": "Create a new NavLink for a store",
        "description": "Creates a new navigation link in the specified store.",
        "operationId": "NavLinks_CreateNavLink",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the navigation link in.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The navigation link to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateNavLinkDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateNavLinkDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateNavLinkDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NavLinkDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_navlink",
          "description": "Creates a storefront navigation link pointing at a tag. The name and slug come from the tag.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/navlinks/{navLinkId}": {
      "get": {
        "tags": [
          "navlinks"
        ],
        "summary": "Get a NavLink by ID for a store",
        "description": "Retrieves a navigation link by the ID for the specified store.",
        "operationId": "NavLinks_GetNavLink",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the navigation link for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "navLinkId",
            "in": "path",
            "description": "The ID of the navigation link.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NavLinkDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_navlink",
          "description": "Returns one navigation link by its 'node_id'.",
          "readOnly": true
        }
      },
      "delete": {
        "tags": [
          "navlinks"
        ],
        "summary": "Delete a NavLink for a store",
        "description": "Deletes a navigation link by the ID for the specified store.",
        "operationId": "NavLinks_DeleteNavLink",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to delete the navigation link for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "navLinkId",
            "in": "path",
            "description": "The ID of the navigation link.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_navlink",
          "description": "Permanently deletes a navigation link. The tag is unaffected.",
          "readOnly": false
        }
      },
      "patch": {
        "tags": [
          "navlinks"
        ],
        "summary": "Update a NavLink By ID for a store",
        "description": "Performs a delta update of a navigation link by the ID for the specified store.",
        "operationId": "NavLinks_UpdateNavLink",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update the navigation link for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "navLinkId",
            "in": "path",
            "description": "The ID of the navigation link.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The navigation link fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateNavLinkDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateNavLinkDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateNavLinkDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/NavLinkDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_navlink",
          "description": "Partial update. Send only the fields to change.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/navlinks/sort-orders": {
      "patch": {
        "tags": [
          "navlinks"
        ],
        "summary": "Update the sort orders of NavLinks for a Store",
        "description": "Updates the sort order of navigation links in the specified store.",
        "operationId": "NavLinks_UpdateNavLinkOrder",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update navigation link sort orders in.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The navigation links and their new sort orders.",
          "content": {
            "application/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/UpdateNavLinkOrderChangeDto"
                }
              }
            },
            "text/json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/UpdateNavLinkOrderChangeDto"
                }
              }
            },
            "application/*+json": {
              "schema": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/UpdateNavLinkOrderChangeDto"
                }
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_navlink_sort_orders",
          "description": "Reorders navigation links in one call. Returns nothing.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/orders": {
      "get": {
        "tags": [
          "orders"
        ],
        "summary": "Get orders",
        "description": "Retrieves all orders for the specified store.",
        "operationId": "Orders_GetOrders",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve orders for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "status",
            "in": "query",
            "description": "List of order statuses to filter by",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/OrderStatus"
              }
            }
          },
          {
            "name": "order_id",
            "in": "query",
            "description": "Order ID",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customer_id",
            "in": "query",
            "description": "Customer ID",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "billing_email",
            "in": "query",
            "description": "Billing Email",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "customer_ip",
            "in": "query",
            "description": "Customer IP",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "subscription_id",
            "in": "query",
            "description": "Subscription ID",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "checkout_id",
            "in": "query",
            "description": "Checkout ID",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "is_subscription",
            "in": "query",
            "description": "Flag indicating if the order is a subscription",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "affiliate_id",
            "in": "query",
            "description": "Affiliate ID",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "coupon_id",
            "in": "query",
            "description": "Coupon ID",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "giftcard_id",
            "in": "query",
            "description": "Gift card ID",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "product_id",
            "in": "query",
            "description": "Product ID",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "sale_id",
            "in": "query",
            "description": "Sale ID",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OrderDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_orders",
          "description": "Lists orders, newest first, with filters and cursor paging. Amounts are integers in the smallest currency unit.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/orders/{orderId}": {
      "get": {
        "tags": [
          "orders"
        ],
        "summary": "Get order by ID",
        "description": "Retrieves an order by the ID for the specified store.",
        "operationId": "Orders_GetOrderById",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the order for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "The ID of the order.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_order",
          "description": "Returns one order by ID with its lines and amounts. Orders are read-only through MCP; refunds cannot be issued here.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/orders/{orderId}/refunds": {
      "get": {
        "tags": [
          "orders"
        ],
        "summary": "Get refunds for order",
        "description": "Retrieves all refunds issued for an order by the ID for the specified store.",
        "operationId": "Orders_GetOrderRefunds",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the order belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "The ID of the order.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RefundDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/orders/{orderId}/refund": {
      "post": {
        "tags": [
          "orders"
        ],
        "summary": "Refund order by ID",
        "description": "Creates a refund for an order by the ID for the specified store.",
        "operationId": "Orders_RefundOrder",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to refund the order for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "orderId",
            "in": "path",
            "description": "The ID of the order.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateRefundRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateRefundRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateRefundRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RefundDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/payment-method-types": {
      "get": {
        "tags": [
          "payment-method-types"
        ],
        "summary": "Get store payment method types",
        "description": "Retrieves all payment method types associated with a store",
        "operationId": "StorePaymentMethodTypes_GetStorePaymentMethodTypes",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve payment method types for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PaymentMethodTypeDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_payment_method_types",
          "description": "Lists the payment method types available to the store and whether each is enabled. Read-only through MCP. Advise the user the methods are toggled inside the PayNow dashboard.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/payment-method-types/{paymentMethodTypeId}/toggle": {
      "patch": {
        "tags": [
          "payment-method-types"
        ],
        "summary": "Toggle a store payment method type",
        "description": "Enables or disabled a payment method type for a store",
        "operationId": "StorePaymentMethodTypes_ToggleStorePaymentMethodType",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "paymentMethodTypeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ToggleStorePaymentMethodTypeRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ToggleStorePaymentMethodTypeRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ToggleStorePaymentMethodTypeRequestDto"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/payment-method-types/{paymentMethodTypeId}/request-approval": {
      "post": {
        "tags": [
          "payment-method-types"
        ],
        "summary": "Request approval for a store payment method type",
        "description": "Requests approval to use a payment method type that requires manual review",
        "operationId": "StorePaymentMethodTypes_RequestStorePaymentMethodTypeApproval",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "paymentMethodTypeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/payment-settings": {
      "get": {
        "tags": [
          "payment-settings"
        ],
        "summary": "Get store payment settings",
        "description": "Retrieves payment settings for a store.",
        "operationId": "PaymentsSettings_GetStorePaymentSettings",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve payment settings for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StorePaymentSettingsDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_payment_settings",
          "description": "Returns the store's payment settings. Read-only through MCP. Settings are changed from the dashboard.",
          "readOnly": true
        }
      },
      "patch": {
        "tags": [
          "payment-settings"
        ],
        "summary": "Updates store payment settings",
        "description": "Updates payment settings for a store.",
        "operationId": "PaymentsSettings_UpdateStorePaymentSettings",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStorePaymentSettingsDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStorePaymentSettingsDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStorePaymentSettingsDto"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/payments": {
      "get": {
        "tags": [
          "payments"
        ],
        "summary": "Get payments",
        "description": "Retrieves all payments for the specified store using the filter specified.",
        "operationId": "Payments_GetPayments",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve payments for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "status",
            "in": "query",
            "description": "Filter by payment statuses",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/PaymentStatusDto"
              }
            }
          },
          {
            "name": "order_id",
            "in": "query",
            "description": "Filter by order ID",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customer_id",
            "in": "query",
            "description": "Filter by customer ID",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PaymentDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_payments",
          "description": "Lists payments, newest first, with filters and cursor paging.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/payments/{paymentId}": {
      "get": {
        "tags": [
          "payments"
        ],
        "summary": "Get payment by ID",
        "description": "Retrieves a payment by an ID.",
        "operationId": "Payments_GetPaymentById",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the payment for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "paymentId",
            "in": "path",
            "description": "The ID of the payment.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaymentDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_payment",
          "description": "Returns one payment by ID with amounts, fees, chargeback status and refunds. Amounts are in the smallest currency unit.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/products/{productId}/dependent-migrations": {
      "get": {
        "tags": [
          "product-dependent-migrations"
        ],
        "operationId": "ProductsDependentMigrations_GetProductDependentMigrations",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "productId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProductDependentMigrationDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      },
      "post": {
        "tags": [
          "product-dependent-migrations"
        ],
        "operationId": "ProductsDependentMigrations_CreateProductDependentMigration",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "productId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateProductDependentMigrationRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateProductDependentMigrationRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateProductDependentMigrationRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductDependentMigrationDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/products/{productId}/dependent-migrations/estimate": {
      "get": {
        "tags": [
          "product-dependent-migrations"
        ],
        "operationId": "ProductsDependentMigrations_GetProductDependentMigrationEstimate",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "productId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProductDependentMigrationEstimateVersionDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/product-dependent-migrations/{productDependentMigrationId}": {
      "get": {
        "tags": [
          "product-dependent-migrations"
        ],
        "operationId": "ProductsDependentMigrations_GetProductDependentMigrationById",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "productDependentMigrationId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductDependentMigrationDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/products": {
      "get": {
        "tags": [
          "products"
        ],
        "summary": "Get products",
        "description": "Retrieves all products for the specified store.\nDO NOT USE THIS ROUTE FOR DISPLAYING PRODUCTS ON YOUR STOREFRONT, use the storefront API instead!",
        "operationId": "Products_GetProducts",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve products for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "product_id",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/FlakeId"
              }
            }
          },
          {
            "name": "slug",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProductDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_products",
          "description": "Lists products. Not paginated. Filters are optional. Each product has an 'id' and a 'version_id', and Discord actions are keyed by 'version_id'.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "products"
        ],
        "summary": "Create product",
        "description": "Creates a new product in the specified store.\nCreating dynamic products while creating a checkout session via this endpoint without prior approval is prohibited and will result in store deactivation per our User Agreement.",
        "operationId": "Products_CreateProduct",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the product in.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The product to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertProductRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertProductRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertProductRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_product",
          "description": "Creates a product. Reminder: 'price' is in the smallest currency unit and percentage discounts are tenths of a percent. Creating products dynamically during checkout is prohibited without prior approval.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/products/{productId}": {
      "get": {
        "tags": [
          "products"
        ],
        "summary": "Get product",
        "description": "Retrieves a specific product by ID from the specified store.\nDO NOT USE THIS ROUTE FOR DISPLAYING PRODUCTS ON YOUR STOREFRONT, use the storefront API instead.",
        "operationId": "Products_GetProduct",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the product belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "productId",
            "in": "path",
            "description": "The ID of the product to retrieve.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_product",
          "description": "Returns one product by ID, including its current 'version_id'.",
          "readOnly": true
        }
      },
      "patch": {
        "tags": [
          "products"
        ],
        "summary": "Update product",
        "description": "Updates an existing product in the specified store.",
        "operationId": "Products_UpdateProduct",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the product belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "productId",
            "in": "path",
            "description": "The ID of the product to update.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The product fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertProductRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertProductRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertProductRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_product",
          "description": "Partial update that creates a new product version. Send only the fields to change, but list fields (tags, commands, gameservers, payout splits) are replaced wholesale. Price changes take effect immediately. Products cannot be deleted through MCP; set 'is_hidden' instead.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "products"
        ],
        "summary": "Delete product",
        "description": "Deletes a product from the specified store.",
        "operationId": "Products_DeleteProduct",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the product belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "productId",
            "in": "path",
            "description": "The ID of the product to delete.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/products/sort-order": {
      "post": {
        "tags": [
          "products"
        ],
        "summary": "Update product sort order",
        "description": "Updates the sort order of products in the specified store.",
        "operationId": "Products_UpdateProductSortOrder",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update product sort order in.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The products and their new sort orders.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProductSortOrderRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProductSortOrderRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProductSortOrderRequestDto"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_product_sort_order",
          "description": "Sets the storefront order of products. Send the complete ordered list of product IDs. Returns nothing.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/products/{productId}/image": {
      "delete": {
        "tags": [
          "products"
        ],
        "summary": "Delete product image",
        "description": "Deletes the image for a product.",
        "operationId": "Products_DeleteProductImage",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "productId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/products/{productId}/pricing/regions": {
      "get": {
        "tags": [
          "regional-pricing"
        ],
        "summary": "Get product pricing regions",
        "description": "Retrieves the regional pricing for a product in the specified store.",
        "operationId": "ProductsPricing_GetProductPricingRegions",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the product belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "productId",
            "in": "path",
            "description": "The ID of the product.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProductPricingRegionDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_product_pricing_regions",
          "description": "Lists regional pricing for a product, including any per-product overrides. Region IDs are strings; use them with paynow_update_product_pricing_region.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/products/{productId}/pricing/regions/{regionId}": {
      "patch": {
        "tags": [
          "regional-pricing"
        ],
        "summary": "Update product pricing region",
        "description": "Performs a delta update of the regional pricing override for a product in the specified store.",
        "operationId": "ProductsPricing_SetProductPricingRegionOverride",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the product belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "productId",
            "in": "path",
            "description": "The ID of the product.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "regionId",
            "in": "path",
            "description": "The ID of the pricing region.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "The pricing region override fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ProductPricingRegionOverrideDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ProductPricingRegionOverrideDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ProductPricingRegionOverrideDto"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_product_pricing_region",
          "description": "Partial update of a per-product regional price override. Changes what customers in those countries pay. Returns nothing; list again to confirm.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/products/pricing/regions": {
      "get": {
        "tags": [
          "regional-pricing"
        ],
        "summary": "Get store pricing regions",
        "description": "Retrieves the regional pricing configuration for the specified store.",
        "operationId": "ProductsPricing_GetStorePricingRegions",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve pricing regions for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProductPricingRegionDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_store_pricing_regions",
          "description": "Lists the store-wide pricing regions and their defaults. Per-product overrides are listed with paynow_list_product_pricing_regions.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/products/pricing/regions/{regionId}": {
      "patch": {
        "tags": [
          "regional-pricing"
        ],
        "summary": "Update store pricing region",
        "description": "Performs a delta update of the regional pricing override for the specified store.",
        "operationId": "ProductsPricing_SetStorePricingRegionOverride",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update the pricing region for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "regionId",
            "in": "path",
            "description": "The ID of the pricing region.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "description": "The pricing region override fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/StorePricingRegionOverrideDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/StorePricingRegionOverrideDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/StorePricingRegionOverrideDto"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_store_pricing_region",
          "description": "Partial update of a region's store-wide pricing defaults. Affects every product without a per-product override. Returns nothing; list again to confirm.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/products/pricing/region-groups": {
      "get": {
        "tags": [
          "regional-pricing"
        ],
        "summary": "Get pricing region groups",
        "description": "Retrieves the pricing region groups available to the specified store.",
        "operationId": "ProductsPricing_GetStorePricingRegionGroups",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve pricing region groups for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ProductPricingRegionGroupDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_pricing_region_groups",
          "description": "Lists the pricing region groups and their recommended base price multipliers, for interpreting a region's 'group_id'.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/roles": {
      "get": {
        "tags": [
          "roles"
        ],
        "operationId": "Roles_GetRoles",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/RoleDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      },
      "post": {
        "tags": [
          "roles"
        ],
        "operationId": "Roles_CreateRole",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateRoleDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateRoleDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateRoleDto"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RoleDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/roles/permissions": {
      "get": {
        "tags": [
          "roles"
        ],
        "operationId": "Roles_GetAvailablePermissions",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/AvailablePermissionDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/roles/{roleId}": {
      "get": {
        "tags": [
          "roles"
        ],
        "operationId": "Roles_GetRole",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "roleId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RoleDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      },
      "patch": {
        "tags": [
          "roles"
        ],
        "operationId": "Roles_UpdateRole",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "roleId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateRoleDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateRoleDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateRoleDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RoleDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      },
      "delete": {
        "tags": [
          "roles"
        ],
        "operationId": "Roles_DeleteRole",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "roleId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/sales": {
      "get": {
        "tags": [
          "sales"
        ],
        "summary": "Get sales associated with a store.",
        "description": "Retrieves all sales for the specified store.",
        "operationId": "Sales_GetSales",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve sales for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SaleDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_sales",
          "description": "Lists every sale (scheduled automatic discounts on products or tags). Not paginated.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "sales"
        ],
        "summary": "Create a sale by ID for a store",
        "description": "Creates a new sale in the specified store.",
        "operationId": "Sales_CreateSale",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the sale in.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The sale to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSaleDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSaleDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateSaleDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaleDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_sale",
          "description": "Creates a sale, an automatic discount applied at checkout. Reminder: percentage discounts are tenths of a percent (250 = 25%) and amounts are in the smallest currency unit. It takes effect as soon as it is enabled and inside its window.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/sales/{saleId}": {
      "get": {
        "tags": [
          "sales"
        ],
        "summary": "Get a sale by ID for a store",
        "description": "Retrieves a sale by the ID for the specified store.",
        "operationId": "Sales_GetSale",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the sale for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "saleId",
            "in": "path",
            "description": "The ID of the sale.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaleDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_sale",
          "description": "Returns one sale by ID.",
          "readOnly": true
        }
      },
      "delete": {
        "tags": [
          "sales"
        ],
        "summary": "Delete a sale by ID for a store",
        "description": "Deletes a sale by the ID for the specified store.",
        "operationId": "Sales_DeleteSaleById",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to delete the sale for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "saleId",
            "in": "path",
            "description": "The ID of the sale.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_sale",
          "description": "Permanently deletes a sale; past orders keep their reference. To pause a sale instead, set 'enabled' to false.",
          "readOnly": false
        }
      },
      "patch": {
        "tags": [
          "sales"
        ],
        "summary": "Update a sale by ID for a store",
        "description": "Performs a delta update of a sale by the ID for the specified store.",
        "operationId": "Sales_UpdateSale",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update the sale for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "saleId",
            "in": "path",
            "description": "The ID of the sale.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The sale fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSaleDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSaleDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSaleDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaleDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_sale",
          "description": "Partial update. Send only the fields to change. 'apply_to_product_ids' and 'apply_to_tag_ids' are replaced wholesale when present. Same units as create.",
          "readOnly": false
        }
      }
    },
    "/v1/search/docs": {
      "get": {
        "tags": [
          "search"
        ],
        "summary": "Search developer docs",
        "operationId": "Docs_SearchDocs",
        "parameters": [
          {
            "name": "query",
            "in": "query",
            "description": "The search terms. Keyword-style queries work best, for example 'create checkout session'.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of matching sections to return. Defaults to 5, capped at 20.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DocsSearchHitDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_search_docs",
          "description": "Searches the PayNow developer documentation at docs.paynow.gg: API reference endpoints and models, the TypeScript SDK, PayNow.js (the embedded checkout overlay), webhooks, hosted webstore templates, and the Self-Hosted Webstores guides for building a custom or headless store. Use it for anything involving code or HTTP: signing customers in (Steam, Minecraft, customer tokens), carts, checkout sessions, gifting, subscriptions, account pages, pricing and tax fields, which credential an endpoint needs, and API error messages. Call it before writing client code, not only when stuck. Keyword-style queries work best, such as 'steam login customer token', 'gift_to cart line' or 'paynow.js completed event'. Returns the best matching sections, each with a direct link and a snippet; open the link when you need the full request or response shape. Use paynow_search_guides for dashboard and store-owner questions instead.",
          "readOnly": true,
          "standalone": true
        }
      }
    },
    "/v1/search/guides": {
      "get": {
        "tags": [
          "search"
        ],
        "summary": "Search guides",
        "operationId": "Docs_SearchGuides",
        "parameters": [
          {
            "name": "query",
            "in": "query",
            "description": "The search terms. Keyword-style queries work best, for example 'connect game server'.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of matching sections to return. Defaults to 5, capped at 20.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DocsSearchHitDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_search_guides",
          "description": "Searches the PayNow store-owner guides at docs.paynow.gg: creating a store and products, orders, subscriptions and trials, customers and bans, game servers and delivery commands, delivery methods, Discord, coupons, sales, gift cards, affiliate links, upselling, abandoned checkouts, payouts, analytics, team roles and store settings, plus behaviour notes the API reference leaves implicit. Use it for how a feature works or how it is configured in the dashboard, even when the caller is a developer, such as 'what does a tier group do' or 'when are delivery items created'. Keyword-style queries work best, such as 'connect game server', 'discord roles' or 'gift card balance'. Returns the best matching sections, each with a direct link and a snippet. Use paynow_search_docs for endpoints, SDKs, PayNow.js and integration code instead.",
          "readOnly": true,
          "standalone": true
        }
      }
    },
    "/v1/stores/{storeId}/customers/{customerId}/stats": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "CustomerStats_GetCustomerStats",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomerStatsDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/dashboard": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetDashboardStats",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "dpt",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DashboardStatsDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/range-orders": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetOrderTimeSeries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "dpt",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DayOrderStatsDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/range-products": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetProductStatsForTimePeriod",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IntervalProductStatsDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/range-gameservers": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetGameServerStatsForTimePeriod",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IntervalGameServerStatsDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/range-tags": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetTagStatsForTimePeriod",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/IntervalTagStatsDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/countries/distribution": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetOrderCountryDistribution",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OrderCountryDistributionDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/payment_methods/distribution": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetPaymentMethodDistribution",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PaymentMethodDistributionDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/payment-acceptance": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetPaymentAcceptanceDistribution",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PaymentAcceptanceDistributionDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/times_of_day": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetPaymentPopularTimesOfDay",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PaymentPopularTimesOfDayDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/customers": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetSortedCustomersStats",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "sort_field",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "after",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "before",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort_dir",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CustomerStatsDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/customers/range": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetSortedCustomersStatsTimeRange",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "sort_field",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "after",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "before",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort_dir",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CustomerSpendTimeRangeDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/timeseries/gross_volume": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetPaymentGrossVolumeTimeSeries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TimeSeriesChartDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/timeseries/net_volume": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetPaymentNetVolumeTimeSeries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TimeSeriesChartDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/timeseries/product_order_volume": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetProductOrderVolumeTimeSeries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TimeSeriesChartDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/timeseries/gameserver_order_volume": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetGameServerOrderVolumeTimeSeries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TimeSeriesChartDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/timeseries/tag_order_volume": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetTagOrderVolumeTimeSeries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TimeSeriesChartDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/timeseries/marketing_volume/coupon": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetMarketingCouponVolumeTimeSeries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TimeSeriesChartDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/timeseries/marketing_volume/giftcard": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetMarketingGiftcardVolumeTimeSeries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TimeSeriesChartDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/timeseries/new_customer/coupon": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetNewCustomerByCouponTimeSeries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TimeSeriesChartDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/timeseries/new_customer/giftcard": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetNewCustomerByGiftcardTimeSeries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TimeSeriesChartDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/timeseries/affiliate_links/volume": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetAffiliateLinkOrderVolumeTimeSeries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TimeSeriesChartDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/timeseries/subscriptions": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetSubscriptionStatsTimeSeries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TimeSeriesChartDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/timeseries/trials": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetTrialsStatsTimeSeries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TimeSeriesChartDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/timeseries/subscriptions_product": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetSubscriptionProductStatsTimeSeries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TimeSeriesChartDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/timeseries/abandoned_checkouts": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetAbandonedCheckoutTimeSeries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TimeSeriesChartDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/timeseries/purchase_followups": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetPurchaseFollowUpTimeSeries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TimeSeriesChartDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/stats/detailed/timeseries/upsells": {
      "get": {
        "tags": [
          "stats"
        ],
        "description": "**Deprecated:** Use the v2 stats routes.",
        "operationId": "Stats_GetUpsellsTimeSeries",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TimeSeriesChartDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "deprecated": true,
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v2/stores/{storeId}/stats/timeseries": {
      "get": {
        "tags": [
          "stats"
        ],
        "summary": "Get time series chart",
        "description": "Retrieves a time series chart of a metric for the specified store.",
        "operationId": "StatsControllerV_GetTimeSeriesChart",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the chart for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "revenue_basis",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/RevenueBasisDto_V2"
            }
          },
          {
            "name": "metric_type",
            "in": "query",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/TimeSeriesChartMetricTypeDto_V2"
            }
          },
          {
            "name": "dimension_type",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/StatsDimensionTypeDto_V2"
            }
          },
          {
            "name": "dimension_id",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/TimeSeriesUnitDto_V2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TimeSeriesChartDto_V2"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_get_stats_time_series",
          "description": "Returns one metric over a date range as a chart series. Use 'dimension_type' to split into one series per product, tag, coupon, sale, country and so on, add 'dimension_id' to chart only one of them, and use the comparison range for a previous period. 'customer_lifecycle_volume' splits order volume into new, returning and renewal series. Money values are in the smallest unit of the returned 'currency'.",
          "readOnly": true
        }
      }
    },
    "/v2/stores/{storeId}/stats/distribution": {
      "get": {
        "tags": [
          "stats"
        ],
        "summary": "Get distribution",
        "description": "Retrieves the distribution of a metric across a dimension for the specified store.",
        "operationId": "StatsControllerV_GetDistribution",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the distribution for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "distribution_type",
            "in": "query",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/StatsDistributionTypeDto_V2"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_start",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "comparison_end",
            "in": "query",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "revenue_basis",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/RevenueBasisDto_V2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetDistributionResponseDto_V2"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_get_stats_distribution",
          "description": "Breaks the orders in a date range down by country, payment method, payment acceptance, customer lifecycle (new, returning and renewal) or customer platform (Minecraft java, bedrock and unknown). Customer lifecycle and customer platform also accept 'revenue_basis'. Each entry has a 'key', a 'count' (completed payments for payment method, orders for the rest) and 'earnings' in the smallest currency unit.",
          "readOnly": true
        }
      }
    },
    "/v2/stores/{storeId}/stats/matrix": {
      "get": {
        "tags": [
          "stats"
        ],
        "summary": "Get matrix",
        "description": "Retrieves a grid of stats for the specified store, with rows and columns decided by the matrix type.",
        "operationId": "StatsControllerV_GetMatrix",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the matrix for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "matrix_type",
            "in": "query",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/MatrixTypeDto_V2"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "unit",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/TimeSeriesUnitDto_V2"
            }
          },
          {
            "name": "revenue_basis",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/RevenueBasisDto_V2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetMatrixResponseDto_V2"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_get_stats_matrix",
          "description": "Returns a grid of stats over a date range for a 'matrix_type'. Each row has a 'header', a 'total' and 'cells' aligned with 'columns'. Every value has a 'count' and 'earnings' in the smallest currency unit.",
          "readOnly": true
        }
      }
    },
    "/v2/stores/{storeId}/stats/dimension": {
      "get": {
        "tags": [
          "stats"
        ],
        "summary": "Get dimension stats",
        "description": "Retrieves statistics broken down by a dimension for the specified store.",
        "operationId": "StatsControllerV_GetDimensionStats",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the statistics for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "dimension_type",
            "in": "query",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/StatsDimensionTypeDto_V2"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "revenue_basis",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/RevenueBasisDto_V2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetDimensionStatsResponseDto_V2"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_get_stats_dimension",
          "description": "Ranks the top products, game servers, tags, affiliate links, coupons, gift cards, payouts, sales, billing emails or countries by earnings over a date range. 'count' is units sold for products, game servers, tags and sales, and orders for the rest. Entries carry only IDs in 'dimension_id': a numeric ID for most dimensions, the email address for billing emails and the ISO 3166-1 alpha-2 code for countries, with ZZ for no country. Resolve names with the matching list tool.",
          "readOnly": true
        }
      }
    },
    "/v2/stores/{storeId}/stats/orders/summary": {
      "get": {
        "tags": [
          "stats"
        ],
        "summary": "Get orders summary",
        "description": "Retrieves a summary of orders for the specified store.",
        "operationId": "StatsControllerV_GetOrdersSummary",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the summary for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "revenue_basis",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/RevenueBasisDto_V2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrdersSummaryDto_V2"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_get_orders_summary",
          "description": "Returns order figures for fixed windows: today, yesterday, month to date, previous month and lifetime. For an arbitrary range use paynow_get_orders_summary_for_range.",
          "readOnly": true
        }
      }
    },
    "/v2/stores/{storeId}/stats/orders/summary/range": {
      "get": {
        "tags": [
          "stats"
        ],
        "summary": "Get orders summary for range",
        "description": "Retrieves a summary of orders over a date range for the specified store.",
        "operationId": "StatsControllerV_GetOrdersSummaryForRange",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the summary for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "revenue_basis",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/RevenueBasisDto_V2"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrdersSummaryForRangeDto_V2"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_get_orders_summary_for_range",
          "description": "Returns revenue, order count and average order value for one date range. For the standard dashboard windows use paynow_get_orders_summary.",
          "readOnly": true
        }
      }
    },
    "/v2/stores/{storeId}/stats/subscriptions/summary": {
      "get": {
        "tags": [
          "stats"
        ],
        "summary": "Get subscriptions summary",
        "description": "Retrieves a summary of subscriptions for the specified store.",
        "operationId": "StatsControllerV_GetSubscriptionsSummary",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the summary for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "revenue_basis",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/RevenueBasisDto_V2"
            }
          },
          {
            "name": "dimension_type",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/StatsDimensionTypeDto_V2"
            }
          },
          {
            "name": "dimension_id",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SubscriptionsSummaryDto_V2"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_get_subscriptions_summary",
          "description": "Returns the current subscription position: MRR, average subscription value and active count. Takes no dates. 'dimension_type' country with a 'dimension_id' country code narrows it to one country. For new and churned subscriptions over a period use paynow_get_subscriptions_summary_for_range.",
          "readOnly": true
        }
      }
    },
    "/v2/stores/{storeId}/stats/subscriptions/summary/range": {
      "get": {
        "tags": [
          "stats"
        ],
        "summary": "Get subscriptions summary for range",
        "description": "Retrieves a summary of subscriptions over a date range for the specified store.",
        "operationId": "StatsControllerV_GetSubscriptionsSummaryForRange",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the summary for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "revenue_basis",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/RevenueBasisDto_V2"
            }
          },
          {
            "name": "dimension_type",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/StatsDimensionTypeDto_V2"
            }
          },
          {
            "name": "dimension_id",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SubscriptionsSummaryForRangeDto_V2"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_get_subscriptions_summary_for_range",
          "description": "Returns new and churned subscriptions, churned revenue, and renewals due and paid for one date range. 'dimension_type' country with a 'dimension_id' country code narrows it to one country. For the current active count and MRR use paynow_get_subscriptions_summary.",
          "readOnly": true
        }
      }
    },
    "/v2/stores/{storeId}/stats/trials/summary": {
      "get": {
        "tags": [
          "stats"
        ],
        "summary": "Get trials summary",
        "description": "Retrieves a summary of trials for the specified store.",
        "operationId": "StatsControllerV_GetTrialsSummary",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the summary for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrialsSummaryDto_V2"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_get_trials_summary",
          "description": "Returns the number of currently active trials. Takes no arguments.",
          "readOnly": true
        }
      }
    },
    "/v2/stores/{storeId}/stats/trials/summary/range": {
      "get": {
        "tags": [
          "stats"
        ],
        "summary": "Get trials summary for range",
        "description": "Retrieves a summary of trials over a date range for the specified store.",
        "operationId": "StatsControllerV_GetTrialsSummaryForRange",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the summary for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrialsSummaryForRangeDto_V2"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_get_trials_summary_for_range",
          "description": "Returns trials started, canceled and converted within a date range.",
          "readOnly": true
        }
      }
    },
    "/v2/stores/{storeId}/stats/customers/summary/range": {
      "get": {
        "tags": [
          "stats"
        ],
        "summary": "Get customers summary for range",
        "description": "Retrieves new and returning customer counts over a date range for the specified store.",
        "operationId": "StatsControllerV_GetCustomersSummaryForRange",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the summary for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "dimension_type",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/StatsDimensionTypeDto_V2"
            }
          },
          {
            "name": "dimension_id",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomersSummaryForRangeDto_V2"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_get_customers_summary_for_range",
          "description": "Returns new customers, returning customers and returning customers excluding subscription renewals within a date range.",
          "readOnly": true
        }
      }
    },
    "/v2/stores/{storeId}/stats/popular-times-of-day": {
      "get": {
        "tags": [
          "stats"
        ],
        "summary": "Get popular times of day",
        "description": "Retrieves order volume broken down by time of day for the specified store.",
        "operationId": "StatsControllerV_GetPopularTimesOfDay",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the times of day for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PopularTimeOfDayDto_V2"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_get_popular_times_of_day",
          "description": "Returns payment counts by day of week and hour for a date range, in the supplied time zone.",
          "readOnly": true
        }
      }
    },
    "/v2/stores/{storeId}/stats/chargeback-rate": {
      "get": {
        "tags": [
          "stats"
        ],
        "summary": "Get chargeback rates",
        "description": "Retrieves the chargeback rate of each payment method type for the specified store.",
        "operationId": "StatsControllerV_GetPaymentMethodTypesChargebackRates",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the chargeback rates for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PaymentMethodChargebackRateDto_V2"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_get_chargeback_rates",
          "description": "Returns the chargeback rate per payment method type. Takes no arguments.",
          "readOnly": true
        }
      }
    },
    "/v2/stores/{storeId}/stats/customers": {
      "get": {
        "tags": [
          "stats"
        ],
        "summary": "Get customers stats",
        "description": "Retrieves statistics for the customers of the specified store.",
        "operationId": "StatsControllerV_GetCustomersStats",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the statistics for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "sort_field",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/CustomerSortFieldDto_V2"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CustomerStatsDto_V2"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_get_customers_stats",
          "description": "Lists lifetime spend statistics per customer with sorting and cursor paging. Page with 'after' set to the last 'customer_id'.",
          "readOnly": true
        }
      }
    },
    "/v2/stores/{storeId}/stats/customers/range": {
      "get": {
        "tags": [
          "stats"
        ],
        "summary": "Get customers stats for range",
        "description": "Retrieves statistics for the customers of the specified store over a date range.",
        "operationId": "StatsControllerV_GetCustomersStatsForRange",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the statistics for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "sort_field",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/CustomerSortFieldDto_V2"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "tz",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/CustomerStatsForRangeDto_V2"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_get_customers_stats_for_range",
          "description": "Lists per-customer spend statistics within a date range. For lifetime figures use paynow_get_customers_stats.",
          "readOnly": true
        }
      }
    },
    "/v2/stores/{storeId}/stats/customers/{customerId}": {
      "get": {
        "tags": [
          "stats"
        ],
        "summary": "Get customer stats by ID",
        "description": "Retrieves statistics for a customer by the ID in the specified store.",
        "operationId": "StatsControllerV_GetCustomerStats",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the statistics for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "description": "The ID of the customer.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomerStatsDto_V2"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true,
        "x-paynow-mcp": {
          "name": "paynow_get_customer_stats",
          "description": "Returns lifetime spend statistics for one customer.",
          "readOnly": true
        }
      }
    },
    "/v1/stores": {
      "post": {
        "tags": [
          "store"
        ],
        "summary": "Create a store",
        "description": "Creates a new store for the authenticated user.",
        "operationId": "Store_CreateStore",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStoreDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStoreDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateStoreDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StoreDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      },
      "get": {
        "tags": [
          "store"
        ],
        "summary": "Get stores",
        "description": "Retrieves all stores accessible to the authenticated user or API key.",
        "operationId": "Store_GetStores",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StoreDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_stores",
          "description": "Lists every store this connection has access to. Call it first: other tools take a 'storeId' and it must be one of the stores returned here.",
          "readOnly": true,
          "standalone": true
        }
      }
    },
    "/v1/stores/{storeId}": {
      "patch": {
        "tags": [
          "store"
        ],
        "summary": "Update a store",
        "description": "Partially updates a store's configuration using the provided fields.",
        "operationId": "Store_UpdateStore",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The store fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStoreDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStoreDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStoreDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StoreDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_store",
          "description": "Partial update. Send only the fields to change. 'currency' cannot be changed. Changing 'live_mode' switches between test and live payments, so confirm with the user first.",
          "readOnly": false
        }
      },
      "get": {
        "tags": [
          "store"
        ],
        "summary": "Get a store",
        "description": "Retrieves a single store by its ID.",
        "operationId": "Store_GetStore",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StoreDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_store",
          "description": "Returns a store. Call it first to learn the store's currency, name, and details and to confirm the user has successfully connected to the PayNow MCP server.",
          "readOnly": true
        }
      },
      "delete": {
        "tags": [
          "store"
        ],
        "summary": "Delete a store",
        "description": "Deletes a store by its ID",
        "operationId": "Store_DeleteStore",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/members": {
      "get": {
        "tags": [
          "store"
        ],
        "summary": "List store members",
        "description": "Retrieves all members who have access to the specified store.",
        "operationId": "Store_GetStoreMembers",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/StoreMemberDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/members/{memberId}/permissions": {
      "get": {
        "tags": [
          "store"
        ],
        "summary": "Get store member permissions",
        "description": "Retrieves the resolved permissions map for a specific member of a store.",
        "operationId": "Store_GetStoreMemberPermissions",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "memberId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "boolean"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/members/{memberId}": {
      "delete": {
        "tags": [
          "store"
        ],
        "summary": "Remove a store member",
        "description": "Removes the specified member from the store, revoking their access.",
        "operationId": "Store_KickStoreMember",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "memberId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      },
      "patch": {
        "tags": [
          "store"
        ],
        "summary": "Update a store member",
        "description": "Updates the role assigned to a specific member of the store.",
        "operationId": "Store_UpdateStoreMember",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "memberId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStoreMemberDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStoreMemberDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStoreMemberDto"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/logo": {
      "delete": {
        "tags": [
          "store"
        ],
        "summary": "Delete store logo",
        "description": "Deletes a logo for a store.",
        "operationId": "Store_DeleteStoreLogo",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "type",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/subscriptions": {
      "get": {
        "tags": [
          "subscriptions"
        ],
        "summary": "Get subscriptions",
        "description": "Retrieves all subscriptions for the specified store.",
        "operationId": "Subscriptions_GetSubscriptions",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve subscriptions for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customer_id",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "subscription_id",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "billing_email",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "payment_method_id",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "checkout_id",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "trial_id",
            "in": "query",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "status",
            "in": "query",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/SubscriptionStatusDto"
              }
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/SubscriptionDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_subscriptions",
          "description": "Lists subscriptions, newest first, with filters and cursor paging. Responses are large, so keep 'limit' small. Read products from 'lines'. The top-level product fields are deprecated.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/subscriptions/{subscriptionId}": {
      "get": {
        "tags": [
          "subscriptions"
        ],
        "summary": "Get subscription by ID",
        "description": "Retrieves a subscription for the specified store by the supplied ID.",
        "operationId": "Subscriptions_GetSubscriptionById",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the subscription for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "subscriptionId",
            "in": "path",
            "description": "The ID of the subscription.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SubscriptionDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_subscription",
          "description": "Returns one subscription by ID. Subscriptions are read-only through MCP. They cannot be changed or canceled here.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/subscriptions/{subscriptionId}/cancel": {
      "post": {
        "tags": [
          "subscriptions"
        ],
        "summary": "Cancel subscription by ID",
        "description": "Cancels a subscription for the specified store by the supplied ID.",
        "operationId": "Subscriptions_CancelSubscription",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to cancel the subscription for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "subscriptionId",
            "in": "path",
            "description": "The ID of the subscription.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "Cancellation details",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CancelSubscriptionRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CancelSubscriptionRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CancelSubscriptionRequestDto"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/subscriptions/{subscriptionId}/stop-pending-cancellation": {
      "post": {
        "tags": [
          "subscriptions"
        ],
        "summary": "Stop pending subscription cancellation",
        "description": "Stops a pending subscription cancellation for the specified store by the supplied ID.",
        "operationId": "Subscriptions_StopPendingSubscriptionCancellation",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to uncancel the subscription for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "subscriptionId",
            "in": "path",
            "description": "The ID of the subscription.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/subscriptions/{subscriptionId}/change": {
      "post": {
        "tags": [
          "subscriptions"
        ],
        "summary": "Update items on a subscription",
        "description": "Updates the subscription lines, including the pricing, on an active subscription. The subscription must not be within 1 hour of its\nnext renewal, and only one change can be pending at a time.\n            \n**Access**\n            \nThis endpoint requires the Subscription Updates API feature flag to be enabled on your store. Contact\nPayNow to request access.\n            \n**Proration behavior**\n            \nControlled by the `proration_behavior` field on the request:\n            \n- `immediate` - the change is applied as soon as possible.\n  Proration is calculated for the remaining period. If the prorated amount is ≥ $0.50 (or equivalent in other currencies), an order is\n  initiated against the subscription's payment method; the change is applied once the payment succeeds.\n  If the prorated amount is below $0.50, no order is created and the change is\n  applied instantly.\n  Only one proration order is allowed per billing cycle - a second immediate change in the same\n  period will be rejected if a proration was already charged.\n  When a payment is triggered, the response will include a `pending_payment` object. The payment result\n  is synchronous - check `pending_payment.declined` to determine whether the charge succeeded. If\n  declined, `pending_payment.decline_code` contains the reason.\n            \n- `next_billing_period` - no payment is created. The change is queued and will be applied automatically\n  at the start of the next renewal cycle. Ideal for downgrades.\n            \n- `none` - the change is applied instantly with no proration calculated or charged.\n            \n**Reverting a pending change**\n            \nIf a `next_billing_period` change is pending and the new request specifies the same product versions\nthat are already on the subscription (i.e. reverting back to the current state), the pending change\nis canceled rather than rejected. The canceled change record is returned in the response.",
        "operationId": "Subscriptions_UpdateSubscription",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "subscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSubscriptionRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSubscriptionRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSubscriptionRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UpdateSubscriptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/subscriptions/{subscriptionId}/change/preview": {
      "post": {
        "tags": [
          "subscriptions"
        ],
        "summary": "Preview a subscription change",
        "description": "Simulates a subscription change and returns the pricing breakdown without creating any records or\ninitiating a payment. Accepts the same request body as `POST change` — see that endpoint for\nfull parameter documentation. Does not return the `pending_payment` field.",
        "operationId": "Subscriptions_PreviewSubscriptionChange",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "subscriptionId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSubscriptionRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSubscriptionRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateSubscriptionRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UpdateSubscriptionResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/tags": {
      "get": {
        "tags": [
          "tags"
        ],
        "summary": "Get all tags for a store",
        "description": "Retrieves all tags for the specified store.",
        "operationId": "Tags_GetTags",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve tags for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TagDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_tags",
          "description": "Lists every tag (product category). Use it to find tag IDs for products, navigation links, sales and coupons.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "tags"
        ],
        "summary": "Create a new tag",
        "description": "Creates a new tag in the specified store.",
        "operationId": "Tags_CreateTag",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the tag in.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The tag to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertTagRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertTagRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertTagRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TagDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_tag",
          "description": "Creates a tag. 'name' and 'slug' must be unique in the store. Tag images can only be uploaded from the dashboard.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/tags/{tagId}": {
      "get": {
        "tags": [
          "tags"
        ],
        "summary": "Get a tag by an ID",
        "description": "Retrieves a tag by the ID for the specified store.",
        "operationId": "Tags_GetTag",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the tag for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "tagId",
            "in": "path",
            "description": "The ID of the tag.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TagDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_tag",
          "description": "Returns one tag by ID.",
          "readOnly": true
        }
      },
      "patch": {
        "tags": [
          "tags"
        ],
        "summary": "Update a tag by ID",
        "description": "Performs a delta update of a tag by the ID for the specified store.",
        "operationId": "Tags_UpdateTag",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update the tag for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "tagId",
            "in": "path",
            "description": "The ID of the tag.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The tag fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertTagRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertTagRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpsertTagRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TagDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_tag",
          "description": "Partial update - send only the fields to change.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "tags"
        ],
        "summary": "Delete a tag by ID",
        "description": "Deletes a tag by the ID for the specified store.",
        "operationId": "Tags_DeleteTag",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to delete the tag for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "tagId",
            "in": "path",
            "description": "The ID of the tag.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_tag",
          "description": "Permanently deletes a tag. To hide it instead, set 'enabled' to false.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/tags/{tagId}/image": {
      "delete": {
        "tags": [
          "tags"
        ],
        "summary": "Delete tag image",
        "description": "Deletes an image for a tag",
        "operationId": "Tags_DeleteTagImage",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the tag belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "tagId",
            "in": "path",
            "description": "The ID of the tag.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_tag_image",
          "description": "Removes a tag's image - the tag is kept. Images can only be re-uploaded from the dashboard.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/tier-groups": {
      "get": {
        "tags": [
          "tier-groups"
        ],
        "summary": "List all tier groups for a store",
        "description": "Retrieves all tier groups for the specified store.",
        "operationId": "TierGroups_ListTierGroups",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve tier groups for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TierGroupDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_tier_groups",
          "description": "Lists tier groups: named groups of subscription products customers can move between. Returns only IDs and names. Find members via each product's 'tier_group_id'.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "tier-groups"
        ],
        "summary": "Create a new tier group",
        "description": "Creates a new tier group in the specified store.",
        "operationId": "TierGroups_CreateTierGroup",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the tier group in.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The tier group to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateTierGroupRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateTierGroupRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateTierGroupRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TierGroupDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_tier_group",
          "description": "Creates a tier group. Add products afterwards by setting 'tier_group_id' with paynow_update_product.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/tier-groups/{tierGroupId}": {
      "get": {
        "tags": [
          "tier-groups"
        ],
        "summary": "Get a tier group by ID",
        "description": "Retrieves a tier group by the ID for the specified store.",
        "operationId": "TierGroups_GetTierGroup",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the tier group for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "tierGroupId",
            "in": "path",
            "description": "The ID of the tier group.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TierGroupDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_tier_group",
          "description": "Returns one tier group by ID.",
          "readOnly": true
        }
      },
      "patch": {
        "tags": [
          "tier-groups"
        ],
        "summary": "Update a tier group by ID",
        "description": "Performs a delta update of a tier group by the ID for the specified store.",
        "operationId": "TierGroups_UpdateTierGroup",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update the tier group for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "tierGroupId",
            "in": "path",
            "description": "The ID of the tier group.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The tier group fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTierGroupRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTierGroupRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateTierGroupRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TierGroupDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_tier_group",
          "description": "Renames a tier group. 'name' is required because the whole group is replaced.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "tier-groups"
        ],
        "summary": "Delete a tier group by ID",
        "description": "Deletes a tier group by the ID for the specified store.",
        "operationId": "TierGroups_DeleteTierGroup",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to delete the tier group for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "tierGroupId",
            "in": "path",
            "description": "The ID of the tier group.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_tier_group",
          "description": "Permanently deletes a tier group. Its products are not deleted.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/trials": {
      "get": {
        "tags": [
          "trials"
        ],
        "summary": "Get trials for a store",
        "description": "Retrieves all trials for the specified store.",
        "operationId": "Trials_GetTrials",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve trials for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "status",
            "in": "query",
            "description": "Filters trials by their status. Multiple statuses can be specified.",
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/TrialStatusDto"
              }
            }
          },
          {
            "name": "customer_id",
            "in": "query",
            "description": "Filters trials by the customer identifier.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "subscription_id",
            "in": "query",
            "description": "Filters trials by the associated subscription identifier.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "checkout_id",
            "in": "query",
            "description": "Filters trials by the checkout session identifier that initiated them.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "trial_id",
            "in": "query",
            "description": "Filters to a specific trial by its identifier.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TrialDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_trials",
          "description": "Lists product trials, newest first, with filters and cursor paging. Trials are read-only through MCP. Eligibility is managed with the customer trial eligibility override tools.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/trials/{trialId}": {
      "get": {
        "tags": [
          "trials"
        ],
        "summary": "Get a trial by ID for a store",
        "description": "Retrieves a trial by the ID for the specified store.",
        "operationId": "Trials_GetTrial",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the trial for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "trialId",
            "in": "path",
            "description": "The ID of the trial.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrialDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_trial",
          "description": "Returns one trial by ID.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/customers/{customerId}/trials/eligibility/overrides": {
      "get": {
        "tags": [
          "trials"
        ],
        "summary": "Get trial eligibility overrides for a specific customer",
        "description": "Retrieves all trial eligibility overrides for the specified customer.",
        "operationId": "CustomersTrialEligibility_GetEligibilityOverridesForCustomer",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve trial eligibility overrides for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "description": "The ID of the customer to retrieve trial eligibility overrides for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TrialEligibilityOverrideDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_customer_trial_eligibility_overrides",
          "description": "Lists the trial eligibility overrides granted to one customer.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "trials"
        ],
        "summary": "Create trial eligibility override for a customer",
        "description": "Creates a new trial eligibility override for the specified customer.",
        "operationId": "CustomersTrialEligibility_CreateEligibilityOverrideForCustomer",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the trial eligibility override for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "description": "The ID of the customer to create the trial eligibility override for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The trial eligibility override data.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateTrialEligibilityOverrideDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateTrialEligibilityOverrideDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateTrialEligibilityOverrideDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TrialEligibilityOverrideDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_customer_trial_eligibility_override",
          "description": "Lets a customer start a trial of a product they would otherwise be ineligible for. 'expires_at' is when the override stops being usable, not the trial length.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/customers/{customerId}/trials/eligibility/overrides/{trialEligibilityOverrideId}": {
      "delete": {
        "tags": [
          "trials"
        ],
        "summary": "Delete trial eligibility override for a customer",
        "description": "Deletes an existing trial eligibility override.",
        "operationId": "CustomersTrialEligibility_DeleteEligibilityOverrideForCustomer",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to delete the trial eligibility override for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "trialEligibilityOverrideId",
            "in": "path",
            "description": "The ID of the trial eligibility override to delete.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "customerId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_customer_trial_eligibility_override",
          "description": "Removes a trial eligibility override. Both the customer ID and the override ID are required. Cannot be undone.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/trust/requirements": {
      "get": {
        "tags": [
          "trust"
        ],
        "summary": "Get trust requirements",
        "description": "Retrieves all trust requirements for the specified store.",
        "operationId": "TrustStoreRequirement_GetStoreTrustRequirements",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve trust requirements for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "The maximum number of items to return in a single request.",
            "schema": {
              "maximum": 100,
              "minimum": 1,
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "after",
            "in": "query",
            "description": "Returns items after the specified ID.\nUsed for forward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "before",
            "in": "query",
            "description": "Returns items before the specified ID.\nUsed for backward pagination through results.",
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "example": "null"
          },
          {
            "name": "asc",
            "in": "query",
            "description": "Determines the sort order of returned items.\nWhen true, items are returned in ascending order.\nWhen false, items are returned in descending order.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/TrustStoreRequirementDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      }
    },
    "/v1/stores/{storeId}/upsell-settings": {
      "get": {
        "tags": [
          "upsell-settings"
        ],
        "summary": "Get store upselling settings",
        "description": "Retrieves upselling settings for the store.",
        "operationId": "UpsellSettings_GetStoreUpsellSettings",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve upselling settings for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StoreUpsellSettingsDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_upsell_settings",
          "description": "Returns the store's checkout upsell settings. Read this before updating.",
          "readOnly": true
        }
      },
      "patch": {
        "tags": [
          "upsell-settings"
        ],
        "summary": "Updates store upselling settings",
        "description": "Updates upselling settings for a store.",
        "operationId": "UpsellSettings_UpdateStoreUpsellSettings",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update upselling settings for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The upselling settings fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStoreUpsellSettingsDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStoreUpsellSettingsDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateStoreUpsellSettingsDto"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_upsell_settings",
          "description": "Partial update. Send only the fields to change, but 'recommendation_overrides' replaces the whole list. Reminder: percentage discounts are tenths of a percent. Returns nothing; re-read to confirm.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webhooks": {
      "get": {
        "tags": [
          "webhooks"
        ],
        "summary": "Get webhooks",
        "description": "Retrieves all webhook subscriptions for the specified store.",
        "operationId": "Webhooks_GetSubscriptions",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve webhooks for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/WebhookSubscriptionDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_webhooks",
          "description": "Lists webhook subscriptions, including each signing secret.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "webhooks"
        ],
        "summary": "Create webhook",
        "description": "Creates a new webhook subscription in the specified store.",
        "operationId": "Webhooks_CreateSubscription",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to create the webhook in.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The webhook to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebhookDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebhookDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebhookDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookSubscriptionDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_webhook",
          "description": "Creates a webhook subscription. Reminder: 'subscribed_to' is a comma-separated list of PascalCase event names (OnOrderCompleted, OnRefund) and 'type' is JsonV1 or DiscordV1. Returns the signing secret.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webhooks/variables": {
      "get": {
        "tags": [
          "webhooks"
        ],
        "summary": "Get webhook variables",
        "description": "Retrieves the variables available to webhook payload templates for the specified store.",
        "operationId": "Webhooks_GetVariables",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve webhook variables for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/WebhookVariablesDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_webhook_variables",
          "description": "Lists the template variables available per event type for Discord webhook titles and descriptions.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/webhooks/{webhookId}": {
      "patch": {
        "tags": [
          "webhooks"
        ],
        "summary": "Update webhook by ID",
        "description": "Performs a delta update of a webhook subscription by the ID for the specified store.",
        "operationId": "Webhooks_UpdateSubscription",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to update the webhook for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "webhookId",
            "in": "path",
            "description": "The ID of the webhook.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The webhook fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateWebhookDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateWebhookDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateWebhookDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookSubscriptionDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_webhook",
          "description": "Partial update. Send only the fields to change. 'subscribed_to' replaces the full event list. 'reset_secret' rotates the signing secret and breaks existing verification, so only use it when asked.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "webhooks"
        ],
        "summary": "Delete webhook by ID",
        "description": "Deletes a webhook subscription by the ID for the specified store.",
        "operationId": "Webhooks_DeleteSubscription",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to delete the webhook for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "webhookId",
            "in": "path",
            "description": "The ID of the webhook.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_webhook",
          "description": "Permanently deletes a webhook subscription. Deliveries stop immediately, so only use it when asked.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webhooks/resend": {
      "post": {
        "tags": [
          "webhooks"
        ],
        "summary": "Resend webhook events",
        "description": "Resends the supplied webhook events for the specified store.",
        "operationId": "Webhooks_Resend",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to resend the webhook events for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The webhook events to resend.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ResendWebhookDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/ResendWebhookDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/ResendWebhookDto"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_resend_webhook_events",
          "description": "Re-delivers one queued webhook event. Takes the 'id' of an entry from paynow_list_webhook_history, not the subscription ID.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webhooks/{webhookId}/history": {
      "get": {
        "tags": [
          "webhooks"
        ],
        "summary": "Get webhook history",
        "description": "Retrieves the delivery history of a webhook subscription by the ID for the specified store.",
        "operationId": "Webhooks_GetHistory",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the webhook history for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "webhookId",
            "in": "path",
            "description": "The ID of the webhook.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "The page of history to retrieve.",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "state",
            "in": "query",
            "description": "Filters the history to a specific delivery state.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookHistoryDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_webhook_history",
          "description": "Lists a webhook subscription's delivery history with payloads and attempts. 'page' starts at 1; 'state' is Success, Pending, Failed or All.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/webhooks/deliveries/{deliveryId}": {
      "get": {
        "tags": [
          "webhooks"
        ],
        "summary": "Get webhook delivery by ID",
        "description": "Retrieves a single webhook delivery, including its payload and attempts, by the ID for the specified store.",
        "operationId": "Webhooks_GetDelivery",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the webhook delivery for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "deliveryId",
            "in": "path",
            "description": "The ID of the webhook delivery.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/QueuedWebhookDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_webhook_delivery",
          "description": "Gets one webhook delivery with its payload and attempts. Takes the 'id' of an entry from paynow_list_webhook_history, not the subscription ID.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/webstore/marketplace/templates/{marketplaceTemplateId}/install": {
      "post": {
        "tags": [
          "webstore"
        ],
        "summary": "Install marketplace template",
        "description": "Installs a template from the marketplace into the store's webstore and returns the ID of the\ninstalled copy.",
        "operationId": "Webstore_InstallMarketplaceTemplate",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to install the template into.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "marketplaceTemplateId",
            "in": "path",
            "description": "The ID of the marketplace template to install.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InstallMarketplaceTemplateResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/webstore/modules": {
      "get": {
        "tags": [
          "webstore"
        ],
        "summary": "Get webstore modules",
        "description": "Retrieves all modules on the store's webstore, in sort order.",
        "operationId": "WebstoreModules_GetWebstoreModules",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store whose webstore modules to retrieve.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/WebstoreModuleDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_webstore_modules",
          "description": "Lists the webstore's modules with their type, settings, sort order, enabled state and optional schedule.",
          "readOnly": true
        }
      },
      "put": {
        "tags": [
          "webstore"
        ],
        "summary": "Create webstore module",
        "description": "Adds a module to the store's webstore. The module's 'type' decides which 'settings' it accepts.",
        "operationId": "WebstoreModules_CreateWebstoreModule",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store whose webstore the module is added to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The module to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreModuleDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreModuleDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreModuleDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebstoreModuleDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_webstore_module",
          "description": "Adds a module to the webstore. 'type' picks the module, 'settings' is its type-specific JSON config, and 'starts_at' and 'ends_at' optionally schedule it.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webstore/modules/{moduleId}": {
      "put": {
        "tags": [
          "webstore"
        ],
        "summary": "Update webstore module",
        "description": "Performs a delta update of a module on the store's webstore.",
        "operationId": "WebstoreModules_UpdateWebstoreModule",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "moduleId",
            "in": "path",
            "description": "The ID of the module.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The module fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreModuleDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreModuleDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreModuleDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebstoreModuleDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_webstore_module",
          "description": "Partial update. Send only the fields to change.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "webstore"
        ],
        "summary": "Delete webstore module",
        "description": "Permanently removes a module from the store's webstore.",
        "operationId": "WebstoreModules_DeleteWebstoreModule",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "moduleId",
            "in": "path",
            "description": "The ID of the module.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_webstore_module",
          "description": "Permanently deletes a module from the webstore.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webstore": {
      "get": {
        "tags": [
          "webstore"
        ],
        "summary": "Get webstore",
        "description": "Retrieves the store's webstore, covering the slug it is served from, its custom domain\nstate and the template it currently renders.",
        "operationId": "WebstoreSettings_GetWebstore",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the webstore for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebstoreDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_webstore",
          "description": "Returns the store's hosted webstore: its slug, whether it is active, the custom domain and its verification state, and the 'current_template_id' customers are served.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/webstore/set-default-template": {
      "post": {
        "tags": [
          "webstore"
        ],
        "summary": "Set default template",
        "description": "Sets the template the webstore renders for customers.",
        "operationId": "WebstoreSettings_SetWebstoreDefaultTemplate",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store whose webstore is being changed.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The template to serve the webstore from.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetWebstoreDefaultTemplateRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/SetWebstoreDefaultTemplateRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/SetWebstoreDefaultTemplateRequestDto"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_set_webstore_default_template",
          "description": "Switches the template the live webstore renders for customers. Takes effect immediately, so confirm with the user first.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webstore/set-slug": {
      "post": {
        "tags": [
          "webstore"
        ],
        "summary": "Set webstore slug",
        "description": "Changes the slug the webstore is reachable at. Slugs are unique across all webstores, so a\nslug already taken by another store is rejected.",
        "operationId": "WebstoreSettings_SetWebstoreSlug",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store whose webstore is being changed.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The new slug to serve the webstore from.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetWebstoreSlugRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/SetWebstoreSlugRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/SetWebstoreSlugRequestDto"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_set_webstore_slug",
          "description": "Changes the slug the webstore is reachable at. Slugs are unique across all webstores and the old URL stops working, so confirm with the user first.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webstore/set-active": {
      "post": {
        "tags": [
          "webstore"
        ],
        "summary": "Set webstore active",
        "description": "Enables or disables the store's hosted webstore. While disabled, customers visiting the\nwebstore's slug or custom domain see a not-active page. Template previews keep working.",
        "operationId": "WebstoreSettings_SetWebstoreActive",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store whose webstore is being changed.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "Whether the webstore should be served to customers.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetWebstoreActiveRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/SetWebstoreActiveRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/SetWebstoreActiveRequestDto"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_set_webstore_active",
          "description": "Enables or disables the hosted webstore. Disabling takes the live webstore offline for customers immediately, so confirm with the user first.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webstore/custom-domain": {
      "get": {
        "tags": [
          "webstore"
        ],
        "summary": "Get custom domain",
        "description": "Retrieves the custom domain attached to the store's webstore, along with the records still\noutstanding for ownership and SSL verification.",
        "operationId": "WebstoreSettings_GetWebstoreCustomDomain",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to retrieve the custom domain for.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebstoreCustomDomainDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_webstore_custom_domain",
          "description": "Returns the webstore's custom domain and the DNS records still needed to verify it.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "webstore"
        ],
        "summary": "Set custom domain",
        "description": "Attaches a custom domain to the store's webstore and begins verification.",
        "operationId": "WebstoreSettings_SetWebstoreCustomDomain",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store whose webstore is being changed.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The domain to attach and how ownership of it should be proven.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SetWebstoreCustomDomainRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/SetWebstoreCustomDomainRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/SetWebstoreCustomDomainRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebstoreCustomDomainDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_set_webstore_custom_domain",
          "description": "Attaches a custom domain and starts verification. Returns the DNS records the user must create; call paynow_verify_webstore_custom_domain once they exist.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "webstore"
        ],
        "summary": "Delete custom domain",
        "description": "Detaches the custom domain from the store's webstore. The webstore stays reachable at its\nslug.",
        "operationId": "WebstoreSettings_DeleteWebstoreCustomDomain",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store to remove the custom domain from.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_webstore_custom_domain",
          "description": "Detaches the custom domain. The webstore stays reachable at its slug.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webstore/custom-domain/verify": {
      "post": {
        "tags": [
          "webstore"
        ],
        "summary": "Verify custom domain",
        "description": "Re-checks the verification records for the webstore's custom domain. Call this once the\nrecords returned when the domain was set have been published.",
        "operationId": "WebstoreSettings_VerifyWebstoreCustomDomain",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store whose custom domain should be re-checked.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_verify_webstore_custom_domain",
          "description": "Re-checks the custom domain's DNS records. Call it after the user has created them.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webstore/templates/{templateId}/files": {
      "get": {
        "tags": [
          "webstore"
        ],
        "summary": "Get template files",
        "description": "Retrieves the files of a template without their content. Fetch a single file to read its\ncontent.",
        "operationId": "WebstoreTemplateFiles_GetWebstoreTemplateFiles",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/WebstoreTemplateFileDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_webstore_template_files",
          "description": "Lists a template's files with names and content types. Use paynow_get_webstore_template_file to read a file's content.",
          "readOnly": true
        }
      },
      "put": {
        "tags": [
          "webstore"
        ],
        "summary": "Create template file",
        "description": "Adds a file to a template. Its 'file_name' and 'content_type' decide where the file is served\nfrom and whether it is public.",
        "operationId": "WebstoreTemplateFiles_CreateWebstoreTemplateFile",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template to add the file to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The file to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreTemplateFileDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreTemplateFileDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreTemplateFileDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebstoreTemplateFileDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_webstore_template_file",
          "description": "Creates a file in a template. 'file_name' is its path within the template and 'content' is the full text.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webstore/templates/{templateId}/files/{templateFileId}": {
      "get": {
        "tags": [
          "webstore"
        ],
        "summary": "Get template file",
        "description": "Retrieves a single template file, content included.",
        "operationId": "WebstoreTemplateFiles_GetWebstoreTemplateFile",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateFileId",
            "in": "path",
            "description": "The ID of the template file.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebstoreTemplateFileDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_webstore_template_file",
          "description": "Returns one template file including its 'content'.",
          "readOnly": true
        }
      },
      "put": {
        "tags": [
          "webstore"
        ],
        "summary": "Update template file content",
        "description": "Replaces the content of a template file. If the template is the webstore's current template,\ncustomers see the change immediately.",
        "operationId": "WebstoreTemplateFiles_UpdateWebstoreTemplateFile",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateFileId",
            "in": "path",
            "description": "The ID of the template file.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The new content of the file.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateWebstoreTemplateFileRequestDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateWebstoreTemplateFileRequestDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateWebstoreTemplateFileRequestDto"
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_webstore_template_file",
          "description": "Partial update. Send only the fields to change; 'content' replaces the whole file. If the template is live, customers see the change, so confirm with the user first.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "webstore"
        ],
        "summary": "Delete template file",
        "description": "Permanently deletes a template file. Files whose 'is_deletable' is false cannot be removed.",
        "operationId": "WebstoreTemplateFiles_DeleteWebstoreTemplateFile",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateFileId",
            "in": "path",
            "description": "The ID of the template file.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_webstore_template_file",
          "description": "Permanently deletes a template file. Files with 'is_deletable' false cannot be removed.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webstore/templates": {
      "get": {
        "tags": [
          "webstore"
        ],
        "summary": "Get templates",
        "description": "Retrieves the templates of the store's webstore, without their files. The one customers see\nis the webstore's 'current_template_id'.",
        "operationId": "WebstoreTemplates_GetWebstoreTemplates",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store whose webstore templates to retrieve.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/WebstoreTemplateDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_webstore_templates",
          "description": "Lists the webstore's templates. The one customers see is the webstore's 'current_template_id'.",
          "readOnly": true
        }
      },
      "put": {
        "tags": [
          "webstore"
        ],
        "summary": "Create template",
        "description": "Creates an empty template on the store's webstore. Add files to it, then set it as the\nwebstore's default template to serve it to customers.",
        "operationId": "WebstoreTemplates_CreateWebstoreTemplate",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store whose webstore the template is added to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The template to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreTemplateDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreTemplateDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreTemplateDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebstoreTemplateDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_webstore_template",
          "description": "Creates an empty template. Add files with paynow_create_webstore_template_file, then make it live with paynow_set_webstore_default_template.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webstore/templates/{templateId}": {
      "get": {
        "tags": [
          "webstore"
        ],
        "summary": "Get template",
        "description": "Retrieves a template. Pass 'include' as 'files' to embed its files, content included, in\n'template_files'.",
        "operationId": "WebstoreTemplates_GetWebstoreTemplate",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "include",
            "in": "query",
            "description": "Set to 'files' to include the template's files in the response.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebstoreTemplateDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_webstore_template",
          "description": "Returns one template. Pass 'include' as 'files' to embed its files, content included.",
          "readOnly": true
        }
      },
      "put": {
        "tags": [
          "webstore"
        ],
        "summary": "Update template",
        "description": "Performs a delta update of a template's name and compatibility mode.",
        "operationId": "WebstoreTemplates_UpdateWebstoreTemplate",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The template fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreTemplateDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreTemplateDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreTemplateDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebstoreTemplateDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_webstore_template",
          "description": "Partial update of a template's name, visibility or compatibility mode. Send only the fields to change.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "webstore"
        ],
        "summary": "Delete template",
        "description": "Permanently deletes a template and all of its files. Switch the webstore to another template\nfirst if this one is its current template.",
        "operationId": "WebstoreTemplates_DeleteWebstoreTemplate",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_webstore_template",
          "description": "Permanently deletes a template and all of its files. If it is the webstore's current template, switch to another one first.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webstore/templates/{templateId}/update": {
      "get": {
        "tags": [
          "webstore"
        ],
        "summary": "Get latest template version",
        "description": "Retrieves the newest published version available for a template installed from the\nmarketplace. 'version' is null when there is no update or the template is not\nmarketplace-based.",
        "operationId": "WebstoreTemplates_GetWebstoreTemplateLatestVersion",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebstoreTemplateLatestVersionDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_webstore_template_latest_version",
          "description": "Returns the newest published version available for a template installed from the marketplace. 'version' is null when there is no update or the template is not marketplace-based.",
          "readOnly": true
        }
      },
      "post": {
        "tags": [
          "webstore"
        ],
        "summary": "Update template to latest version",
        "description": "Downloads the newest published version of a marketplace template over the installed copy,\nreplacing its files.",
        "operationId": "WebstoreTemplates_DownloadWebstoreTemplateUpdate",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template to update.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_webstore_template_to_latest_version",
          "description": "Downloads the latest published version of a marketplace template over the installed copy. Returns nothing. Confirm with the user first.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webstore/templates/{templateId}/schema": {
      "get": {
        "tags": [
          "webstore"
        ],
        "summary": "Get template schema",
        "description": "Retrieves the schema a template declares: its author, support contacts, update source and\nthe settings a store can configure.",
        "operationId": "WebstoreTemplates_GetWebstoreTemplateSchema",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebstoreTemplateSchemaDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_webstore_template_schema",
          "description": "Returns the template's schema: author, support contacts, update source and the config sections that define its editable settings.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/webstore/templates/{templateId}/schema/variables": {
      "put": {
        "tags": [
          "webstore"
        ],
        "summary": "Update template schema variables",
        "description": "Sets values for the settings the template's schema defines.",
        "operationId": "WebstoreTemplates_UpdateWebstoreTemplateSchemaVariables",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The values to set, keyed by the schema option's 'id'.",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": { }
              }
            },
            "text/json": {
              "schema": {
                "type": "object",
                "additionalProperties": { }
              }
            },
            "application/*+json": {
              "schema": {
                "type": "object",
                "additionalProperties": { }
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_webstore_template_schema_variables",
          "description": "Sets values for the settings the template's schema defines, as a map of variable name to value. Returns nothing.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webstore/templates/{templateId}/duplicate": {
      "post": {
        "tags": [
          "webstore"
        ],
        "summary": "Duplicate template",
        "description": "Copies a template and its files into a new template on the same webstore and returns it.",
        "operationId": "WebstoreTemplates_DuplicateWebstoreTemplate",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template to copy.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebstoreTemplateDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_duplicate_webstore_template",
          "description": "Copies a template and its files into a new template and returns it. Use it to experiment without touching the live template.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webstore/templates/{templateId}/archive": {
      "get": {
        "tags": [
          "webstore"
        ],
        "summary": "Get template archive",
        "description": "Creates a temporary URL to download the template's files as an archive.",
        "operationId": "WebstoreTemplates_GetWebstoreTemplateArchive",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetWebstoreTemplateArchiveResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_webstore_template_archive",
          "description": "Returns a temporary URL to download the template's files as an archive.",
          "readOnly": true
        }
      }
    },
    "/v1/stores/{storeId}/webstore/templates/{templateId}/upload_url": {
      "get": {
        "tags": [
          "webstore"
        ],
        "summary": "Get template upload URL",
        "description": "Creates a pre-signed URL for uploading an archive of template files. Upload the archive to\nit, then finish the upload to import the files into the template.",
        "operationId": "WebstoreTemplates_GetWebstoreTemplateUploadUrl",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template the files are imported into.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "content_length",
            "in": "query",
            "description": "The size of the archive to be uploaded, in bytes.",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetWebstoreTemplateUploadUrlResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/webstore/templates/{templateId}/upload_finish": {
      "post": {
        "tags": [
          "webstore"
        ],
        "summary": "Finish template upload",
        "description": "Imports the files from an archive uploaded to the URL returned by the upload URL endpoint\ninto the template, and reports any files that could not be imported.",
        "operationId": "WebstoreTemplates_FinishWebstoreTemplateUpload",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template the files are imported into.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FinishWebstoreTemplateUploadResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ]
      }
    },
    "/v1/stores/{storeId}/webstore/templates/{templateId}/preview": {
      "get": {
        "tags": [
          "webstore"
        ],
        "operationId": "WebstoreTemplates_GetWebstoreTemplatePreview",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebstoreTemplatePreviewResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-docs-ignore": true,
        "x-gitbook-ignore": true
      },
      "post": {
        "tags": [
          "webstore"
        ],
        "summary": "Create template preview URL",
        "description": "Creates a short-lived link that renders the template without caching. The link expires\nafter 15 minutes.",
        "operationId": "WebstoreTemplates_GetWebstoreTemplatePreviewUrl",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template to preview.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetWebstoreTemplatePreviewUrlResponseDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_get_webstore_template_preview_url",
          "description": "Creates a short-lived preview link for the template. The returned URL renders the uncached template and expires after 30 minutes. Use this if you are making changes to a template and want to view changes.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webstore/templates/{templateId}/variables": {
      "get": {
        "tags": [
          "webstore"
        ],
        "summary": "Get template variables",
        "description": "Retrieves the variables of a template with their current values.",
        "operationId": "WebstoreTemplateVariables_GetWebstoreTemplateVariables",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/WebstoreTemplateVariableDto"
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_list_webstore_template_variables",
          "description": "Lists a template's variables: the placeholders its files reference and their current values.",
          "readOnly": true
        }
      },
      "put": {
        "tags": [
          "webstore"
        ],
        "summary": "Create template variable",
        "description": "Adds a variable to a template. Its 'variable' is the name the template's files reference it\nby, and 'type' decides how 'value' is parsed when the template renders.",
        "operationId": "WebstoreTemplateVariables_CreateWebstoreTemplateVariable",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template to add the variable to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The variable to create.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreTemplateVariableDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreTemplateVariableDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreTemplateVariableDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebstoreTemplateVariableDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_create_webstore_template_variable",
          "description": "Creates a template variable. 'variable' is the placeholder name used in files, 'type' its kind and 'value' its current value.",
          "readOnly": false
        }
      }
    },
    "/v1/stores/{storeId}/webstore/templates/{templateId}/variables/{templateVariableId}": {
      "put": {
        "tags": [
          "webstore"
        ],
        "summary": "Update template variable",
        "description": "Performs a delta update of a template variable.",
        "operationId": "WebstoreTemplateVariables_UpdateWebstoreTemplateVariable",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateVariableId",
            "in": "path",
            "description": "The ID of the template variable.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "requestBody": {
          "description": "The variable fields to update.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreTemplateVariableDto"
              }
            },
            "text/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreTemplateVariableDto"
              }
            },
            "application/*+json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWebstoreTemplateVariableDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebstoreTemplateVariableDto"
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_update_webstore_template_variable",
          "description": "Partial update. Send only the fields to change.",
          "readOnly": false
        }
      },
      "delete": {
        "tags": [
          "webstore"
        ],
        "summary": "Delete template variable",
        "description": "Permanently deletes a template variable.",
        "operationId": "WebstoreTemplateVariables_DeleteWebstoreTemplateVariable",
        "parameters": [
          {
            "name": "storeId",
            "in": "path",
            "description": "The ID of the store the webstore belongs to.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateId",
            "in": "path",
            "description": "The ID of the template.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          },
          {
            "name": "templateVariableId",
            "in": "path",
            "description": "The ID of the template variable.",
            "required": true,
            "schema": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PayNowError"
                }
              }
            }
          }
        },
        "security": [
          {
            "APIKey": [ ]
          }
        ],
        "x-paynow-mcp": {
          "name": "paynow_delete_webstore_template_variable",
          "description": "Permanently deletes a template variable.",
          "readOnly": false
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AbandonedCheckoutStoreConfigurationCommandDto": {
        "required": [
          "command",
          "id",
          "online_only",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "command": {
            "type": "string",
            "description": "The command to execute."
          },
          "online_only": {
            "type": "boolean",
            "description": "Indicates if the command should be executed if the player is online."
          }
        },
        "additionalProperties": false,
        "description": "Represents a command associated with the store-level abandoned checkout configuration."
      },
      "AbandonedCheckoutStoreConfigurationDto": {
        "required": [
          "commands",
          "coupon_configuration",
          "enabled",
          "invalid",
          "minimum_order_value",
          "store_id",
          "trigger_after",
          "updated_at",
          "updated_by"
        ],
        "type": "object",
        "properties": {
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "enabled": {
            "type": "boolean",
            "description": "A value indicating whether the abandoned checkout feature is enabled for the store."
          },
          "invalid": {
            "type": "boolean",
            "description": "A value indicating whether the abandoned checkout configuration for the store is invalid."
          },
          "trigger_after": {
            "$ref": "#/components/schemas/Period"
          },
          "minimum_order_value": {
            "type": "integer",
            "description": "The minimum order value required to trigger an abandoned checkout email.",
            "format": "int64"
          },
          "maximum_order_value": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The optional maximum order value beyond which an abandoned checkout email will not be sent.",
            "format": "int64"
          },
          "max_coupons_per_customer_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The optional maximum coupons limit per customer beyond which an abandoned checkout email will not be sent.",
            "format": "int32"
          },
          "max_coupons_per_customer_period": {
            "$ref": "#/components/schemas/Period"
          },
          "max_coupons_global_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The optional maximum coupons limit store wide beyond which an abandoned checkout email will not be sent.",
            "format": "int32"
          },
          "max_coupons_global_period": {
            "$ref": "#/components/schemas/Period"
          },
          "coupon_configuration": {
            "$ref": "#/components/schemas/MarketingCouponConfigurationDto"
          },
          "commands": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AbandonedCheckoutStoreConfigurationCommandDto"
            },
            "description": "The commands you want to execute when the email is sent."
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "updated_at": {
            "type": "string",
            "description": "The date and time when the configuration was last updated.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents the store-level configuration for abandoned checkout settings."
      },
      "AbandonedCheckoutStoreConfigurationUpdateCommandDto": {
        "required": [
          "command",
          "online_only"
        ],
        "type": "object",
        "properties": {
          "command": {
            "type": "string",
            "description": "The command to execute."
          },
          "online_only": {
            "type": "boolean",
            "description": "Indicates if the command should be executed if the player is online."
          }
        },
        "additionalProperties": false,
        "description": "Represents a command associated with the store-level abandoned checkout configuration."
      },
      "AbandonedCheckoutStoreConfigurationUpdateDto": {
        "required": [
          "commands",
          "coupon_configuration",
          "enabled",
          "minimum_order_value",
          "trigger_after"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "A value indicating whether the abandoned checkout feature is enabled for the store."
          },
          "trigger_after": {
            "$ref": "#/components/schemas/Period"
          },
          "minimum_order_value": {
            "type": "integer",
            "description": "The minimum order value required to trigger an abandoned checkout email.",
            "format": "int64"
          },
          "maximum_order_value": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The optional maximum order value beyond which an abandoned checkout email will not be sent.",
            "format": "int64"
          },
          "max_coupons_per_customer_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The optional maximum coupons limit per customer beyond which an abandoned checkout email will not be sent.",
            "format": "int32"
          },
          "max_coupons_per_customer_period": {
            "$ref": "#/components/schemas/Period"
          },
          "max_coupons_global_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The optional maximum coupons limit store wide beyond which an abandoned checkout email will not be sent.",
            "format": "int32"
          },
          "max_coupons_global_period": {
            "$ref": "#/components/schemas/Period"
          },
          "commands": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AbandonedCheckoutStoreConfigurationUpdateCommandDto"
            }
          },
          "coupon_configuration": {
            "$ref": "#/components/schemas/MarketingCouponConfigurationDto"
          }
        },
        "additionalProperties": false,
        "description": "Used for updating the store-level configuration for abandoned checkout settings."
      },
      "ActorDto": {
        "required": [
          "type"
        ],
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/PayNowActorType"
          },
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false,
        "description": "Represents the actor that performed an action, such as the user, API key or game server that\ncreated or changed a record."
      },
      "AddressDto": {
        "type": "object",
        "properties": {
          "country": {
            "type": [
              "null",
              "string"
            ],
            "description": "The country of the address"
          },
          "state": {
            "type": [
              "null",
              "string"
            ],
            "description": "The state or province of the address"
          },
          "city": {
            "type": [
              "null",
              "string"
            ],
            "description": "The city of the address"
          },
          "postal_code": {
            "type": [
              "null",
              "string"
            ],
            "description": "The postal code or zip code of the address"
          },
          "line_1": {
            "type": [
              "null",
              "string"
            ],
            "description": "The first line of the street address"
          },
          "line_2": {
            "type": [
              "null",
              "string"
            ],
            "description": "The second line of the street address, if any (apartment, suite, etc.)"
          }
        },
        "additionalProperties": false,
        "description": "Represents a physical or billing address"
      },
      "AffiliateLinkCommissionAmountStepDto": {
        "required": [
          "billing_cycle_sequence",
          "commission_amount"
        ],
        "type": "object",
        "properties": {
          "billing_cycle_sequence": {
            "type": "integer",
            "description": "The billing cycle number this commission step applies to. Starts at 1 for the initial purchase.",
            "format": "int32"
          },
          "commission_amount": {
            "type": "integer",
            "description": "The commission percentage for this cycle, in tenths of a percent (e.g., 125 = 12.5%).",
            "format": "int64"
          }
        },
        "additionalProperties": false,
        "description": "Represents the commission for a specific subscription renewal billing cycle.\nA step applies to its exact cycle - see the affiliate link's 'last_commission_amount_step_repeats' for what happens past the last step."
      },
      "AffiliateLinkCommissionTypeDto": {
        "enum": [
          "none",
          "fixed",
          "percentage"
        ],
        "type": "string",
        "description": "Specifies the type of commission an affiliate earns from referred purchases.",
        "x-enumDescriptions": {
          "none": "No commission is earned.",
          "fixed": "A fixed amount commission (e.g., $5 per purchase). Not yet supported by the affiliate service.",
          "percentage": "A percentage-based commission (e.g., 10% of the purchase)."
        },
        "x-paynow-docs-enum-descriptions": {
          "none": "No commission is earned.",
          "fixed": "A fixed amount commission (e.g., $5 per purchase). Not yet supported by the affiliate service.",
          "percentage": "A percentage-based commission (e.g., 10% of the purchase)."
        }
      },
      "AffiliateLinkDiscountTypeDto": {
        "enum": [
          "none",
          "fixed",
          "percentage"
        ],
        "type": "string",
        "description": "Specifies the type of discount offered to customers referred through an affiliate link.",
        "x-enumDescriptions": {
          "none": "No discount is offered.",
          "fixed": "A fixed amount discount (e.g., $5 off).",
          "percentage": "A percentage-based discount (e.g., 10% off)."
        },
        "x-paynow-docs-enum-descriptions": {
          "none": "No discount is offered.",
          "fixed": "A fixed amount discount (e.g., $5 off).",
          "percentage": "A percentage-based discount (e.g., 10% off)."
        }
      },
      "AffiliateLinkDto": {
        "required": [
          "apply_for_subscriptions",
          "code",
          "commission_amount",
          "commission_amount_steps",
          "commission_type",
          "created_at",
          "created_by",
          "discount_amount",
          "discount_type",
          "enabled",
          "id",
          "last_commission_amount_step_repeats",
          "referer_type",
          "store_id",
          "tracking_length_days",
          "wallet_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "wallet_id": {
            "type": "string",
            "description": "The identifier of the wallet that receives the affiliate commission payouts."
          },
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the affiliate link is enabled."
          },
          "code": {
            "type": "string",
            "description": "The unique code associated with the affiliate link."
          },
          "referer_type": {
            "$ref": "#/components/schemas/AffiliateLinkRefererTypeDto"
          },
          "tracking_length_days": {
            "type": "integer",
            "description": "The number of days a customer's referral is tracked after following the affiliate link.",
            "format": "int32"
          },
          "apply_for_subscriptions": {
            "type": "boolean",
            "description": "Whether the affiliate earns commission on subscription renewals.\nMust be enabled for 'commission_amount_steps' past the first cycle to apply - when disabled, only the initial purchase earns commission."
          },
          "discount_type": {
            "$ref": "#/components/schemas/AffiliateLinkDiscountTypeDto"
          },
          "discount_amount": {
            "type": "integer",
            "description": "The discount amount, in the smallest currency unit (e.g., cents) for fixed discounts, or tenths of a percent (e.g., 125 = 12.5%) for percentage discounts.",
            "format": "int64"
          },
          "commission_type": {
            "$ref": "#/components/schemas/AffiliateLinkCommissionTypeDto"
          },
          "commission_amount": {
            "type": "integer",
            "description": "The commission amount, in tenths of a percent (e.g., 125 = 12.5%) for percentage commissions.",
            "format": "int64"
          },
          "commission_amount_steps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AffiliateLinkCommissionAmountStepDto"
            },
            "description": "Per-cycle commission overrides. Requires 'apply_for_subscriptions' to be enabled for billing cycles past 1.\nWhen empty, the base commission amount applies to every renewal. When steps are defined, each renewal cycle pays its matching steps amount.\nCycles without a matching step earn no commission, except cycles past the last step when 'last_commission_amount_step_repeats' is true."
          },
          "last_commission_amount_step_repeats": {
            "type": "boolean",
            "description": "Whether the last commission amount steps rate continues to apply to all billing cycles past the last step.\nWhen false, cycles past the last step earn no commission."
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "created_at": {
            "type": "string",
            "description": "The date and time when the affiliate link was created.",
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the affiliate link was last updated.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents a detailed view of an affiliate link, including configuration and audit information."
      },
      "AffiliateLinkRefererTypeDto": {
        "enum": [
          "invalid",
          "first_referer",
          "last_referer"
        ],
        "type": "string",
        "description": "Specifies which affiliate link is credited when a customer follows multiple links before purchasing.",
        "x-enumDescriptions": {
          "invalid": "No referer type specified. This value is typically used as a default or uninitialized state.",
          "first_referer": "The first affiliate link the customer followed is credited.",
          "last_referer": "The most recent affiliate link the customer followed is credited."
        },
        "x-paynow-docs-enum-descriptions": {
          "invalid": "No referer type specified. This value is typically used as a default or uninitialized state.",
          "first_referer": "The first affiliate link the customer followed is credited.",
          "last_referer": "The most recent affiliate link the customer followed is credited."
        }
      },
      "AffiliateLinkResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "affiliate_link": {
            "$ref": "#/components/schemas/AffiliateLinkDto"
          }
        },
        "additionalProperties": false
      },
      "AlipayDetailsDto": {
        "type": "object",
        "properties": {
          "buyer_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The Alipay buyer identifier",
            "example": "buyer_abc123"
          },
          "fingerprint": {
            "type": [
              "null",
              "string"
            ],
            "description": "A unique fingerprint for this Alipay account",
            "example": "fingerprint_xyz789"
          }
        },
        "additionalProperties": false,
        "description": "Alipay payment method details"
      },
      "ApiKeyDto": {
        "required": [
          "created_at",
          "created_by",
          "id",
          "name",
          "role_id",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "role_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "name": {
            "type": "string",
            "description": "The name of the API key."
          },
          "token": {
            "type": [
              "null",
              "string"
            ],
            "description": "The secret token used to authenticate as this API key. Only returned when the\nkey is created and when its token is reset."
          },
          "token_reset_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "When the API key's token was last reset.",
            "format": "date-time"
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "created_at": {
            "type": "string",
            "description": "When the API key was created.",
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "When the API key was last updated.",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "ApiKeyResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "api_key": {
            "$ref": "#/components/schemas/ApiKeyDto"
          }
        },
        "additionalProperties": false
      },
      "AvailablePermissionDto": {
        "required": [
          "description",
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "BanDto": {
        "required": [
          "created_at",
          "created_by",
          "enabled",
          "id",
          "identities",
          "reason",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "reason": {
            "type": "string",
            "description": "The reason recorded for the ban."
          },
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the ban is currently enforced."
          },
          "identities": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BanIdentityDto"
            },
            "description": "The identities the ban applies to. A customer matching any one of them is banned."
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "created_at": {
            "type": "string",
            "description": "The date and time the ban was created.",
            "format": "date-time"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time the ban was last updated, or null when it has never been updated.",
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "expires_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time the ban lifts, or null when the ban is permanent.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents a ban that blocks customers matching any of its identities from purchasing in the store."
      },
      "BanIdentityDto": {
        "required": [
          "ban_type",
          "ban_type_value"
        ],
        "type": "object",
        "properties": {
          "ban_type": {
            "$ref": "#/components/schemas/BanType"
          },
          "ban_type_value": {
            "type": "string",
            "description": "The value to match for 'ban_type': the Steam ID, IP address, customer ID, customer name or\nemail address respectively."
          }
        },
        "additionalProperties": false,
        "description": "Represents one identity a ban applies to."
      },
      "BanResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "ban": {
            "$ref": "#/components/schemas/BanDto"
          }
        },
        "additionalProperties": false
      },
      "BanType": {
        "enum": [
          "unknown",
          "steam",
          "ip",
          "customer",
          "customer_name",
          "email"
        ],
        "type": "string"
      },
      "BancontactDetailsDto": {
        "type": "object",
        "properties": {
          "bank": {
            "type": [
              "null",
              "string"
            ],
            "description": "The bank identifier",
            "example": "bnp_paribas"
          },
          "bank_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The bank name",
            "example": "BNP Paribas"
          },
          "bic": {
            "type": [
              "null",
              "string"
            ],
            "description": "The Bank Identifier Code",
            "example": "GEBABEBB"
          },
          "iban_last4": {
            "type": [
              "null",
              "string"
            ],
            "description": "The last 4 digits of the IBAN",
            "example": 3456
          },
          "payer_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The payer name",
            "example": "Jean Dupont"
          }
        },
        "additionalProperties": false,
        "description": "Bancontact payment method details"
      },
      "BizumDetailsDto": {
        "type": "object",
        "properties": {
          "buyer_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The buyer identifier assigned by the local payment processor",
            "example": "buyer_abc123"
          }
        },
        "additionalProperties": false,
        "description": "Bizum payment method details"
      },
      "BlikDetailsDto": {
        "type": "object",
        "properties": {
          "buyer_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The buyer identifier assigned by BLIK",
            "example": "buyer_abc123"
          }
        },
        "additionalProperties": false,
        "description": "BLIK payment method details"
      },
      "CancelSubscriptionRequestDto": {
        "type": "object",
        "properties": {
          "cancel_at_period_end": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Should the subscription be cancelled immediately (false) or on the next billing period (true)?"
          }
        },
        "additionalProperties": false
      },
      "CardDetailsDto": {
        "required": [
          "brand",
          "country",
          "exp_month",
          "exp_year",
          "fingerprint",
          "funding",
          "last4"
        ],
        "type": "object",
        "properties": {
          "brand": {
            "type": "string",
            "description": "The card brand",
            "example": "visa"
          },
          "country": {
            "type": "string",
            "description": "The country code where the card was issued",
            "example": "US"
          },
          "exp_month": {
            "type": "integer",
            "description": "The card expiration month",
            "format": "int32",
            "example": 12
          },
          "exp_year": {
            "type": "integer",
            "description": "The card expiration year",
            "format": "int32",
            "example": 2028
          },
          "fingerprint": {
            "type": "string",
            "description": "A unique fingerprint for this card",
            "example": "abc123def456"
          },
          "funding": {
            "type": "string",
            "description": "The card funding type",
            "example": "credit"
          },
          "last4": {
            "type": "string",
            "description": "The last 4 digits of the card number",
            "example": "4242"
          },
          "bin": {
            "type": [
              "null",
              "string"
            ],
            "description": "The Bank Identification Number (first 6/8 digits of card).\nOnly available internally.",
            "example": 424242
          },
          "issuer": {
            "type": [
              "null",
              "string"
            ],
            "description": "The card issuer/bank name.\nOnly available internally.",
            "example": "Chase Bank"
          },
          "description": {
            "type": [
              "null",
              "string"
            ],
            "description": "The card description.\nOnly available internally.",
            "example": "Visa Signature"
          },
          "brand_product": {
            "type": [
              "null",
              "string"
            ],
            "description": "The card product code.\nOnly available internally.",
            "example": "F"
          },
          "payment_account_reference": {
            "type": [
              "null",
              "string"
            ],
            "description": "The card network's Payment Account Reference, identifying the underlying card across merchants.\nOnly available internally.",
            "example": "V0010013019326121174033855440"
          },
          "wallet": {
            "$ref": "#/components/schemas/CardWalletDto"
          },
          "display_brand": {
            "type": [
              "null",
              "string"
            ],
            "description": "The brand to display for the card, which differs from 'brand' for co-branded cards",
            "example": "cartes_bancaires"
          },
          "networks": {
            "$ref": "#/components/schemas/CardNetworksDto"
          }
        },
        "additionalProperties": false,
        "description": "Card payment method details"
      },
      "CardNetworksDto": {
        "required": [
          "available"
        ],
        "type": "object",
        "properties": {
          "available": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The networks the card can be processed on"
          },
          "preferred": {
            "type": [
              "null",
              "string"
            ],
            "description": "The network the customer chose to process the card on",
            "example": "cartes_bancaires"
          }
        },
        "additionalProperties": false,
        "description": "Card networks the card can be processed on"
      },
      "CardWalletDto": {
        "required": [
          "type"
        ],
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "The type of digital wallet",
            "example": "apple_pay"
          },
          "dynamic_last4": {
            "type": [
              "null",
              "string"
            ],
            "description": "The last 4 digits of the device account number, for tokenized cards",
            "example": 9876
          }
        },
        "additionalProperties": false,
        "description": "Digital wallet details for a card"
      },
      "CashAppDetailsDto": {
        "required": [
          "buyer_id",
          "cashtag"
        ],
        "type": "object",
        "properties": {
          "buyer_id": {
            "type": "string",
            "description": "The Cash App buyer identifier",
            "example": "buyer_abc123"
          },
          "cashtag": {
            "type": "string",
            "description": "The Cash App cashtag",
            "example": "$johndoe"
          }
        },
        "additionalProperties": false,
        "description": "Cash App payment method details"
      },
      "ChangeSubscriptionPlanDto": {
        "required": [
          "plan_id",
          "renewal_period"
        ],
        "type": "object",
        "properties": {
          "plan_id": {
            "minLength": 1,
            "type": "string",
            "description": "The identifier of the plan to move the store onto."
          },
          "renewal_period": {
            "$ref": "#/components/schemas/SubscriptionRenewalPeriodDto"
          }
        },
        "additionalProperties": false,
        "description": "Represents a request to move a store onto a different plan."
      },
      "ChargebackCoverageTypeDto": {
        "enum": [
          "unspecified",
          "none",
          "fraudulent",
          "all"
        ],
        "type": "string",
        "description": "Defines the type of chargeback coverage provided.",
        "x-enumDescriptions": {
          "unspecified": "Chargeback coverage type is not specified.",
          "none": "No chargeback coverage provided.",
          "fraudulent": "Coverage for fraudulent/unauthorized chargebacks only.",
          "all": "Coverage for all chargebacks including disputes."
        },
        "x-paynow-docs-enum-descriptions": {
          "unspecified": "Chargeback coverage type is not specified.",
          "none": "No chargeback coverage provided.",
          "fraudulent": "Coverage for fraudulent/unauthorized chargebacks only.",
          "all": "Coverage for all chargebacks including disputes."
        }
      },
      "CheckForBanIDByIdentitiesRequestDto": {
        "required": [
          "identities"
        ],
        "type": "object",
        "properties": {
          "identities": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BanIdentityDto"
            }
          }
        },
        "additionalProperties": false
      },
      "CheckForBanIDByIdentitiesResponseDto": {
        "required": [
          "is_banned"
        ],
        "type": "object",
        "properties": {
          "is_banned": {
            "type": "boolean"
          },
          "ban_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false
      },
      "CheckoutCustomerDetailsDto": {
        "type": "object",
        "properties": {
          "billing_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The name the checkout is billed to."
          },
          "billing_email": {
            "type": [
              "null",
              "string"
            ],
            "description": "The email address the checkout is billed to."
          },
          "billing_address": {
            "$ref": "#/components/schemas/AddressDto"
          },
          "billing_tax_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The tax identifier of the customer, such as a VAT number."
          }
        },
        "additionalProperties": false,
        "description": "The billing details of the customer the checkout belongs to."
      },
      "CheckoutPaymentInfoDto": {
        "required": [
          "declined",
          "status"
        ],
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "description": "Status string from the payment provider."
          },
          "declined": {
            "type": "boolean",
            "description": "Indicates whether the payment was declined."
          },
          "decline_message": {
            "type": [
              "null",
              "string"
            ],
            "description": "The customer readable decline reason, if the payment was declined."
          },
          "checkout_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "Checkout URL to redirect to for on-session payments."
          }
        },
        "additionalProperties": false,
        "description": "Payment outcome information returned after a subscription change triggers an immediate charge."
      },
      "CheckoutSessionDto": {
        "required": [
          "requires_payment"
        ],
        "type": "object",
        "properties": {
          "session_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "The URL the store owner is sent to in order to complete payment. Null when\n'requires_payment' is false."
          },
          "requires_payment": {
            "type": "boolean",
            "description": "Whether the change needs a payment before it takes effect."
          }
        },
        "additionalProperties": false,
        "description": "Represents the outcome of a subscription change that may require the store owner to pay."
      },
      "CheckoutStyleDto": {
        "required": [
          "store_id"
        ],
        "type": "object",
        "properties": {
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "font_family": {
            "type": [
              "null",
              "string"
            ],
            "description": "The CSS font family used for text on the checkout, or null to use the default font."
          },
          "border_radius": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The corner radius applied to buttons, inputs and panels on the checkout, in pixels, or null to\nuse the default radius.",
            "format": "int32"
          },
          "color_primary": {
            "type": [
              "null",
              "string"
            ],
            "description": "The accent colour used for primary buttons and highlights, as a CSS colour value, or null to\nuse the default."
          },
          "color_elements": {
            "type": [
              "null",
              "string"
            ],
            "description": "The background colour of panels and cards on the checkout, as a CSS colour value, or null to\nuse the default."
          },
          "color_input": {
            "type": [
              "null",
              "string"
            ],
            "description": "The background colour of input fields, as a CSS colour value, or null to use the default."
          },
          "color_background": {
            "type": [
              "null",
              "string"
            ],
            "description": "The background colour of the checkout page, as a CSS colour value, or null to use the default."
          },
          "color_text": {
            "type": [
              "null",
              "string"
            ],
            "description": "The colour of text on the checkout, as a CSS colour value, or null to use the default."
          },
          "color_outline": {
            "type": [
              "null",
              "string"
            ],
            "description": "The colour of borders and outlines on the checkout, as a CSS colour value, or null to use the\ndefault."
          },
          "url_background": {
            "type": [
              "null",
              "string"
            ],
            "description": "The URL of the image shown behind the checkout, or null when there is none. It cannot be set\ndirectly; set 'background_media_asset_id' instead."
          },
          "background_media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false,
        "description": "Represents the styling applied to the store's hosted checkout."
      },
      "CommandAttemptDto": {
        "required": [
          "command",
          "gameserver_id",
          "id",
          "online_only",
          "queued_at",
          "rerun",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "inventory_item_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "gameserver_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "steam_id": {
            "$ref": "#/components/schemas/SteamId"
          },
          "minecraft_uuid": {
            "type": [
              "null",
              "string"
            ]
          },
          "customer_name": {
            "type": [
              "null",
              "string"
            ]
          },
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "command_stage": {
            "type": [
              "null",
              "string"
            ]
          },
          "command": {
            "type": "string"
          },
          "online_only": {
            "type": "boolean"
          },
          "rerun": {
            "type": "boolean"
          },
          "queued_at": {
            "type": "string",
            "format": "date-time"
          },
          "executed_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "executed_by_ip": {
            "type": [
              "null",
              "string"
            ]
          },
          "unqueued_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "CouponDiscountTypeDto": {
        "enum": [
          "unspecified",
          "percent",
          "amount"
        ],
        "type": "string",
        "description": "Specifies the type of discount applied by a coupon.",
        "x-enumDescriptions": {
          "unspecified": "No discount type specified. This value is typically used as a default or uninitialized state.",
          "percent": "A percentage-based discount (e.g., 10% off).",
          "amount": "A fixed amount discount (e.g., $5 off)."
        },
        "x-paynow-docs-enum-descriptions": {
          "unspecified": "No discount type specified. This value is typically used as a default or uninitialized state.",
          "percent": "A percentage-based discount (e.g., 10% off).",
          "amount": "A fixed amount discount (e.g., $5 off)."
        }
      },
      "CouponDto": {
        "required": [
          "code",
          "created_at",
          "discount_amount",
          "discount_apply_before_sales",
          "discount_apply_individually",
          "discount_type",
          "duration",
          "enabled",
          "id",
          "minimum_order_value",
          "redeem_limit_customer_amount",
          "redeem_limit_customer_enabled",
          "redeem_limit_store_amount",
          "redeem_limit_store_enabled",
          "store_id",
          "usable_on_one_time_purchase",
          "usable_on_subscription",
          "version_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the coupon is enabled."
          },
          "code": {
            "type": "string",
            "description": "The unique code associated with the coupon."
          },
          "note": {
            "type": [
              "null",
              "string"
            ],
            "description": "A note or internal description of the coupon."
          },
          "duration": {
            "$ref": "#/components/schemas/CouponDurationDto"
          },
          "duration_in_months": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The number of months the coupon is valid for, used if the duration is repeating.",
            "format": "int32",
            "deprecated": true
          },
          "duration_in_intervals": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The number of subscription renewals the coupon is valid for, used if the duration is repeating.",
            "format": "int32"
          },
          "discount_type": {
            "$ref": "#/components/schemas/CouponDiscountTypeDto"
          },
          "discount_amount": {
            "type": "integer",
            "description": "The discount amount, interpreted based on discount type: for a fixed-amount\ndiscount, this is in the smallest currency unit (e.g., cents); for a\npercentage discount, this is in tenths of a percent (e.g., 100 = 10.0% off).",
            "format": "int64"
          },
          "discount_apply_individually": {
            "type": "boolean",
            "description": "Indicates whether the discount should be applied individually to required tags or products."
          },
          "discount_apply_before_sales": {
            "type": "boolean",
            "description": "Indicates whether the discount is applied before existing sales."
          },
          "apply_to_products": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "A list of product IDs the coupon applies to."
          },
          "apply_to_tags": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "A list of tag IDs the coupon applies to."
          },
          "usable_by_customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "minimum_order_value": {
            "type": "integer",
            "description": "The minimum order value required to use the coupon.",
            "format": "int64"
          },
          "redeem_limit_store_enabled": {
            "type": "boolean",
            "description": "Indicates whether a global redemption limit is enabled."
          },
          "redeem_limit_store_amount": {
            "type": "integer",
            "description": "The maximum number of times the coupon can be redeemed across the store.",
            "format": "int64"
          },
          "redeem_limit_customer_enabled": {
            "type": "boolean",
            "description": "Indicates whether a per-customer redemption limit is enabled."
          },
          "redeem_limit_customer_amount": {
            "type": "integer",
            "description": "The maximum number of times the coupon can be redeemed per customer.",
            "format": "int64"
          },
          "usable_on_one_time_purchase": {
            "type": "boolean",
            "description": "Indicates whether the coupon can be used for one-time purchases."
          },
          "usable_on_subscription": {
            "type": "boolean",
            "description": "Indicates whether the coupon can be used for subscriptions."
          },
          "usable_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the coupon becomes valid.",
            "format": "date-time"
          },
          "expires_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the coupon expires.",
            "format": "date-time"
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "created_at": {
            "type": "string",
            "description": "The date and time when the coupon was created.",
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the coupon was last updated.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents a detailed view of a coupon, including configuration and audit information."
      },
      "CouponDurationDto": {
        "enum": [
          "once",
          "forever",
          "repeating"
        ],
        "type": "string",
        "description": "Defines the duration for which a coupon remains valid.",
        "x-enumDescriptions": {
          "once": "The coupon can be used only once.",
          "forever": "The coupon remains valid indefinitely (no expiration).",
          "repeating": "The coupon is valid for a repeating period, typically specified in months."
        },
        "x-paynow-docs-enum-descriptions": {
          "once": "The coupon can be used only once.",
          "forever": "The coupon remains valid indefinitely (no expiration).",
          "repeating": "The coupon is valid for a repeating period, typically specified in months."
        }
      },
      "CouponFilterStatusDto": {
        "enum": [
          "all",
          "active",
          "inactive"
        ],
        "type": "string",
        "description": "Will filter by coupon status.",
        "x-enumDescriptions": {
          "all": "List all coupons.",
          "active": "Coupon's that are active.",
          "inactive": "Coupon's that are inactive."
        },
        "x-paynow-docs-enum-descriptions": {
          "all": "List all coupons.",
          "active": "Coupon's that are active.",
          "inactive": "Coupon's that are inactive."
        }
      },
      "CouponFilterTypeDto": {
        "enum": [
          "all",
          "manual",
          "generated"
        ],
        "type": "string",
        "description": "Will filter by coupon creation type.",
        "x-enumDescriptions": {
          "all": "List all coupons.",
          "manual": "Coupon's that were created by a user.",
          "generated": "Coupon's that were created by the system (basket recover, etc.)."
        },
        "x-paynow-docs-enum-descriptions": {
          "all": "List all coupons.",
          "manual": "Coupon's that were created by a user.",
          "generated": "Coupon's that were created by the system (basket recover, etc.)."
        }
      },
      "CouponResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "coupon": {
            "$ref": "#/components/schemas/CouponDto"
          }
        },
        "additionalProperties": false
      },
      "CreateAffiliateLinkDto": {
        "required": [
          "wallet_id",
          "enabled",
          "code",
          "referer_type",
          "tracking_length_days",
          "apply_for_subscriptions",
          "discount_type",
          "discount_amount",
          "commission_type",
          "commission_amount",
          "commission_amount_steps",
          "last_commission_amount_step_repeats"
        ],
        "type": "object",
        "properties": {
          "wallet_id": {
            "type": "string",
            "description": "The identifier of the wallet that receives the affiliate commission payouts."
          },
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the affiliate link is enabled."
          },
          "code": {
            "type": "string",
            "description": "The unique code associated with the affiliate link."
          },
          "referer_type": {
            "$ref": "#/components/schemas/AffiliateLinkRefererTypeDto"
          },
          "tracking_length_days": {
            "type": "integer",
            "description": "The number of days a customer's referral is tracked after following the affiliate link.",
            "format": "int32"
          },
          "apply_for_subscriptions": {
            "type": "boolean",
            "description": "Whether the affiliate earns commission on subscription renewals.\nMust be enabled for 'commission_amount_steps' past the first cycle to apply - when disabled, only the initial purchase earns commission."
          },
          "discount_type": {
            "$ref": "#/components/schemas/AffiliateLinkDiscountTypeDto"
          },
          "discount_amount": {
            "type": "integer",
            "description": "The discount amount, in the smallest currency unit (e.g., cents) for fixed discounts, or tenths of a percent (e.g., 125 = 12.5%) for percentage discounts.",
            "format": "int64"
          },
          "commission_type": {
            "$ref": "#/components/schemas/AffiliateLinkCommissionTypeDto"
          },
          "commission_amount": {
            "type": "integer",
            "description": "The commission amount, in tenths of a percent (e.g., 125 = 12.5%) for percentage commissions.",
            "format": "int64"
          },
          "commission_amount_steps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AffiliateLinkCommissionAmountStepDto"
            },
            "description": "Per-cycle commission overrides. Requires 'apply_for_subscriptions' to be enabled for billing cycles past 1.\nWhen empty, the base commission amount applies to every renewal. When steps are defined, each renewal cycle pays its matching steps amount.\nCycles without a matching step earn no commission, except cycles past the last step when 'last_commission_amount_step_repeats' is true."
          },
          "last_commission_amount_step_repeats": {
            "type": "boolean",
            "description": "Whether the last commission amount steps rate continues to apply to all billing cycles past the last step.\nWhen false, cycles past the last step earn no commission."
          }
        }
      },
      "CreateCheckoutSessionLineDto": {
        "required": [
          "product_id",
          "quantity"
        ],
        "type": "object",
        "properties": {
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "subscription": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Determines whether this line should create a subscription"
          },
          "trial": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether the product should be trialed"
          },
          "gift_to": {
            "$ref": "#/components/schemas/CustomerPlatformAccountDto"
          },
          "gift_to_customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "quantity": {
            "type": "integer",
            "description": "The quantity of this product to purchase",
            "format": "int32"
          },
          "selected_gameserver_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "custom_variables": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "type": "string"
            },
            "description": "Key-value pair mapping custom variable identifiers to their selected values.\nRequired only when the product includes custom variables."
          }
        },
        "additionalProperties": false,
        "description": "Represents a line item in a checkout session request"
      },
      "CreateCheckoutSessionLineManagementDto": {
        "required": [
          "quantity"
        ],
        "type": "object",
        "properties": {
          "subscription": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Determines whether this line should create a subscription"
          },
          "trial": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether the product should be trialed"
          },
          "gift_to": {
            "$ref": "#/components/schemas/CustomerPlatformAccountDto"
          },
          "gift_to_customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "quantity": {
            "type": "integer",
            "description": "The quantity of this product to purchase",
            "format": "int32"
          },
          "selected_gameserver_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "custom_variables": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "type": "string"
            },
            "description": "Key-value pair mapping custom variable identifiers to their selected values.\nRequired only when the product includes custom variables."
          },
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "inline_product": {
            "$ref": "#/components/schemas/InlineProductCreateDto"
          },
          "payout_splits": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/CreateCheckoutSessionLineManagementPayoutSplitDto"
            },
            "description": "Optional payout splits for line items (requires approval)"
          },
          "metadata": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "type": "string"
            },
            "description": "Optional metadata to associate with the checkout session line.\nDo not store any sensitive information here."
          }
        },
        "additionalProperties": false,
        "description": "Represents a line item in a checkout session request.\nOpposed to CreateCheckoutSessionLineDto, this is used while creating a checkout session using the Management API,\nand allows for creating inline products and payout splits (subject to special approval)"
      },
      "CreateCheckoutSessionLineManagementPayoutSplitDto": {
        "required": [
          "payout_id"
        ],
        "type": "object",
        "properties": {
          "payout_id": {
            "type": "string",
            "description": "The ID of the user's payout balance."
          },
          "percentage": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The percentage of the line amount this user receives (in basis points, e.g., 5000 = 50%)\nNOTE: The last payout split needs to have a null percentage set (so the remaining amount gets properly allocated)",
            "format": "int64",
            "example": 5000
          },
          "platform_fee": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The platform fee percentage applied to this split (in basis points)\nOnly applicable to platforms.",
            "format": "int64",
            "example": 500
          }
        },
        "additionalProperties": false
      },
      "CreateCheckoutSessionManagementDto": {
        "required": [
          "customer_id",
          "lines"
        ],
        "type": "object",
        "properties": {
          "lines": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CreateCheckoutSessionLineManagementDto"
            },
            "description": "The line items to include in the checkout"
          },
          "coupon_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "promo_codes": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "type": "string"
            },
            "description": "Optional array of promo codes (coupons, gift cards, affiliates) to apply.\nAn invalid promo code will cause an error."
          },
          "affiliate_code": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional affiliate code to track referrals.\nAn invalid affiliate code will NOT cause an error."
          },
          "return_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional URL to redirect to after successful checkout"
          },
          "cancel_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional URL to redirect to if checkout is canceled"
          },
          "auto_redirect": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Whether to automatically redirect the customer (return_url must be set)"
          },
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "metadata": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "type": "string"
            },
            "description": "Optional metadata to associate with the checkout session.\nDo not store any sensitive information here."
          },
          "customer_details": {
            "$ref": "#/components/schemas/CheckoutCustomerDetailsDto"
          }
        },
        "additionalProperties": false,
        "description": "Request to create a new checkout session from your back-end server using the management API.\n`customer_id` needs to be specified explicitly here instead of using a Customer token."
      },
      "CreateCheckoutSessionResponseDto": {
        "required": [
          "id",
          "token",
          "url"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "token": {
            "type": "string",
            "description": "The token for the checkout session"
          },
          "url": {
            "type": "string",
            "description": "The URL to redirect the customer to complete checkout"
          }
        },
        "additionalProperties": false,
        "description": "Response after creating a checkout session"
      },
      "CreateCheckoutStyleDto": {
        "type": "object",
        "properties": {
          "font_family": {
            "type": "string",
            "description": "The CSS font family used for text on the checkout, or null to use the default font."
          },
          "border_radius": {
            "type": "integer",
            "description": "The corner radius applied to buttons, inputs and panels on the checkout, in pixels, or null to\nuse the default radius.",
            "format": "int32"
          },
          "color_primary": {
            "type": "string",
            "description": "The accent colour used for primary buttons and highlights, as a CSS colour value, or null to\nuse the default."
          },
          "color_elements": {
            "type": "string",
            "description": "The background colour of panels and cards on the checkout, as a CSS colour value, or null to\nuse the default."
          },
          "color_input": {
            "type": "string",
            "description": "The background colour of input fields, as a CSS colour value, or null to use the default."
          },
          "color_background": {
            "type": "string",
            "description": "The background colour of the checkout page, as a CSS colour value, or null to use the default."
          },
          "color_text": {
            "type": "string",
            "description": "The colour of text on the checkout, as a CSS colour value, or null to use the default."
          },
          "color_outline": {
            "type": "string",
            "description": "The colour of borders and outlines on the checkout, as a CSS colour value, or null to use the\ndefault."
          },
          "background_media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        }
      },
      "CreateCouponDto": {
        "required": [
          "enabled",
          "code",
          "duration",
          "discount_type",
          "discount_amount",
          "discount_apply_individually",
          "discount_apply_before_sales",
          "minimum_order_value",
          "redeem_limit_store_enabled",
          "redeem_limit_store_amount",
          "redeem_limit_customer_enabled",
          "redeem_limit_customer_amount",
          "usable_on_one_time_purchase",
          "usable_on_subscription"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the coupon is enabled."
          },
          "code": {
            "type": "string",
            "description": "The unique code associated with the coupon."
          },
          "note": {
            "type": "string",
            "description": "A note or internal description of the coupon."
          },
          "duration": {
            "$ref": "#/components/schemas/CouponDurationDto"
          },
          "duration_in_months": {
            "type": "integer",
            "description": "The number of months the coupon is valid for, used if the duration is repeating.",
            "format": "int32",
            "deprecated": true
          },
          "duration_in_intervals": {
            "type": "integer",
            "description": "The number of subscription renewals the coupon is valid for, used if the duration is repeating.",
            "format": "int32"
          },
          "discount_type": {
            "$ref": "#/components/schemas/CouponDiscountTypeDto"
          },
          "discount_amount": {
            "type": "integer",
            "description": "The discount amount, interpreted based on discount type: for a fixed-amount\ndiscount, this is in the smallest currency unit (e.g., cents); for a\npercentage discount, this is in tenths of a percent (e.g., 100 = 10.0% off).",
            "format": "int64"
          },
          "discount_apply_individually": {
            "type": "boolean",
            "description": "Indicates whether the discount should be applied individually to required tags or products."
          },
          "discount_apply_before_sales": {
            "type": "boolean",
            "description": "Indicates whether the discount is applied before existing sales."
          },
          "apply_to_products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "A list of product IDs the coupon applies to."
          },
          "apply_to_tags": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "A list of tag IDs the coupon applies to."
          },
          "usable_by_customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "minimum_order_value": {
            "type": "integer",
            "description": "The minimum order value required to use the coupon.",
            "format": "int64"
          },
          "redeem_limit_store_enabled": {
            "type": "boolean",
            "description": "Indicates whether a global redemption limit is enabled."
          },
          "redeem_limit_store_amount": {
            "type": "integer",
            "description": "The maximum number of times the coupon can be redeemed across the store.",
            "format": "int64"
          },
          "redeem_limit_customer_enabled": {
            "type": "boolean",
            "description": "Indicates whether a per-customer redemption limit is enabled."
          },
          "redeem_limit_customer_amount": {
            "type": "integer",
            "description": "The maximum number of times the coupon can be redeemed per customer.",
            "format": "int64"
          },
          "usable_on_one_time_purchase": {
            "type": "boolean",
            "description": "Indicates whether the coupon can be used for one-time purchases."
          },
          "usable_on_subscription": {
            "type": "boolean",
            "description": "Indicates whether the coupon can be used for subscriptions."
          },
          "usable_at": {
            "type": "string",
            "description": "The date and time when the coupon becomes valid.",
            "format": "date-time"
          },
          "expires_at": {
            "type": "string",
            "description": "The date and time when the coupon expires.",
            "format": "date-time"
          }
        }
      },
      "CreateCustomerPortalSessionRequestDto": {
        "required": [
          "flow"
        ],
        "type": "object",
        "properties": {
          "flow": {
            "$ref": "#/components/schemas/CustomerPortalSessionFlowDto"
          },
          "expires_in": {
            "$ref": "#/components/schemas/Period"
          },
          "return_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "URL to redirect the customer back to after completing the portal flow"
          }
        },
        "additionalProperties": false,
        "description": "Request to create a new customer portal session from your back-end server using the management API"
      },
      "CreateDownloadableFileDownloadUrlResponseDto": {
        "required": [
          "download_signed_url"
        ],
        "type": "object",
        "properties": {
          "download_signed_url": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "CreateEmailBrandingDto": {
        "required": [
          "color"
        ],
        "type": "object",
        "properties": {
          "color": {
            "type": "string"
          },
          "header_image_light_media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "header_image_dark_media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        }
      },
      "CreateEmailTemplateDto": {
        "required": [
          "email_template_type",
          "name",
          "content"
        ],
        "type": "object",
        "properties": {
          "email_template_type": {
            "$ref": "#/components/schemas/EmailTemplateTypeDto"
          },
          "name": {
            "type": "string"
          },
          "content": {
            "type": "string"
          }
        }
      },
      "CreateGameServerConsoleDto": {
        "required": [
          "type",
          "enabled",
          "host",
          "port",
          "secure"
        ],
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/GameServerConsoleTypeDto"
          },
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether PayNow keeps the connection to the console open."
          },
          "host": {
            "type": "string",
            "description": "The hostname or IP address the game server's console listens on."
          },
          "port": {
            "type": "integer",
            "description": "The port the game server's console listens on.",
            "format": "int32"
          },
          "password": {
            "type": "string",
            "description": "The password used to authenticate with the console, or null when it requires none."
          },
          "secure": {
            "type": "boolean",
            "description": "Indicates whether the connection is made over TLS."
          }
        }
      },
      "CreateGameServerDto": {
        "required": [
          "name",
          "enabled"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The display name of the game server."
          },
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the game server is currently enabled."
          }
        }
      },
      "CreateGiftCardDto": {
        "required": [
          "enabled",
          "code",
          "balance",
          "usable_at"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the gift card is currently enabled and can be used."
          },
          "code": {
            "type": "string",
            "description": "The unique code that customers use to redeem the gift card.",
            "example": "GIFT-2024-ABCD1234"
          },
          "note": {
            "type": "string",
            "description": "Optional note or description associated with the gift card."
          },
          "balance": {
            "type": "integer",
            "description": "The current balance remaining on the gift card in cents.",
            "format": "int64",
            "example": 2500
          },
          "usable_by_customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "usable_at": {
            "type": "string",
            "description": "The date and time when the gift card becomes usable.",
            "format": "date-time"
          },
          "expires_at": {
            "type": "string",
            "description": "The date and time when the gift card expires, if applicable.",
            "format": "date-time"
          }
        }
      },
      "CreateInviteDto": {
        "required": [
          "role_id",
          "user_email"
        ],
        "type": "object",
        "properties": {
          "role_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "user_email": {
            "type": "string",
            "description": "The email address the invite was sent to."
          }
        }
      },
      "CreateMediaUploadRequestDto": {
        "required": [
          "content_type",
          "size_bytes"
        ],
        "type": "object",
        "properties": {
          "content_type": {
            "minLength": 1,
            "type": "string",
            "description": "The MIME type of the file. One of 'image/png', 'image/jpeg', 'image/webp', 'image/gif' or 'video/mp4'.",
            "example": "image/png"
          },
          "size_bytes": {
            "type": "integer",
            "description": "The size of the file in bytes, at most 20 MB (20971520 bytes).",
            "format": "int64",
            "example": 524288
          }
        },
        "additionalProperties": false,
        "description": "Represents a request to start uploading a media file."
      },
      "CreateMediaUploadResponseDto": {
        "required": [
          "expires_at",
          "media_asset_id",
          "upload_url"
        ],
        "type": "object",
        "properties": {
          "media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "upload_url": {
            "type": "string",
            "description": "The URL to upload the file to with a PUT request, sending the file as the raw request body."
          },
          "expires_at": {
            "type": "string",
            "description": "The date and time after which 'upload_url' stops accepting the upload.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents a started media upload."
      },
      "CreateNavLinkDto": {
        "required": [
          "tag_id"
        ],
        "type": "object",
        "properties": {
          "tag_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "parent_node_id": {
            "type": "string",
            "description": "The 'node_id' of the link this one nests under, or null when it sits at the top level of the\nnavigation."
          },
          "order": {
            "type": "integer",
            "description": "The position of the link among its siblings, lowest first, or null when no explicit order has\nbeen set.",
            "format": "int32"
          }
        }
      },
      "CreateProductDependentMigrationRequestDto": {
        "required": [
          "send_all_commands_to_new_servers",
          "send_new_commands_to_all_servers",
          "target_types"
        ],
        "type": "object",
        "properties": {
          "send_new_commands_to_all_servers": {
            "type": "boolean"
          },
          "send_all_commands_to_new_servers": {
            "type": "boolean"
          },
          "target_types": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductDependentMigrationTargetTypeDto"
            }
          }
        },
        "additionalProperties": false
      },
      "CreateRefundRequestDto": {
        "type": "object",
        "properties": {
          "order_line_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "refund_from_connected_user_balance": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Determines if the refund should be taken from the connected user's balance.\nOnly relevant for connected platforms."
          },
          "note": {
            "maxLength": 500,
            "type": [
              "null",
              "string"
            ],
            "description": "A note explaining why the refund was issued, at most 500 characters."
          }
        },
        "additionalProperties": false
      },
      "CreateRoleDto": {
        "required": [
          "name",
          "description"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "permissions": {
            "type": "object",
            "additionalProperties": {
              "type": "boolean"
            }
          }
        }
      },
      "CreateSaleDto": {
        "required": [
          "enabled",
          "name",
          "discount_type",
          "discount_amount",
          "duration",
          "duration_in_intervals",
          "apply_to_product_ids",
          "apply_to_tag_ids",
          "minimum_order_value",
          "begins_at"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the sale is enabled."
          },
          "name": {
            "type": "string",
            "description": "The name of the sale."
          },
          "discount_type": {
            "$ref": "#/components/schemas/SaleDiscountTypeDto"
          },
          "discount_amount": {
            "type": "integer",
            "description": "The discount value. For percent discounts, this represents the percentage \nmultiplied by 10 (e.g., 250 = 25%). For amount discounts, this represents \nthe value in the smallest currency unit (e.g., cents).",
            "format": "int32"
          },
          "duration": {
            "$ref": "#/components/schemas/SaleDurationDto"
          },
          "duration_in_intervals": {
            "type": "integer",
            "description": "The number of subscription intervals the coupon is valid for, used if the duration is repeating.",
            "format": "int32"
          },
          "apply_to_product_ids": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "A list of product IDs the sale applies to."
          },
          "apply_to_tag_ids": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "A list of tag IDs the sale applies to."
          },
          "minimum_order_value": {
            "type": "integer",
            "description": "The minimum order value required to apply the sale, in the smallest currency unit (e.g., cents).",
            "format": "int32"
          },
          "begins_at": {
            "type": "string",
            "description": "The date and time when the sale begins.",
            "format": "date-time"
          },
          "ends_at": {
            "type": "string",
            "description": "The date and time when the sale ends.",
            "format": "date-time"
          }
        }
      },
      "CreateStoreDto": {
        "required": [
          "slug",
          "name",
          "platform",
          "game",
          "currency",
          "description"
        ],
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "description": "The URL-safe slug used to identify the store (e.g. \"my-rust-server\")."
          },
          "name": {
            "type": "string",
            "description": "The display name of the store."
          },
          "platform": {
            "type": "string",
            "description": "The platform this store is associated with (e.g. \"rust\", \"minecraft\")."
          },
          "game": {
            "type": "string",
            "description": "Alias for 'platform'. Returns the platform identifier as a game name."
          },
          "currency": {
            "type": "string",
            "description": "The ISO 4217 currency code used by this store for pricing (e.g. \"usd\", \"eur\")"
          },
          "description": {
            "type": "string",
            "description": "A human-readable description of the store shown to customers and PayNow."
          },
          "website_url": {
            "type": "string",
            "description": "The store's public website URL."
          },
          "contact_email": {
            "type": "string",
            "description": "General contact email address for the store."
          },
          "support_email": {
            "type": "string",
            "description": "Dedicated support email address for customer inquiries."
          },
          "support_url": {
            "type": "string",
            "description": "URL to the store's support portal or help page."
          },
          "integration_type": {
            "type": "string",
            "description": "The integration type used by the store."
          },
          "logo_media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "logo_square_media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "minecraft_bedrock_username_prefix": {
            "type": "string",
            "description": "Username prefix used to identify Minecraft Bedrock players (e.g. \".\")."
          }
        }
      },
      "CreateStorePaymentSettingsDto": {
        "required": [
          "show_all_payment_methods_for_subscriptions",
          "store_tax_inclusive_pricing",
          "block_prepaid_cards",
          "promo_code_stacking_behavior",
          "adaptive_currency_enabled",
          "show_adaptive_currency_on_storefront"
        ],
        "type": "object",
        "properties": {
          "show_all_payment_methods_for_subscriptions": {
            "type": "boolean",
            "description": "Whether to show all available payment methods for subscription purchases."
          },
          "store_tax_inclusive_pricing": {
            "type": "boolean",
            "description": "Whether store pricing is tax-inclusive."
          },
          "block_prepaid_cards": {
            "$ref": "#/components/schemas/PrepaidCardsBlockingTypeDto"
          },
          "promo_code_stacking_behavior": {
            "$ref": "#/components/schemas/StorePromoCodeStackingBehaviorDto"
          },
          "adaptive_currency_enabled": {
            "type": "boolean",
            "description": "Whether the 'Adaptive Currency' feature is enabled."
          },
          "show_adaptive_currency_on_storefront": {
            "type": "boolean",
            "description": "Whether the displayed currency on the storefront should be the Adaptive Currency by default."
          }
        }
      },
      "CreateStoreUpsellSettingsDto": {
        "required": [
          "enabled",
          "automatic_recommendations_enabled",
          "automatic_recommendations_discount_type",
          "automatic_recommendations_discount_amount",
          "recommendation_overrides_enabled",
          "recommendation_overrides",
          "checkout_style"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "automatic_recommendations_enabled": {
            "type": "boolean"
          },
          "automatic_recommendations_discount_type": {
            "$ref": "#/components/schemas/UpsellDiscountTypeDto"
          },
          "automatic_recommendations_discount_amount": {
            "type": "integer",
            "format": "int64"
          },
          "recommendation_overrides_enabled": {
            "type": "boolean"
          },
          "recommendation_overrides": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/StoreUpsellRecommendationDto"
            }
          },
          "checkout_style": {
            "$ref": "#/components/schemas/StoreUpsellCheckoutStyleDto"
          }
        }
      },
      "CreateTierGroupRequestDto": {
        "required": [
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The name of the tier group."
          }
        },
        "additionalProperties": false
      },
      "CreateTrialEligibilityOverrideDto": {
        "required": [
          "product_id",
          "expires_at"
        ],
        "type": "object",
        "properties": {
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "expires_at": {
            "type": "string",
            "description": "The date and time when this override expires and is no longer valid.",
            "format": "date-time"
          },
          "note": {
            "type": "string",
            "description": "An optional note or comment about this override."
          }
        }
      },
      "CreateWebhookDto": {
        "required": [
          "subscribed_to",
          "type",
          "url"
        ],
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "subscribed_to": {
            "$ref": "#/components/schemas/WebhookEventType"
          },
          "type": {
            "$ref": "#/components/schemas/WebhookTypeDto"
          },
          "discord_description_template": {
            "type": [
              "null",
              "string"
            ]
          },
          "discord_title": {
            "type": [
              "null",
              "string"
            ]
          },
          "discord_color": {
            "type": [
              "null",
              "string"
            ]
          },
          "discord_format": {
            "$ref": "#/components/schemas/WebhookDiscordFormatDto"
          },
          "discord_skip_zero_total_orders": {
            "type": [
              "null",
              "boolean"
            ]
          }
        },
        "additionalProperties": false
      },
      "CreateWebstoreModuleDto": {
        "required": [
          "enabled",
          "type"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the module is rendered. A disabled module keeps its settings but is not\nshown to customers."
          },
          "type": {
            "type": "string",
            "description": "The kind of module. Decides which 'settings' it accepts and how the template renders it."
          },
          "settings": {
            "description": "The module's type-specific configuration as a JSON object, or null when it has none."
          },
          "starts_at": {
            "type": "string",
            "description": "The date and time the module starts being shown, or null to show it as soon as it is enabled.",
            "format": "date-time"
          },
          "ends_at": {
            "type": "string",
            "description": "The date and time the module stops being shown, or null to show it indefinitely.",
            "format": "date-time"
          }
        }
      },
      "CreateWebstoreTemplateDto": {
        "required": [
          "name",
          "compatibility_mode"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The display name of the template."
          },
          "compatibility_mode": {
            "$ref": "#/components/schemas/WebstoreTemplateCompatibilityModeDto"
          }
        }
      },
      "CreateWebstoreTemplateFileDto": {
        "required": [
          "file_name",
          "content_type"
        ],
        "type": "object",
        "properties": {
          "file_name": {
            "type": "string",
            "description": "The name of the file within the template, without an extension. The extension follows from\n'content_type'."
          },
          "content_type": {
            "type": "string",
            "description": "The MIME type of the file (e.g., text/html, text/css, application/json). Decides how the file\nis served and whether it is public."
          },
          "content": {
            "type": "string",
            "description": "The text content of the file. Null when files are listed; content is only returned when a\nsingle file is fetched or the template is fetched with 'include' set to 'files'."
          }
        }
      },
      "CreateWebstoreTemplateVariableDto": {
        "required": [
          "name",
          "variable",
          "type",
          "value"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The label shown for the variable in the editor."
          },
          "variable": {
            "type": "string",
            "description": "The name the template's files reference the value by."
          },
          "type": {
            "$ref": "#/components/schemas/WebstoreTemplateVariableTypeDto"
          },
          "value": {
            "type": "string",
            "description": "The value of the variable, always stored as a string and parsed according to 'type' when the\ntemplate renders."
          }
        }
      },
      "CryptoDetailsDto": {
        "required": [
          "confirmations",
          "crypto_amount",
          "crypto_currency",
          "total_paid",
          "transaction_hashes"
        ],
        "type": "object",
        "properties": {
          "crypto_currency": {
            "type": "string",
            "description": "The cryptocurrency used",
            "example": "BTC"
          },
          "crypto_amount": {
            "type": "string",
            "description": "The amount in cryptocurrency",
            "example": "0.00150000"
          },
          "total_paid": {
            "type": "string",
            "description": "The total amount paid in cryptocurrency",
            "example": "0.00150000"
          },
          "confirmations": {
            "type": "integer",
            "description": "The number of blockchain confirmations",
            "format": "int32",
            "example": 6
          },
          "transaction_hashes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "A list of blockchain transactions involving this payment"
          }
        },
        "additionalProperties": false,
        "description": "Cryptocurrency payment method details"
      },
      "CustomVariableDto": {
        "required": [
          "created_at",
          "created_by",
          "description",
          "id",
          "identifier",
          "name",
          "options",
          "store_id",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "identifier": {
            "type": "string",
            "description": "Unique identifier string used to reference this custom variable programmatically.\nMust contain only letters, numbers, underscores, and hyphens."
          },
          "name": {
            "type": "string",
            "description": "Display name for the custom variable shown to customers."
          },
          "description": {
            "type": "string",
            "description": "Description explaining what this custom variable is for. Can be shown to customers."
          },
          "type": {
            "$ref": "#/components/schemas/CustomVariableType"
          },
          "value_regex": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional regex pattern to validate text/number input values.\nOnly applies to text and number types.\nUses RE2 syntax - does not support negative lookarounds, backreferences, or other advanced regex features."
          },
          "options": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CustomVariableOptionDto"
            },
            "description": "Available options for dropdown type custom variables.\nEmpty for text and number types."
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "created_at": {
            "type": "string",
            "description": "When this custom variable was created.",
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "When this custom variable was last updated.\nNull if never updated.",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "CustomVariableLineItemDto": {
        "required": [
          "description",
          "id",
          "identifier",
          "name",
          "price",
          "value"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "identifier": {
            "type": "string",
            "description": "The identifier used to reference this custom variable (e.g., \"color\", \"size\")."
          },
          "name": {
            "type": "string",
            "description": "The display name of the custom variable shown to users."
          },
          "description": {
            "type": "string",
            "description": "A detailed description of what this custom variable represents."
          },
          "price": {
            "type": "integer",
            "description": "The price associated with this custom variable in the smallest currency unit (e.g., cents).",
            "format": "int64"
          },
          "value": {
            "type": "string",
            "description": "The selected value for this custom variable."
          }
        },
        "additionalProperties": false
      },
      "CustomVariableOptionDto": {
        "required": [
          "custom_variable_id",
          "id",
          "is_default",
          "name",
          "price",
          "price_type",
          "sort_order",
          "store_id",
          "value"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "custom_variable_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "name": {
            "type": "string",
            "description": "Display name shown to customers for this option."
          },
          "value": {
            "type": "string",
            "description": "Internal value used for product command variable replacement, without brackets."
          },
          "price": {
            "type": "integer",
            "description": "Price modification when this option is selected.\nInterpretation depends on PriceType (fixed amount or percentage).",
            "format": "int64"
          },
          "price_type": {
            "$ref": "#/components/schemas/CustomVariableOptionPriceType"
          },
          "is_default": {
            "type": "boolean",
            "description": "Whether this option is selected by default when the custom variable is presented.\nOnly one option per custom variable should be marked as default."
          },
          "sort_order": {
            "type": "integer",
            "description": "Sort order for displaying options to customers.\nLower numbers appear first.",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "CustomVariableOptionPriceType": {
        "enum": [
          "fixed",
          "percentage"
        ],
        "type": "string",
        "description": "Defines how option pricing should be applied to the base product price.",
        "x-enumDescriptions": {
          "fixed": "Fixed amount added to or subtracted from the base price.\n            Price value represents the exact amount in the smallest currency unit.",
          "percentage": "Percentage modification of the base price.\n            Price value represents the percentage (e.g., 150 = 1.5% increase)."
        },
        "x-paynow-docs-enum-descriptions": {
          "fixed": "Fixed amount added to or subtracted from the base price.\n            Price value represents the exact amount in the smallest currency unit.",
          "percentage": "Percentage modification of the base price.\n            Price value represents the percentage (e.g., 150 = 1.5% increase)."
        }
      },
      "CustomVariableOptionRequestDto": {
        "required": [
          "is_default",
          "name",
          "price",
          "price_type",
          "value"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "name": {
            "type": "string",
            "description": "Display name shown to customers for this option."
          },
          "value": {
            "type": "string",
            "description": "The value the command variable will be replaced with."
          },
          "price": {
            "type": "integer",
            "description": "Price modification when this option is selected.\nInterpretation depends on PriceType (fixed amount or percentage).\nIf fixed, the value is in cents, if a percentage, in permille.",
            "format": "int64"
          },
          "price_type": {
            "$ref": "#/components/schemas/CustomVariableOptionPriceType"
          },
          "is_default": {
            "type": "boolean",
            "description": "Whether this option is selected by default.\nOnly one option per custom variable should be marked as default."
          }
        },
        "additionalProperties": false,
        "description": "Request model for defining custom variable options.\nUsed within UpsertCustomVariableRequestDto for dropdown-type variables."
      },
      "CustomVariableResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "custom_variable": {
            "$ref": "#/components/schemas/CustomVariableDto"
          }
        },
        "additionalProperties": false
      },
      "CustomVariableType": {
        "enum": [
          "dropdown",
          "text",
          "number"
        ],
        "type": "string",
        "description": "Defines the type of input method for a custom variable.",
        "x-enumDescriptions": {
          "dropdown": "Dropdown selection with predefined options.\n            Customers choose from a list of available options.\n            Allows for additional pricing based on the selected entry.",
          "text": "Free-form text input.\n            Customers can enter any text value (subject to validation).",
          "number": "Numeric input.\n            Customers can enter numeric values (subject to validation)."
        },
        "x-paynow-docs-enum-descriptions": {
          "dropdown": "Dropdown selection with predefined options.\n            Customers choose from a list of available options.\n            Allows for additional pricing based on the selected entry.",
          "text": "Free-form text input.\n            Customers can enter any text value (subject to validation).",
          "number": "Numeric input.\n            Customers can enter numeric values (subject to validation)."
        }
      },
      "CustomerDto": {
        "required": [
          "created_at",
          "id",
          "metadata",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "profile": {
            "$ref": "#/components/schemas/CustomerGenericProfileDto"
          },
          "steam_id": {
            "$ref": "#/components/schemas/SteamId"
          },
          "steam": {
            "$ref": "#/components/schemas/CustomerSteamProfileDto"
          },
          "minecraft_uuid": {
            "type": [
              "null",
              "string"
            ],
            "description": "The customer's Minecraft UUID, if they have linked their Minecraft account.\nNot set for offline Minecraft stores. If the platform type is Minecraft - Geyser,\nand the profile is a bedrock account, this will be a UUID generated from the Xbox XUID.",
            "example": "f84c6a79-0a4e-45e0-879b-cd49ebd4c4e2"
          },
          "minecraft": {
            "$ref": "#/components/schemas/CustomerMinecraftProfileDto"
          },
          "xbox_xuid": {
            "type": [
              "null",
              "string"
            ],
            "description": "The customer's Xbox XUID, if available."
          },
          "minecraft_platform": {
            "$ref": "#/components/schemas/CustomerMinecraftPlatform"
          },
          "name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The display name for the customer.",
            "example": "m0uka"
          },
          "created_at": {
            "type": "string",
            "description": "The date and time when the customer was created in the system.",
            "format": "date-time"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the customer was last updated, if applicable.",
            "format": "date-time"
          },
          "metadata": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Additional custom data associated with the customer."
          }
        },
        "additionalProperties": false,
        "description": "Represents a customer in the PayNow system with their associated profiles and metadata."
      },
      "CustomerGenericProfileDto": {
        "required": [
          "id",
          "name",
          "platform"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The platform-specific identifier for the profile."
          },
          "platform": {
            "type": "string",
            "description": "The name of the platform this profile belongs to.",
            "example": "steam"
          },
          "name": {
            "type": "string",
            "description": "The display name of the user on this platform."
          },
          "avatar_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "The URL to the user's avatar image on this platform."
          }
        },
        "additionalProperties": false,
        "description": "Represents a generic platform profile for a customer."
      },
      "CustomerMinecraftPlatform": {
        "enum": [
          "unknown",
          "java",
          "bedrock"
        ],
        "type": "string"
      },
      "CustomerMinecraftProfileDto": {
        "required": [
          "avatar_url",
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The UUID of the Minecraft player.\nIf the platform is Minecraft Offline, this will be the name itself.\nIf the platform is Minecraft Geyser, and this is a Bedrock account, this ID will be an Xbox XUID.",
            "example": "f84c6a79-0a4e-45e0-879b-cd49ebd4c4e2"
          },
          "name": {
            "type": "string",
            "description": "The username of the Minecraft player.",
            "example": "notch"
          },
          "avatar_url": {
            "type": "string",
            "description": "The URL to the player's Minecraft skin rendered as an avatar."
          }
        },
        "additionalProperties": false,
        "description": "Represents a Minecraft profile for a customer."
      },
      "CustomerPlatformAccountDto": {
        "required": [
          "id",
          "platform"
        ],
        "type": "object",
        "properties": {
          "platform": {
            "$ref": "#/components/schemas/CustomerProfilePlatform"
          },
          "id": {
            "type": "string",
            "description": "The account ID on the platform",
            "example": "76561198152492642"
          }
        },
        "additionalProperties": false,
        "description": "Represents a customer platform association, used for gifting"
      },
      "CustomerPortalSessionDto": {
        "required": [
          "created_at",
          "customer_id",
          "expires_at",
          "id",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "flow": {
            "$ref": "#/components/schemas/CustomerPortalSessionFlowDto"
          },
          "token": {
            "type": [
              "null",
              "string"
            ],
            "description": "The token used to access the portal session"
          },
          "url": {
            "type": [
              "null",
              "string"
            ],
            "description": "The URL to redirect the customer to for this portal session"
          },
          "return_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "URL to redirect the customer back to after completing the portal flow"
          },
          "created_at": {
            "type": "string",
            "description": "Date and time when the portal session was created",
            "format": "date-time"
          },
          "expires_at": {
            "type": "string",
            "description": "Date and time when the portal session expires",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents a customer portal session"
      },
      "CustomerPortalSessionFlowDto": {
        "type": "object",
        "properties": {
          "subscription_cancel": {
            "$ref": "#/components/schemas/SubscriptionCancelFlowDto"
          },
          "subscription_payment_method_update": {
            "$ref": "#/components/schemas/SubscriptionPaymentMethodUpdateFlowDto"
          }
        },
        "additionalProperties": false,
        "description": "The flow a customer portal session is scoped to. At most one of the flows is set."
      },
      "CustomerProfilePlatform": {
        "enum": [
          "invalid",
          "steam",
          "minecraft",
          "paynow_name",
          "paynow",
          "minecraft_java_name",
          "minecraft_bedrock_name",
          "xbox_xuid",
          "minecraft_uuid"
        ],
        "type": "string",
        "x-enumDescriptions": {
          "steam": "Steam profile platform - the ID param must be a Steam ID 64.",
          "minecraft": "Minecraft profile platform - the ID param must be a Minecraft nick.\n            If your store platform is Geyser, this automatically sets the Minecraft platform based on the prefix configured in store settings.",
          "paynow_name": "PayNow name profile platform - the ID param must be a PayNow username.",
          "paynow": "PayNow name profile platform - the ID param must be a PayNow username.",
          "minecraft_java_name": "Minecraft Java Profile Platform - the ID param must be a Java minecraft nick.",
          "minecraft_bedrock_name": "Minecraft Bedrock Profile Platform - the ID param must be a Bedrock minecraft nick.",
          "xbox_xuid": "Minecraft Xbox XUID Profile Platform - the ID param must be an xbox xuid",
          "minecraft_uuid": "Minecraft profile platform - the ID param must be a Minecraft UUID."
        },
        "x-paynow-docs-enum-descriptions": {
          "steam": "Steam profile platform - the ID param must be a Steam ID 64.",
          "minecraft": "Minecraft profile platform - the ID param must be a Minecraft nick.\n            If your store platform is Geyser, this automatically sets the Minecraft platform based on the prefix configured in store settings.",
          "paynow_name": "PayNow name profile platform - the ID param must be a PayNow username.",
          "paynow": "PayNow name profile platform - the ID param must be a PayNow username.",
          "minecraft_java_name": "Minecraft Java Profile Platform - the ID param must be a Java minecraft nick.",
          "minecraft_bedrock_name": "Minecraft Bedrock Profile Platform - the ID param must be a Bedrock minecraft nick.",
          "xbox_xuid": "Minecraft Xbox XUID Profile Platform - the ID param must be an xbox xuid",
          "minecraft_uuid": "Minecraft profile platform - the ID param must be a Minecraft UUID."
        }
      },
      "CustomerResult": {
        "required": [
          "customer",
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer": {
            "$ref": "#/components/schemas/CustomerDto"
          }
        },
        "additionalProperties": false
      },
      "CustomerSortFieldDto_V2": {
        "enum": [
          "unspecified",
          "total_spend_gross",
          "total_spend_net",
          "average_spend_gross",
          "average_spend_net",
          "total_active_subscriptions",
          "total_monthly_recurring_revenue",
          "total_payments",
          "total_chargebacks",
          "total_refunds"
        ],
        "type": "string"
      },
      "CustomerSpendTimeRangeDto": {
        "required": [
          "average_spend_amount_gross",
          "average_spend_amount_net",
          "customer_id",
          "from",
          "to",
          "total_payments",
          "total_spend_amount_gross",
          "total_spend_amount_net"
        ],
        "type": "object",
        "properties": {
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "from": {
            "type": "string",
            "format": "date-time"
          },
          "to": {
            "type": "string",
            "format": "date-time"
          },
          "total_spend_amount_gross": {
            "type": "integer",
            "format": "int64"
          },
          "total_spend_amount_net": {
            "type": "integer",
            "format": "int64"
          },
          "average_spend_amount_gross": {
            "type": "integer",
            "format": "int64"
          },
          "average_spend_amount_net": {
            "type": "integer",
            "format": "int64"
          },
          "total_payments": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "CustomerStatsDto": {
        "required": [
          "average_spend_amount_gross",
          "average_spend_amount_net",
          "customer_id",
          "total_active_subscriptions",
          "total_chargebacks",
          "total_monthly_recurring_revenue",
          "total_payments",
          "total_refunds",
          "total_spend_amount_gross",
          "total_spend_amount_net"
        ],
        "type": "object",
        "properties": {
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "total_spend_amount_gross": {
            "type": "integer",
            "format": "int64"
          },
          "total_spend_amount_net": {
            "type": "integer",
            "format": "int64"
          },
          "average_spend_amount_gross": {
            "type": "integer",
            "format": "int64"
          },
          "average_spend_amount_net": {
            "type": "integer",
            "format": "int64"
          },
          "total_active_subscriptions": {
            "type": "integer",
            "format": "int32"
          },
          "total_monthly_recurring_revenue": {
            "type": "integer",
            "format": "int64"
          },
          "total_payments": {
            "type": "integer",
            "format": "int32"
          },
          "total_chargebacks": {
            "type": "integer",
            "format": "int32"
          },
          "total_refunds": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "CustomerStatsDto_V2": {
        "required": [
          "average_spend_gross",
          "average_spend_net",
          "customer_id",
          "total_active_subscriptions",
          "total_chargebacks",
          "total_monthly_recurring_revenue",
          "total_payments",
          "total_refunds",
          "total_spend_gross",
          "total_spend_net"
        ],
        "type": "object",
        "properties": {
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "total_spend_gross": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "total_spend_net": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "average_spend_gross": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "average_spend_net": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "total_active_subscriptions": {
            "type": "integer",
            "format": "int32"
          },
          "total_monthly_recurring_revenue": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "total_payments": {
            "type": "integer",
            "format": "int32"
          },
          "total_chargebacks": {
            "type": "integer",
            "format": "int32"
          },
          "total_refunds": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "CustomerStatsForRangeDto_V2": {
        "required": [
          "average_spend_gross",
          "average_spend_net",
          "customer_id",
          "total_payments",
          "total_spend_gross",
          "total_spend_net"
        ],
        "type": "object",
        "properties": {
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "total_spend_gross": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "total_spend_net": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "average_spend_gross": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "average_spend_net": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "total_payments": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "CustomerSteamProfileDto": {
        "required": [
          "avatar_url",
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/SteamId"
          },
          "name": {
            "type": "string",
            "description": "The display name of the user on Steam."
          },
          "avatar_url": {
            "type": "string",
            "description": "The URL to the user's Steam avatar image."
          }
        },
        "additionalProperties": false,
        "description": "Represents a Steam profile for a customer."
      },
      "CustomerTokenResponseDto": {
        "required": [
          "token"
        ],
        "type": "object",
        "properties": {
          "token": {
            "type": "string",
            "description": "The generated Customer token."
          }
        },
        "additionalProperties": false
      },
      "CustomersSummaryForRangeDto_V2": {
        "required": [
          "new_customer_count",
          "returning_customer_count",
          "returning_customer_count_excluding_renewals"
        ],
        "type": "object",
        "properties": {
          "new_customer_count": {
            "type": "integer",
            "format": "int64"
          },
          "returning_customer_count": {
            "type": "integer",
            "format": "int64"
          },
          "returning_customer_count_excluding_renewals": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "DashboardSearchHintDto": {
        "required": [
          "description",
          "example",
          "prefix"
        ],
        "type": "object",
        "properties": {
          "prefix": {
            "type": "string"
          },
          "example": {
            "type": "string"
          },
          "description": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "DashboardSearchResultTypeDto": {
        "enum": [
          "unknown",
          "orders",
          "trials",
          "subscriptions",
          "customers",
          "coupons",
          "gameservers",
          "products",
          "sales",
          "api_keys",
          "bans",
          "affiliate_links",
          "tags",
          "giftcards",
          "stores",
          "users",
          "tickets",
          "tier_groups",
          "custom_variables",
          "global_commands",
          "webhooks",
          "email_templates",
          "email_deliveries",
          "webhook_deliveries",
          "payouts"
        ],
        "type": "string"
      },
      "DashboardStatsDto": {
        "required": [
          "average_spend_amount",
          "average_spend_amount_prev",
          "lifetime_sales",
          "lifetime_sales_count",
          "month_sales",
          "month_sales_prev",
          "sales_today",
          "sales_yesterday",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "sales_today": {
            "type": "integer",
            "format": "int64"
          },
          "sales_yesterday": {
            "type": "integer",
            "format": "int64"
          },
          "month_sales": {
            "type": "integer",
            "format": "int64"
          },
          "month_sales_prev": {
            "type": "integer",
            "format": "int64"
          },
          "average_spend_amount": {
            "type": "number",
            "format": "double"
          },
          "average_spend_amount_prev": {
            "type": "number",
            "format": "double"
          },
          "lifetime_sales": {
            "type": "integer",
            "format": "int64"
          },
          "lifetime_sales_count": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "DataMigrationTaskDto": {
        "required": [
          "id",
          "platform",
          "started_at",
          "started_by",
          "store_id",
          "token",
          "total_entities_migrated"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "platform": {
            "type": "string",
            "description": "Platform from which data is being migrated (e.g., \"tebex\")."
          },
          "token": {
            "type": "string",
            "description": "Masked authentication token used for accessing the source platform API."
          },
          "error": {
            "type": [
              "null",
              "string"
            ],
            "description": "Error message if the migration encountered any errors, otherwise null."
          },
          "started_at": {
            "type": "string",
            "description": "Timestamp when the migration was initiated.",
            "format": "date-time"
          },
          "failed_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Timestamp when the migration failed, or null if it didn't fail.",
            "format": "date-time"
          },
          "completed_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Timestamp when the migration was successfully completed, or null if not completed.",
            "format": "date-time"
          },
          "total_entities_to_migrate": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Total number of entities that need to be migrated, or null if unknown.",
            "format": "int64"
          },
          "total_entities_migrated": {
            "type": "integer",
            "description": "Number of entities that have been successfully migrated.",
            "format": "int32"
          },
          "started_by": {
            "$ref": "#/components/schemas/ActorDto"
          }
        },
        "additionalProperties": false
      },
      "DayOfWeekDto": {
        "enum": [
          "unspecified",
          "monday",
          "tuesday",
          "wednesday",
          "thursday",
          "friday",
          "saturday",
          "sunday"
        ],
        "type": "string"
      },
      "DayOrderStatsDto": {
        "required": [
          "day",
          "total",
          "total_orders"
        ],
        "type": "object",
        "properties": {
          "day": {
            "type": "string",
            "format": "date-time"
          },
          "total": {
            "type": "integer",
            "format": "int64"
          },
          "total_orders": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "DeactivateEmailTemplateRequestDto": {
        "required": [
          "email_template_type"
        ],
        "type": "object",
        "properties": {
          "email_template_type": {
            "$ref": "#/components/schemas/EmailTemplateTypeDto"
          }
        },
        "additionalProperties": false
      },
      "DeliveryItemAssignmentBulkDto": {
        "required": [
          "customer_id"
        ],
        "type": "object",
        "properties": {
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "execute_on_gameserver_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "quantity": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Quantity of products to assign.",
            "format": "int32"
          },
          "override_expires_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Override expiry date for the delivery item.",
            "format": "date-time"
          },
          "skip_commands": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Skip command execution when assigning the item."
          },
          "custom_variables": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "type": "string"
            },
            "description": "Custom variables for the assignment."
          }
        },
        "additionalProperties": false
      },
      "DeliveryItemAssignmentDto": {
        "type": "object",
        "properties": {
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "execute_on_gameserver_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "quantity": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Quantity of products to assign.",
            "format": "int32"
          },
          "override_expires_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Override expiry date for the delivery item.",
            "format": "date-time"
          },
          "skip_commands": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Skip command execution when assigning the item."
          },
          "custom_variables": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "type": "string"
            },
            "description": "Custom variables for the assignment."
          }
        },
        "additionalProperties": false
      },
      "DeliveryItemDto": {
        "required": [
          "added_at",
          "command_attempts",
          "custom_variables",
          "customer",
          "customer_id",
          "expirable",
          "gift",
          "id",
          "product",
          "skip_commands",
          "state",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer": {
            "$ref": "#/components/schemas/CustomerDto"
          },
          "order_customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "order_customer": {
            "$ref": "#/components/schemas/CustomerDto"
          },
          "checkout_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "checkout_line_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "order_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "order_line_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "subscription_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "trial_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "execute_on_gameserver_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "quantity_index": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The index of the item when multiple quantities were assigned",
            "format": "int32"
          },
          "product": {
            "$ref": "#/components/schemas/DeliveryItemProductDto"
          },
          "state": {
            "$ref": "#/components/schemas/DeliveryItemStateDto"
          },
          "added_at": {
            "type": "string",
            "description": "The date and time when the item was added",
            "format": "date-time"
          },
          "added_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "active_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the item became active",
            "format": "date-time"
          },
          "expirable": {
            "type": "boolean",
            "description": "Indicates whether the delivery item can expire"
          },
          "expires_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the item expires naturally",
            "format": "date-time"
          },
          "override_expires_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The override expiry date for the delivery item",
            "format": "date-time"
          },
          "removed_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the item was removed",
            "format": "date-time"
          },
          "revoked_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the item was revoked",
            "format": "date-time"
          },
          "revoke_reason": {
            "type": [
              "null",
              "string"
            ],
            "description": "The reason for revoking the delivery item"
          },
          "revoked_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "command_attempts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CommandAttemptDto"
            },
            "description": "The command execution attempts for this delivery item"
          },
          "skip_commands": {
            "type": "boolean",
            "description": "Indicates whether command execution should be skipped for this item"
          },
          "custom_variables": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Custom variables associated with the delivery item"
          },
          "gift": {
            "type": "boolean",
            "description": "Indicates whether the item was given as a gift"
          }
        },
        "additionalProperties": false,
        "description": "Represents a delivery item assigned to a customer"
      },
      "DeliveryItemProductDto": {
        "required": [
          "id",
          "name",
          "slug",
          "version_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "name": {
            "type": "string",
            "description": "The name of the product",
            "example": "Premium Membership"
          },
          "slug": {
            "type": "string",
            "description": "The URL-friendly slug of the product",
            "example": "premium-membership"
          },
          "version_id": {
            "type": "string",
            "description": "The version identifier of the product",
            "example": "v2.1.0"
          }
        },
        "additionalProperties": false,
        "description": "Represents the product information for a delivery item"
      },
      "DeliveryItemStateDto": {
        "enum": [
          "usable",
          "active",
          "used",
          "revoked",
          "renewed"
        ],
        "type": "string"
      },
      "DimensionStatsEntryDto_V2": {
        "required": [
          "count",
          "dimension_id"
        ],
        "type": "object",
        "properties": {
          "dimension_id": {
            "type": "string"
          },
          "count": {
            "type": "integer",
            "format": "int64"
          },
          "earnings": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          }
        },
        "additionalProperties": false
      },
      "DiscordActionDto": {
        "required": [
          "action_type",
          "discord_server_id",
          "execution_stage",
          "id",
          "product_id",
          "product_version_id",
          "revocation_stages",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "discord_server_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "execution_stage": {
            "$ref": "#/components/schemas/DiscordActionExecutionStage"
          },
          "revocation_stages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DiscordActionRevocationStage"
            }
          },
          "action_type": {
            "$ref": "#/components/schemas/DiscordActionType"
          },
          "channel_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "role_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "message": {
            "type": [
              "null",
              "string"
            ]
          }
        },
        "additionalProperties": false
      },
      "DiscordActionExecutionStage": {
        "enum": [
          "on_purchase",
          "on_expire",
          "on_refund",
          "on_chargeback"
        ],
        "type": "string"
      },
      "DiscordActionRevocationStage": {
        "enum": [
          "on_expire",
          "on_refund",
          "on_chargeback"
        ],
        "type": "string"
      },
      "DiscordActionType": {
        "enum": [
          "persist_role",
          "send_message",
          "ban_user",
          "kick_user",
          "generate_invite_link"
        ],
        "type": "string"
      },
      "DiscordProfileDto": {
        "required": [
          "avatar_hash",
          "discord_id",
          "username"
        ],
        "type": "object",
        "properties": {
          "discord_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "username": {
            "type": "string"
          },
          "avatar_hash": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "DiscordServerChannelDto": {
        "required": [
          "category",
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "DiscordServerLinkDto": {
        "required": [
          "created_at",
          "store_id",
          "token"
        ],
        "type": "object",
        "properties": {
          "token": {
            "type": "string"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "server_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "server_name": {
            "type": [
              "null",
              "string"
            ]
          },
          "server_icon_url": {
            "type": [
              "null",
              "string"
            ]
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "linked_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "DiscordServerRoleDto": {
        "required": [
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "name": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "DistributionEntryDto_V2": {
        "required": [
          "current",
          "key"
        ],
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "current": {
            "$ref": "#/components/schemas/DistributionTotalsDto_V2"
          },
          "comparison": {
            "$ref": "#/components/schemas/DistributionTotalsDto_V2"
          }
        },
        "additionalProperties": false
      },
      "DistributionTotalsDto_V2": {
        "required": [
          "count"
        ],
        "type": "object",
        "properties": {
          "count": {
            "type": "integer",
            "format": "int64"
          },
          "earnings": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          }
        },
        "additionalProperties": false
      },
      "DocsSearchHitDto": {
        "required": [
          "heading",
          "snippet",
          "title",
          "url"
        ],
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "description": "The title of the page the section belongs to."
          },
          "heading": {
            "type": "string",
            "description": "The heading of the matching section within the page."
          },
          "url": {
            "type": "string",
            "description": "The full URL of the section on docs.paynow.gg, including the heading anchor."
          },
          "snippet": {
            "type": "string",
            "description": "A short excerpt of the section text around the matching terms."
          }
        },
        "additionalProperties": false,
        "description": "Represents one matching section of a documentation page."
      },
      "DownloadUrlResponseDto": {
        "required": [
          "download_url"
        ],
        "type": "object",
        "properties": {
          "download_url": {
            "type": "string",
            "description": "Temporary URL the file can be downloaded from"
          }
        },
        "additionalProperties": false
      },
      "EmailBrandingDto": {
        "required": [
          "color",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "color": {
            "type": "string"
          },
          "header_image_light_url": {
            "type": [
              "null",
              "string"
            ]
          },
          "header_image_dark_url": {
            "type": [
              "null",
              "string"
            ]
          },
          "header_image_light_media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "header_image_dark_media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false
      },
      "EmailDeliveryDto": {
        "required": [
          "created_at",
          "email_template_type",
          "id",
          "receiver_email",
          "status",
          "subject"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "receiver_email": {
            "type": "string"
          },
          "subject": {
            "type": "string"
          },
          "email_template_type": {
            "$ref": "#/components/schemas/EmailTemplateTypeDto"
          },
          "status": {
            "$ref": "#/components/schemas/EmailDeliveryStatusDto"
          },
          "message_id": {
            "type": [
              "null",
              "string"
            ]
          },
          "error_message": {
            "type": [
              "null",
              "string"
            ]
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "sent_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "opened_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "EmailDeliveryResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "email_delivery": {
            "$ref": "#/components/schemas/EmailDeliveryDto"
          }
        },
        "additionalProperties": false
      },
      "EmailDeliveryStatusDto": {
        "enum": [
          "unspecified",
          "pending",
          "sent",
          "delivered",
          "deferred",
          "bounced",
          "dropped",
          "failed"
        ],
        "type": "string"
      },
      "EmailTemplateComponentDto": {
        "required": [
          "content",
          "tag"
        ],
        "type": "object",
        "properties": {
          "tag": {
            "type": "string"
          },
          "content": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "EmailTemplateDefinitionDto": {
        "required": [
          "components",
          "default_content",
          "display_name",
          "email_template_type",
          "example_variables"
        ],
        "type": "object",
        "properties": {
          "email_template_type": {
            "$ref": "#/components/schemas/EmailTemplateTypeDto"
          },
          "display_name": {
            "type": "string"
          },
          "components": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EmailTemplateComponentDto"
            }
          },
          "example_variables": {
            "type": "null"
          },
          "default_content": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "EmailTemplateDto": {
        "required": [
          "content",
          "created_at",
          "created_by",
          "email_template_state",
          "email_template_state_note",
          "email_template_type",
          "id",
          "name",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "email_template_type": {
            "$ref": "#/components/schemas/EmailTemplateTypeDto"
          },
          "name": {
            "type": "string"
          },
          "content": {
            "type": "string"
          },
          "email_template_state": {
            "$ref": "#/components/schemas/EmailTemplateStateDto"
          },
          "email_template_state_note": {
            "type": "string"
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "EmailTemplateResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "email_template": {
            "$ref": "#/components/schemas/EmailTemplateDto"
          }
        },
        "additionalProperties": false
      },
      "EmailTemplateStateDto": {
        "enum": [
          "unspecified",
          "inactive",
          "activating",
          "active"
        ],
        "type": "string"
      },
      "EmailTemplateTypeDto": {
        "enum": [
          "unspecified",
          "layout",
          "password_reset",
          "email_verification",
          "email_change",
          "email_changed_notification",
          "forgot_password",
          "logged_in_new_location",
          "welcome_login",
          "order_completed",
          "refund_initiated",
          "subscription_canceled",
          "subscription_renewal_failed",
          "subscription_price_changed",
          "subscription_change_verification_code",
          "subscription_renewal_upcoming",
          "subscription_manage_login",
          "subscription_manage_no_history",
          "payout_created",
          "payout_completed",
          "store_invite",
          "store_lock_changed",
          "abandoned_checkout_recovery_attempt",
          "purchase_follow_up_attempt",
          "downloadable_file_granted",
          "discord_invite_link",
          "gift_card_created",
          "trial_ending_soon",
          "invoice_generated",
          "payment_method_type_approval",
          "store_trust_event",
          "data_subject_request_export_completed",
          "fast_checkout_deletion",
          "fast_checkout_payment_method_created",
          "fast_checkout_owner_device_verified"
        ],
        "type": "string"
      },
      "EpsDetailsDto": {
        "type": "object",
        "properties": {
          "bank": {
            "type": [
              "null",
              "string"
            ],
            "description": "The bank of the customer",
            "example": "erste_bank_und_sparkassen"
          },
          "payer_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The verified name of the account owner",
            "example": "John Doe"
          }
        },
        "additionalProperties": false,
        "description": "EPS payment method details"
      },
      "ExecutedWebhookDto": {
        "required": [
          "id",
          "started_at",
          "status_code"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "started_at": {
            "type": "string",
            "format": "date-time"
          },
          "finished_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "status_code": {
            "type": "integer",
            "format": "int32"
          },
          "response": {
            "type": [
              "null",
              "string"
            ]
          }
        },
        "additionalProperties": false
      },
      "FinishWebstoreTemplateUploadResponseDto": {
        "required": [
          "failed_files"
        ],
        "type": "object",
        "properties": {
          "failed_files": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The names of the files in the archive that could not be imported. Empty when every file was\nimported."
          }
        },
        "additionalProperties": false,
        "description": "Represents the result of importing an uploaded template archive into a template."
      },
      "FlakeId": {
        "type": "string",
        "additionalProperties": false,
        "format": "flake-id",
        "example": "411486491630370816"
      },
      "GameServerConsoleConnectionStatusDto": {
        "enum": [
          "unknown",
          "disconnected",
          "connecting",
          "connected",
          "backoff"
        ],
        "type": "string",
        "description": "Specifies the state of PayNow's connection to a game server's console.",
        "x-enumDescriptions": {
          "unknown": "The connection state is not known. This value is typically used as a default or uninitialized state.",
          "disconnected": "No connection is open to the console.",
          "connecting": "A runner is in the middle of establishing the connection.",
          "connected": "The connection is open and commands can be run.",
          "backoff": "The last connection attempt failed and the runner is waiting before trying again."
        },
        "x-paynow-docs-enum-descriptions": {
          "unknown": "The connection state is not known. This value is typically used as a default or uninitialized state.",
          "disconnected": "No connection is open to the console.",
          "connecting": "A runner is in the middle of establishing the connection.",
          "connected": "The connection is open and commands can be run.",
          "backoff": "The last connection attempt failed and the runner is waiting before trying again."
        }
      },
      "GameServerConsoleDto": {
        "required": [
          "assigned_runner_id",
          "connection_status",
          "created_at",
          "created_by",
          "enabled",
          "game_server_id",
          "host",
          "port",
          "secure",
          "store_id",
          "type"
        ],
        "type": "object",
        "properties": {
          "game_server_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "type": {
            "$ref": "#/components/schemas/GameServerConsoleTypeDto"
          },
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether PayNow keeps the connection to the console open."
          },
          "assigned_runner_id": {
            "type": "string",
            "description": "The identifier of the PayNow runner currently holding the connection, or empty when none has\nbeen assigned."
          },
          "connection_status": {
            "$ref": "#/components/schemas/GameServerConsoleConnectionStatusDto"
          },
          "last_heartbeat_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time the runner last reported the connection alive, or null when it has never\nconnected.",
            "format": "date-time"
          },
          "host": {
            "type": "string",
            "description": "The hostname or IP address the game server's console listens on."
          },
          "port": {
            "type": "integer",
            "description": "The port the game server's console listens on.",
            "format": "int32"
          },
          "password": {
            "type": [
              "null",
              "string"
            ],
            "description": "The password used to authenticate with the console, or null when it requires none."
          },
          "secure": {
            "type": "boolean",
            "description": "Indicates whether the connection is made over TLS."
          },
          "created_at": {
            "type": "string",
            "description": "The date and time the console was created.",
            "format": "date-time"
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time the console was last updated, or null when it has never been updated.",
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          }
        },
        "additionalProperties": false,
        "description": "Represents the remote console connection PayNow keeps open to a game server, used to run\ndelivery commands in game and to read the server's console output."
      },
      "GameServerConsoleMessageDto": {
        "required": [
          "message",
          "time",
          "type"
        ],
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/GameServerConsoleMessageTypeDto"
          },
          "message": {
            "type": "string"
          },
          "time": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "GameServerConsoleMessageTypeDto": {
        "enum": [
          "unknown",
          "output",
          "command",
          "response",
          "system"
        ],
        "type": "string"
      },
      "GameServerConsoleTypeDto": {
        "enum": [
          "unknown",
          "rust"
        ],
        "type": "string",
        "description": "Specifies the console protocol a game server speaks.",
        "x-enumDescriptions": {
          "unknown": "No console type specified. This value is typically used as a default or uninitialized state.",
          "rust": "The WebSocket RCON console of a Rust server."
        },
        "x-paynow-docs-enum-descriptions": {
          "unknown": "No console type specified. This value is typically used as a default or uninitialized state.",
          "rust": "The WebSocket RCON console of a Rust server."
        }
      },
      "GameServerDto": {
        "required": [
          "created_at",
          "created_by",
          "enabled",
          "id",
          "linked_to",
          "name",
          "store_id",
          "updated_by"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "name": {
            "type": "string",
            "description": "The display name of the game server."
          },
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the game server is currently enabled."
          },
          "token": {
            "type": [
              "null",
              "string"
            ],
            "description": "The authentication token used by the game server to access the PayNow API."
          },
          "token_reset_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the authentication token was last reset, if applicable.",
            "format": "date-time"
          },
          "linked_to": {
            "$ref": "#/components/schemas/GameServerLinkDto"
          },
          "created_at": {
            "type": "string",
            "description": "The date and time when the game server was created in the system.",
            "format": "date-time"
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the game server was last updated, if applicable.",
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          }
        },
        "additionalProperties": false,
        "description": "Represents a game server in the PayNow system with authentication tokens and linking information."
      },
      "GameServerLinkDto": {
        "required": [
          "hostname",
          "ip",
          "platform",
          "saved_at",
          "version"
        ],
        "type": "object",
        "properties": {
          "ip": {
            "type": "string"
          },
          "hostname": {
            "type": "string"
          },
          "platform": {
            "type": "string"
          },
          "version": {
            "type": "string"
          },
          "saved_at": {
            "type": "string",
            "format": "date-time"
          },
          "last_fetched_commands_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "last_fetched_commands_from_ip": {
            "type": [
              "null",
              "string"
            ]
          }
        },
        "additionalProperties": false
      },
      "GameserverResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "gameserver": {
            "$ref": "#/components/schemas/GameServerDto"
          }
        },
        "additionalProperties": false
      },
      "GetDimensionStatsResponseDto_V2": {
        "required": [
          "dimension_type",
          "entries",
          "revenue_basis"
        ],
        "type": "object",
        "properties": {
          "dimension_type": {
            "$ref": "#/components/schemas/StatsDimensionTypeDto_V2"
          },
          "revenue_basis": {
            "$ref": "#/components/schemas/RevenueBasisDto_V2"
          },
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DimensionStatsEntryDto_V2"
            }
          }
        },
        "additionalProperties": false
      },
      "GetDistributionResponseDto_V2": {
        "required": [
          "distribution_type",
          "entries",
          "revenue_basis"
        ],
        "type": "object",
        "properties": {
          "distribution_type": {
            "$ref": "#/components/schemas/StatsDistributionTypeDto_V2"
          },
          "revenue_basis": {
            "$ref": "#/components/schemas/RevenueBasisDto_V2"
          },
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DistributionEntryDto_V2"
            }
          }
        },
        "additionalProperties": false
      },
      "GetMatrixResponseDto_V2": {
        "required": [
          "columns",
          "matrix_type",
          "revenue_basis",
          "rows"
        ],
        "type": "object",
        "properties": {
          "matrix_type": {
            "$ref": "#/components/schemas/MatrixTypeDto_V2"
          },
          "revenue_basis": {
            "$ref": "#/components/schemas/RevenueBasisDto_V2"
          },
          "unit": {
            "$ref": "#/components/schemas/TimeSeriesUnitDto_V2"
          },
          "columns": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MatrixHeaderDto_V2"
            }
          },
          "rows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MatrixRowDto_V2"
            }
          }
        },
        "additionalProperties": false
      },
      "GetWebstoreTemplateArchiveResponseDto": {
        "required": [
          "download_url"
        ],
        "type": "object",
        "properties": {
          "download_url": {
            "type": "string",
            "description": "The temporary URL the archive can be downloaded from."
          }
        },
        "additionalProperties": false,
        "description": "Represents a link to download a template's files as an archive."
      },
      "GetWebstoreTemplatePreviewUrlResponseDto": {
        "required": [
          "expires_at",
          "slug",
          "url"
        ],
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "description": "The preview slug the link is keyed by."
          },
          "url": {
            "type": "string",
            "description": "The URL to open the preview at."
          },
          "expires_at": {
            "type": "string",
            "description": "The date and time the link stops working.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents a short-lived link that renders a template preview without caching."
      },
      "GetWebstoreTemplateUploadUrlResponseDto": {
        "required": [
          "upload_url"
        ],
        "type": "object",
        "properties": {
          "upload_url": {
            "type": "string",
            "description": "The URL to upload the archive to with an HTTP PUT. Once the upload completes, finish it through\nthe upload finish endpoint to import the files into the template."
          }
        },
        "additionalProperties": false,
        "description": "Represents a pre-signed URL for uploading a template archive."
      },
      "GiftCardDto": {
        "required": [
          "balance",
          "code",
          "enabled",
          "id",
          "starting_balance",
          "store_id",
          "usable_at"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the gift card is currently enabled and can be used."
          },
          "code": {
            "type": "string",
            "description": "The unique code that customers use to redeem the gift card.",
            "example": "GIFT-2024-ABCD1234"
          },
          "note": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional note or description associated with the gift card."
          },
          "balance": {
            "type": "integer",
            "description": "The current balance remaining on the gift card in cents.",
            "format": "int64",
            "example": 2500
          },
          "starting_balance": {
            "type": "integer",
            "description": "The original balance when the gift card was first created in cents.",
            "format": "int64",
            "example": 5000
          },
          "usable_by_customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "usable_at": {
            "type": "string",
            "description": "The date and time when the gift card becomes usable.",
            "format": "date-time"
          },
          "expires_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the gift card expires, if applicable.",
            "format": "date-time"
          },
          "created_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the gift card was created.",
            "format": "date-time"
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the gift card was last updated, if applicable.",
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "canceled_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the gift card was canceled, if applicable.",
            "format": "date-time"
          },
          "canceled_by": {
            "$ref": "#/components/schemas/ActorDto"
          }
        },
        "additionalProperties": false,
        "description": "Represents a gift card in the PayNow system."
      },
      "GiftcardResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "giftcard": {
            "$ref": "#/components/schemas/GiftCardDto"
          }
        },
        "additionalProperties": false
      },
      "GlobalCommandDto": {
        "required": [
          "content",
          "created_at",
          "created_by",
          "execution_rule",
          "id",
          "online_only",
          "override_execute_on_gameserver_ids",
          "stage",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "stage": {
            "$ref": "#/components/schemas/ProductCommandStage"
          },
          "content": {
            "type": "string",
            "description": "The actual command content to be executed."
          },
          "online_only": {
            "type": "boolean",
            "description": "Indicates whether the command should only be executed when the player is online."
          },
          "override_execute_on_gameserver_ids": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "List of specific game server IDs where this command should be executed, overriding default behavior."
          },
          "execution_rule": {
            "$ref": "#/components/schemas/ProductCommandExecutionRuleDto"
          },
          "created_at": {
            "type": "string",
            "description": "Timestamp when the command was created.",
            "format": "date-time"
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional timestamp indicating when the command was last updated.\nNull if the command has never been updated.",
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          }
        },
        "additionalProperties": false,
        "description": "Represents a global command in the system.\nGlobal commands are instructions that can be executed across a store's environment."
      },
      "GlobalCommandResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "global_command": {
            "$ref": "#/components/schemas/GlobalCommandDto"
          }
        },
        "additionalProperties": false
      },
      "IdealDetailsDto": {
        "required": [
          "bank",
          "bic"
        ],
        "type": "object",
        "properties": {
          "bank": {
            "type": "string",
            "description": "The bank identifier",
            "example": "abn_amro"
          },
          "bic": {
            "type": "string",
            "description": "The Bank Identifier Code",
            "example": "ABNANL2A"
          },
          "iban_last4": {
            "type": [
              "null",
              "string"
            ],
            "description": "The last 4 digits of the IBAN",
            "example": 1234
          },
          "payer_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The payer name",
            "example": "John Doe"
          }
        },
        "additionalProperties": false,
        "description": "iDEAL payment method details"
      },
      "InlineProductCreateDto": {
        "type": "object",
        "properties": {
          "slug": {
            "type": [
              "null",
              "string"
            ],
            "description": "The unique URL-safe identifier (slug) for the product."
          },
          "name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The display name of the product."
          },
          "description": {
            "type": [
              "null",
              "string"
            ],
            "description": "The detailed description of the product."
          },
          "label": {
            "type": [
              "null",
              "string"
            ],
            "description": "The display label for the product."
          },
          "price": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The price of the product in the lowest denominator (e.g. cents).",
            "format": "int64"
          },
          "single_game_server_only": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether the customer is prompted to select a game server before purchasing."
          },
          "allow_one_time_purchase": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether one-time purchases are allowed."
          },
          "allow_subscription": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether subscription purchases are allowed."
          },
          "subscription_interval_value": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The subscription interval value.",
            "format": "int32"
          },
          "subscription_interval_scale": {
            "$ref": "#/components/schemas/ProductSubscriptionIntervalScale"
          },
          "trial": {
            "$ref": "#/components/schemas/UpsertProductTrialConfigurationDto"
          },
          "upselling": {
            "$ref": "#/components/schemas/UpsertProductUpsellConfigurationDto"
          },
          "remove_after_enabled": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether automatic removal is enabled."
          },
          "remove_after_time_value": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The time value for automatic removal.",
            "format": "int32"
          },
          "remove_after_time_scale": {
            "$ref": "#/components/schemas/ProductRemoveAfterIntervalScale"
          },
          "store_stock_limit": {
            "$ref": "#/components/schemas/ProductStockLimitDto"
          },
          "customer_stock_limit": {
            "$ref": "#/components/schemas/ProductStockLimitDto"
          },
          "stock_limit_do_not_include_removed": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether removed items should be excluded from stock limits."
          },
          "tags": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "The tag IDs associated with the product."
          },
          "gameservers": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "The gameserver IDs associated with the product."
          },
          "commands": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/ProductCommandDto"
            },
            "description": "The commands to be executed at different stages."
          },
          "deliverable_actions": {
            "$ref": "#/components/schemas/ProductDeliverableActionsDto"
          },
          "metadata": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "type": "string"
            },
            "description": "Additional metadata for the product."
          },
          "payout_splits": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/ProductPayoutSplitDto"
            },
            "description": "The payout splits for revenue distribution.\nRequires special approval."
          },
          "tax_code": {
            "$ref": "#/components/schemas/ProductTaxCode"
          },
          "allow_concurrent_active_items": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether concurrent active items are allowed."
          },
          "is_hidden": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether the product is hidden."
          },
          "is_gifting_disabled": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether gifting is disabled."
          },
          "enabled_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the product becomes enabled.\nSet to `null` to keep enabled.",
            "format": "date-time"
          },
          "enabled_until": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time until which the product remains enabled.\nSet to `null` to keep enabled.",
            "format": "date-time"
          },
          "required_product_ids": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "The IDs of products required for purchasing this product."
          },
          "required_product_all": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether all required products are needed."
          },
          "custom_variable_ids": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "The IDs of associated custom variables."
          },
          "media_asset_ids": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "The IDs of the media assets to show as the product's images, in display order."
          },
          "is_gift_cards_disabled": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates if applying gift cards should be disabled on the product."
          },
          "is_coupons_disabled": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates if applying coupons should be disabled on the product."
          },
          "is_affiliate_links_disabled": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates if applying affiliate links should be disabled on the product."
          },
          "tier_group_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false,
        "description": "Optional inline product definition for dynamic products.\nRequires special approval, use `product_id` instead."
      },
      "InstallMarketplaceTemplateResponseDto": {
        "required": [
          "installed_template_id"
        ],
        "type": "object",
        "properties": {
          "installed_template_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false,
        "description": "Represents the result of installing a marketplace template into a store's webstore."
      },
      "IntervalGameServerStatsDto": {
        "required": [
          "gameserver_id",
          "store_id",
          "sum_quantity",
          "total_earnings",
          "total_lines"
        ],
        "type": "object",
        "properties": {
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "gameserver_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "total_lines": {
            "type": "integer",
            "format": "int64"
          },
          "sum_quantity": {
            "type": "integer",
            "format": "int64"
          },
          "total_earnings": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "IntervalProductStatsDto": {
        "required": [
          "product_id",
          "store_id",
          "sum_quantity",
          "total_earnings",
          "total_lines"
        ],
        "type": "object",
        "properties": {
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "total_lines": {
            "type": "integer",
            "format": "int64"
          },
          "sum_quantity": {
            "type": "integer",
            "format": "int64"
          },
          "total_earnings": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "IntervalTagStatsDto": {
        "required": [
          "store_id",
          "sum_quantity",
          "tag_id",
          "total_earnings",
          "total_lines"
        ],
        "type": "object",
        "properties": {
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "tag_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "total_lines": {
            "type": "integer",
            "format": "int64"
          },
          "sum_quantity": {
            "type": "integer",
            "format": "int64"
          },
          "total_earnings": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "InviteDto": {
        "required": [
          "created_at",
          "created_by",
          "id",
          "role_id",
          "store_id",
          "token",
          "user_email"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "token": {
            "type": "string",
            "description": "The token the invited user redeems to accept the invite."
          },
          "role_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "user_email": {
            "type": "string",
            "description": "The email address the invite was sent to."
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "created_at": {
            "type": "string",
            "description": "When the invite was created.",
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "When the invite was last updated.",
            "format": "date-time"
          },
          "accepted_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "When the invite was accepted. Unset while the invite is still pending.",
            "format": "date-time"
          },
          "accepted_by_user": {
            "$ref": "#/components/schemas/ActorDto"
          }
        },
        "additionalProperties": false
      },
      "InvoiceDto": {
        "required": [
          "created_at",
          "currency",
          "customer_id",
          "discount_amount",
          "giftcard_usage_amount",
          "id",
          "issued_at",
          "number",
          "order_id",
          "reference",
          "status",
          "store_id",
          "subtotal_amount",
          "tax_amount",
          "total_amount",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "number": {
            "type": "integer",
            "description": "Sequential number of the invoice within its store",
            "format": "int64"
          },
          "reference": {
            "type": "string",
            "description": "Human readable reference of the invoice"
          },
          "type": {
            "$ref": "#/components/schemas/InvoiceTypeDto"
          },
          "status": {
            "$ref": "#/components/schemas/InvoiceStatusDto"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "order_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "refund_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "parent_invoice_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "currency": {
            "type": "string",
            "description": "Three-letter currency code of the invoice"
          },
          "discount_amount": {
            "type": "integer",
            "description": "Total discount in smallest currency unit (e.g., cents)",
            "format": "int64"
          },
          "subtotal_amount": {
            "type": "integer",
            "description": "Total before tax in smallest currency unit",
            "format": "int64"
          },
          "tax_amount": {
            "type": "integer",
            "description": "Total tax in smallest currency unit",
            "format": "int64"
          },
          "giftcard_usage_amount": {
            "type": "integer",
            "description": "Amount paid using gift cards in smallest currency unit",
            "format": "int64"
          },
          "total_amount": {
            "type": "integer",
            "description": "Total of the invoice in smallest currency unit",
            "format": "int64"
          },
          "file_key": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional storage key of the generated invoice document"
          },
          "file_size": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Optional size of the generated invoice document in bytes",
            "format": "int64"
          },
          "created_at": {
            "type": "string",
            "description": "Date and time when the invoice was created",
            "format": "date-time"
          },
          "issued_at": {
            "type": "string",
            "description": "Date and time when the invoice was issued",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "InvoiceStatusDto": {
        "enum": [
          "invalid",
          "pending",
          "generated",
          "failed"
        ],
        "type": "string"
      },
      "InvoiceTypeDto": {
        "enum": [
          "invalid",
          "invoice",
          "credit_note"
        ],
        "type": "string"
      },
      "KakaoPayDetailsDto": {
        "type": "object",
        "properties": {
          "buyer_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The buyer identifier assigned by the local payment processor",
            "example": "buyer_abc123"
          }
        },
        "additionalProperties": false,
        "description": "Kakao Pay payment method details"
      },
      "KlarnaDetailsDto": {
        "type": "object",
        "properties": {
          "country": {
            "type": [
              "null",
              "string"
            ],
            "description": "The country code",
            "example": "SE"
          },
          "method_category": {
            "type": [
              "null",
              "string"
            ],
            "description": "The Klarna payment method category",
            "example": "pay_later"
          }
        },
        "additionalProperties": false,
        "description": "Klarna payment method details"
      },
      "KrCardDetailsDto": {
        "type": "object",
        "properties": {
          "brand": {
            "type": [
              "null",
              "string"
            ],
            "description": "The local card brand",
            "example": "shinhan"
          },
          "last4": {
            "type": [
              "null",
              "string"
            ],
            "description": "The last 4 digits of the card number",
            "example": 4242
          },
          "buyer_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The buyer identifier assigned by the local payment processor",
            "example": "buyer_abc123"
          }
        },
        "additionalProperties": false,
        "description": "Korean card payment method details"
      },
      "LastPaymentErrorDto": {
        "required": [
          "decline_code",
          "message"
        ],
        "type": "object",
        "properties": {
          "decline_code": {
            "$ref": "#/components/schemas/PaymentDeclineCode"
          },
          "message": {
            "type": "string",
            "description": "Human-readable decline reason message."
          }
        },
        "additionalProperties": false,
        "description": "The last payment decline object."
      },
      "LegacyStoreInvoiceDto": {
        "required": [
          "created_at",
          "currency",
          "id",
          "is_paid",
          "total"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The Stripe identifier of the invoice, starting with 'in_'."
          },
          "number": {
            "type": [
              "null",
              "string"
            ],
            "description": "The invoice number printed on the document."
          },
          "description": {
            "type": [
              "null",
              "string"
            ],
            "description": "What the invoice was raised for."
          },
          "currency": {
            "type": "string",
            "description": "The lowercase ISO 4217 currency the invoice was raised in."
          },
          "total": {
            "type": "integer",
            "description": "The invoice total in the smallest currency unit.",
            "format": "int64"
          },
          "is_paid": {
            "type": "boolean",
            "description": "Whether the invoice has been paid."
          },
          "created_at": {
            "type": "string",
            "description": "When the invoice was created.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents an invoice Stripe Billing raised for the store's subscription before the store moved to PayNow."
      },
      "LinkDetailsDto": {
        "required": [
          "email"
        ],
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "description": "The email associated with the Link account",
            "example": "john.doe@example.com"
          },
          "country": {
            "type": [
              "null",
              "string"
            ],
            "description": "The country code of the funding source behind the Link payment",
            "example": "US"
          }
        },
        "additionalProperties": false,
        "description": "Link payment method details"
      },
      "MarketingCouponConfigurationDto": {
        "required": [
          "customer_redeem_limit",
          "customer_redeem_limit_enabled",
          "discount_amount",
          "discount_apply_before_sales",
          "discount_only_required_tags_or_products",
          "discount_type",
          "duration",
          "minimum_order_value",
          "required_product_ids",
          "required_tag_ids",
          "usable_on_one_time_purchases",
          "usable_on_subscriptions"
        ],
        "type": "object",
        "properties": {
          "duration": {
            "$ref": "#/components/schemas/CouponDurationDto"
          },
          "duration_in_intervals": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Gets or sets the duration of the coupon in intervals, applicable only for repeating coupons.",
            "format": "int32"
          },
          "discount_type": {
            "$ref": "#/components/schemas/CouponDiscountTypeDto"
          },
          "discount_amount": {
            "type": "integer",
            "description": "Gets or sets the discount amount.",
            "format": "int64"
          },
          "discount_only_required_tags_or_products": {
            "type": "boolean",
            "description": "Gets or sets a value indicating whether the discount only applies to specific tags or products."
          },
          "discount_apply_before_sales": {
            "type": "boolean",
            "description": "Gets or sets a value indicating whether the discount is applied before any existing sales or discounts."
          },
          "required_tag_ids": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "Gets or sets the list of tag IDs required for the discount to apply."
          },
          "required_product_ids": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "Gets or sets the list of product IDs required for the discount to apply."
          },
          "minimum_order_value": {
            "type": "integer",
            "description": "Gets or sets the minimum order value required for the discount to be applied.",
            "format": "int64"
          },
          "customer_redeem_limit_enabled": {
            "type": "boolean",
            "description": "Gets or sets a value indicating whether a customer-specific redeem limit is enabled."
          },
          "customer_redeem_limit": {
            "type": "integer",
            "description": "Gets or sets the maximum number of times a single customer can redeem the coupon.",
            "format": "int64"
          },
          "usable_on_one_time_purchases": {
            "type": "boolean",
            "description": "Gets or sets a value indicating whether the coupon can be used on one-time purchases."
          },
          "usable_on_subscriptions": {
            "type": "boolean",
            "description": "Gets or sets a value indicating whether the coupon can be used on subscription purchases."
          },
          "expires_after": {
            "$ref": "#/components/schemas/Period"
          }
        },
        "additionalProperties": false,
        "description": "Represents the configuration settings for a coupon applied to marketing features."
      },
      "MatrixHeaderDto_V2": {
        "required": [
          "key"
        ],
        "type": "object",
        "properties": {
          "key": {
            "type": "string"
          },
          "interval_start": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "interval_end": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "MatrixRowDto_V2": {
        "required": [
          "cells",
          "header",
          "total"
        ],
        "type": "object",
        "properties": {
          "header": {
            "$ref": "#/components/schemas/MatrixHeaderDto_V2"
          },
          "total": {
            "$ref": "#/components/schemas/MatrixValueDto_V2"
          },
          "cells": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MatrixValueDto_V2"
            }
          }
        },
        "additionalProperties": false
      },
      "MatrixTypeDto_V2": {
        "enum": [
          "unspecified",
          "customer_purchase_retention",
          "subscription_mrr_changes"
        ],
        "type": "string"
      },
      "MatrixValueDto_V2": {
        "required": [
          "count"
        ],
        "type": "object",
        "properties": {
          "count": {
            "type": "integer",
            "format": "int64"
          },
          "earnings": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          }
        },
        "additionalProperties": false
      },
      "MediaAssetDto": {
        "required": [
          "content_type",
          "created_at",
          "id",
          "size_bytes",
          "store_id",
          "type",
          "url"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "url": {
            "type": "string",
            "description": "The public URL the media is served from."
          },
          "type": {
            "$ref": "#/components/schemas/MediaAssetTypeDto"
          },
          "content_type": {
            "type": "string",
            "description": "The MIME type of the media, for example 'image/png'."
          },
          "size_bytes": {
            "type": "integer",
            "description": "The size of the media in bytes.",
            "format": "int64"
          },
          "created_at": {
            "type": "string",
            "description": "The date and time the media asset was created.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents an image or video uploaded to a store's media."
      },
      "MediaAssetTypeDto": {
        "enum": [
          "unknown",
          "image",
          "video"
        ],
        "type": "string",
        "description": "Specifies the kind of media an asset holds.",
        "x-enumDescriptions": {
          "unknown": "The type is unknown.",
          "image": "An image (PNG, JPEG, WEBP or GIF).",
          "video": "A video (MP4)."
        },
        "x-paynow-docs-enum-descriptions": {
          "unknown": "The type is unknown.",
          "image": "An image (PNG, JPEG, WEBP or GIF).",
          "video": "A video (MP4)."
        }
      },
      "MoneyDto_V2": {
        "required": [
          "amount_minor_units",
          "iso_currency"
        ],
        "type": "object",
        "properties": {
          "iso_currency": {
            "type": "string",
            "description": "The ISO 4217 currency code, e.g. \"USD\", \"GBP\"."
          },
          "amount_minor_units": {
            "type": "integer",
            "description": "The amount in the smallest unit of the currency, e.g. cents for USD.\nFor example, 1000 = $10.00 USD.",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "NavLinkDto": {
        "required": [
          "name",
          "node_id",
          "tag_id",
          "tag_slug"
        ],
        "type": "object",
        "properties": {
          "node_id": {
            "type": "string",
            "description": "The unique identifier of the navigation link."
          },
          "tag_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "parent_node_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The 'node_id' of the link this one nests under, or null when it sits at the top level of the\nnavigation."
          },
          "tag_slug": {
            "type": "string",
            "description": "The slug of the tag the link points at."
          },
          "name": {
            "type": "string",
            "description": "The text shown for the link, taken from the tag it points at."
          },
          "order": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The position of the link among its siblings, lowest first, or null when no explicit order has\nbeen set.",
            "format": "int32"
          }
        },
        "additionalProperties": false,
        "description": "Represents a link in the storefront's navigation. Each link points at a tag, and links nest under\none another through 'parent_node_id' to form the navigation tree."
      },
      "NaverPayDetailsDto": {
        "type": "object",
        "properties": {
          "buyer_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The buyer identifier assigned by the local payment processor",
            "example": "buyer_abc123"
          }
        },
        "additionalProperties": false,
        "description": "Naver Pay payment method details"
      },
      "OrderCountryDistributionDataDto": {
        "required": [
          "gross_volume",
          "total_orders"
        ],
        "type": "object",
        "properties": {
          "total_orders": {
            "type": "integer",
            "format": "int64"
          },
          "gross_volume": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "OrderCountryDistributionDto": {
        "required": [
          "country_code",
          "current"
        ],
        "type": "object",
        "properties": {
          "country_code": {
            "type": "string"
          },
          "current": {
            "$ref": "#/components/schemas/OrderCountryDistributionDataDto"
          },
          "comparison": {
            "$ref": "#/components/schemas/OrderCountryDistributionDataDto"
          }
        },
        "additionalProperties": false
      },
      "OrderCouponUsageDto": {
        "required": [
          "coupon_id",
          "coupon_version_id",
          "usage_amount"
        ],
        "type": "object",
        "properties": {
          "coupon_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "coupon_version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "usage_amount": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "OrderDto": {
        "required": [
          "applied_coupons",
          "applied_giftcards",
          "billing_country",
          "billing_cycle_sequence",
          "billing_email",
          "billing_name",
          "currency",
          "customer",
          "customer_id",
          "customer_ip",
          "discount_amount",
          "discount_amount_str",
          "giftcard_usage_amount",
          "giftcard_usage_amount_str",
          "id",
          "is_subscription",
          "lines",
          "presentment_currency",
          "presentment_discount_amount",
          "presentment_discount_amount_str",
          "presentment_giftcard_usage_amount",
          "presentment_giftcard_usage_amount_str",
          "presentment_subtotal_amount",
          "presentment_subtotal_amount_str",
          "presentment_tax_amount",
          "presentment_tax_amount_str",
          "presentment_total_amount",
          "presentment_total_amount_str",
          "pretty_id",
          "status",
          "store_id",
          "subtotal_amount",
          "subtotal_amount_str",
          "tax_amount",
          "tax_amount_str",
          "tax_jurisdictions",
          "total_amount",
          "total_amount_str",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "pretty_id": {
            "type": "string",
            "description": "The PayNow order ID identifier starting with pn-.",
            "example": "pn-355eevennsow"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer": {
            "$ref": "#/components/schemas/CustomerDto"
          },
          "type": {
            "$ref": "#/components/schemas/OrderType"
          },
          "status": {
            "$ref": "#/components/schemas/OrderStatus"
          },
          "checkout_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "checkout_token": {
            "type": [
              "null",
              "string"
            ],
            "description": "The checkout token for this order",
            "example": "c4qqilpphugeqf2gndnkk5ad8fdq"
          },
          "subscription_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "is_subscription": {
            "type": "boolean",
            "description": "Signifies if the order is a subscription order",
            "readOnly": true
          },
          "coupon_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "applied_coupons": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OrderCouponUsageDto"
            },
            "description": "Applied coupons to this order"
          },
          "giftcard_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "applied_giftcards": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OrderGiftCardUsageDto"
            },
            "description": "Applied gift cards to this order"
          },
          "affiliate_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "billing_name": {
            "type": "string",
            "description": "The billing name for this order",
            "example": "John Doe"
          },
          "billing_email": {
            "type": "string",
            "description": "The billing email for this order",
            "example": "john.doe@example.com"
          },
          "billing_country": {
            "type": "string",
            "description": "The billing country for this order",
            "example": "US"
          },
          "billing_tax_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The tax identification number used for this order (for B2B transactions)"
          },
          "billing_cycle_sequence": {
            "type": "integer",
            "description": "The billing cycle sequence (current renewal count) if this is a subscription order",
            "format": "int32"
          },
          "customer_ip": {
            "type": "string",
            "description": "The IP address (IPv4 or IPv6) of the customer at time of order",
            "example": "192.168.1.1"
          },
          "currency": {
            "type": "string",
            "description": "The currency code used for this order",
            "example": "usd"
          },
          "discount_amount": {
            "type": "integer",
            "description": "The total discount amount applied to this order in smallest currency unit",
            "format": "int32",
            "example": 500
          },
          "discount_amount_str": {
            "type": "string",
            "description": "The discount amount formatted as a string",
            "example": "$5.00"
          },
          "subtotal_amount": {
            "type": "integer",
            "description": "The subtotal amount for this order in smallest currency unit",
            "format": "int32",
            "example": 9995
          },
          "subtotal_amount_str": {
            "type": "string",
            "description": "The subtotal amount formatted as a string",
            "example": "$99.95"
          },
          "tax_amount": {
            "type": "integer",
            "description": "The tax amount for this order in smallest currency unit",
            "format": "int32",
            "example": 999
          },
          "tax_amount_str": {
            "type": "string",
            "description": "The tax amount formatted as a string",
            "example": "$9.99"
          },
          "total_amount": {
            "type": "integer",
            "description": "The total amount for this order in smallest currency unit",
            "format": "int32",
            "example": 10494
          },
          "total_amount_str": {
            "type": "string",
            "description": "The total amount formatted as a string",
            "example": "$104.94"
          },
          "giftcard_usage_amount": {
            "type": "integer",
            "description": "The amount of gift card value used for this order in smallest currency unit",
            "format": "int32",
            "example": 0
          },
          "giftcard_usage_amount_str": {
            "type": "string",
            "description": "The gift card usage amount formatted as a string",
            "example": "$0.00"
          },
          "presentment_currency": {
            "type": "string",
            "description": "The presentment currency code used for this order (currency shown to customer)",
            "example": "eur"
          },
          "presentment_subtotal_amount": {
            "type": "integer",
            "description": "The presentment subtotal amount in smallest currency unit",
            "format": "int32",
            "example": 9995
          },
          "presentment_subtotal_amount_str": {
            "type": "string",
            "description": "The presentment subtotal amount formatted as a string",
            "readOnly": true,
            "example": "€99.95"
          },
          "presentment_discount_amount": {
            "type": "integer",
            "description": "The presentment discount amount in smallest currency unit",
            "format": "int32",
            "example": 500
          },
          "presentment_discount_amount_str": {
            "type": "string",
            "description": "The presentment discount amount formatted as a string",
            "readOnly": true,
            "example": "€5.00"
          },
          "presentment_giftcard_usage_amount": {
            "type": "integer",
            "description": "The presentment gift card usage amount in smallest currency unit",
            "format": "int32",
            "example": 0
          },
          "presentment_giftcard_usage_amount_str": {
            "type": "string",
            "description": "The presentment gift card usage amount formatted as a string",
            "readOnly": true,
            "example": "€0.00"
          },
          "presentment_tax_amount": {
            "type": "integer",
            "description": "The presentment tax amount in smallest currency unit",
            "format": "int32",
            "example": 999
          },
          "presentment_tax_amount_str": {
            "type": "string",
            "description": "The presentment tax amount formatted as a string",
            "readOnly": true,
            "example": "€9.99"
          },
          "presentment_total_amount": {
            "type": "integer",
            "description": "The presentment total amount in smallest currency unit",
            "format": "int32",
            "example": 10494
          },
          "presentment_total_amount_str": {
            "type": "string",
            "description": "The presentment total amount formatted as a string",
            "readOnly": true,
            "example": "€104.94"
          },
          "created_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when this order was created",
            "format": "date-time",
            "example": "2025-04-01T15:30:45Z"
          },
          "completed_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when this order was completed, if applicable",
            "format": "date-time",
            "example": "2025-04-01T15:35:22Z"
          },
          "lines": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OrderLineDto"
            },
            "description": "The line items in this order"
          },
          "tax_jurisdictions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SalesTaxJurisdictionDto"
            },
            "description": "A list of all tax jurisdictions that were involved in the taxation of this order."
          },
          "last_payment_error": {
            "$ref": "#/components/schemas/LastPaymentErrorDto"
          }
        },
        "additionalProperties": false,
        "description": "Represents a customer order"
      },
      "OrderGiftCardUsageDto": {
        "required": [
          "giftcard_id",
          "usage_amount"
        ],
        "type": "object",
        "properties": {
          "giftcard_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "usage_amount": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "OrderLineDto": {
        "required": [
          "discount_amount",
          "discount_amount_str",
          "gift",
          "giftcard_usage_amount",
          "giftcard_usage_amount_str",
          "id",
          "presentment_discount_amount",
          "presentment_discount_amount_str",
          "presentment_giftcard_usage_amount",
          "presentment_giftcard_usage_amount_str",
          "presentment_subtotal_amount",
          "presentment_subtotal_amount_str",
          "presentment_tax_amount",
          "presentment_tax_amount_str",
          "presentment_total_amount",
          "presentment_total_amount_str",
          "price",
          "price_str",
          "product_id",
          "product_name",
          "product_version_id",
          "quantity",
          "subtotal_amount",
          "subtotal_amount_str",
          "tax_amount",
          "tax_amount_str",
          "tax_inclusive",
          "total_amount",
          "total_amount_str"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "checkout_line_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_name": {
            "type": "string",
            "description": "The name of the product in this order line",
            "example": "Premium Game Pass"
          },
          "product_image_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "The URL of the product image",
            "example": "https://cdn.example.com/images/premium-game-pass.jpg"
          },
          "description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Customer-presentable description of the order line."
          },
          "created_giftcard_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The Gift Card ID of that product in this order line"
          },
          "subscription_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "subscription_line_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "subscription_change_line_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "trial_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "subscription_interval_value": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The interval value for subscription products",
            "format": "int32",
            "example": 1
          },
          "subscription_interval_scale": {
            "$ref": "#/components/schemas/ProductSubscriptionIntervalScale"
          },
          "gift": {
            "type": "boolean",
            "description": "Indicates whether this order line is a gift",
            "example": false
          },
          "gift_to_customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "gift_to_customer": {
            "$ref": "#/components/schemas/CustomerDto"
          },
          "sale_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "sale_version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "price": {
            "type": "integer",
            "description": "The unit price of the product in the smallest currency unit (e.g., cents)",
            "format": "int32",
            "example": 1999
          },
          "price_str": {
            "type": "string",
            "description": "The unit price of the product formatted as a string",
            "example": "$19.99"
          },
          "quantity": {
            "type": "integer",
            "description": "The quantity of the product in this order line",
            "format": "int32",
            "example": 1
          },
          "discount_amount": {
            "type": "integer",
            "description": "The discount amount (from sales, coupons, and affiliate links) applied to this order line",
            "format": "int32",
            "example": 0
          },
          "discount_amount_str": {
            "type": "string",
            "description": "The discount amount formatted as a string",
            "example": "$0.00"
          },
          "giftcard_usage_amount": {
            "type": "integer",
            "description": "The amount of gift card used for this order line",
            "format": "int32",
            "example": 0
          },
          "giftcard_usage_amount_str": {
            "type": "string",
            "description": "The gift card usage amount formatted as a string",
            "example": "$0.00"
          },
          "subtotal_amount": {
            "type": "integer",
            "description": "The subtotal amount for this order line",
            "format": "int32",
            "example": 1999
          },
          "subtotal_amount_str": {
            "type": "string",
            "description": "The subtotal amount formatted as a string",
            "example": "$19.99"
          },
          "tax_amount": {
            "type": "integer",
            "description": "The tax amount for this order line",
            "format": "int32",
            "example": 200
          },
          "tax_amount_str": {
            "type": "string",
            "description": "The tax amount formatted as a string",
            "example": "$2.00"
          },
          "total_amount": {
            "type": "integer",
            "description": "The total amount for this order line",
            "format": "int32",
            "example": 2199
          },
          "total_amount_str": {
            "type": "string",
            "description": "The total amount formatted as a string",
            "example": "$21.99"
          },
          "presentment_subtotal_amount": {
            "type": "integer",
            "description": "The presentment subtotal amount for this order line",
            "format": "int32",
            "example": 1999
          },
          "presentment_subtotal_amount_str": {
            "type": "string",
            "description": "The presentment subtotal amount formatted as a string",
            "readOnly": true,
            "example": "€19.99"
          },
          "presentment_discount_amount": {
            "type": "integer",
            "description": "The presentment discount amount for this order line",
            "format": "int32",
            "example": 0
          },
          "presentment_discount_amount_str": {
            "type": "string",
            "description": "The presentment discount amount formatted as a string",
            "readOnly": true,
            "example": "€0.00"
          },
          "presentment_tax_amount": {
            "type": "integer",
            "description": "The presentment tax amount for this order line",
            "format": "int32",
            "example": 200
          },
          "presentment_tax_amount_str": {
            "type": "string",
            "description": "The presentment tax amount formatted as a string",
            "readOnly": true,
            "example": "€2.00"
          },
          "presentment_giftcard_usage_amount": {
            "type": "integer",
            "description": "The presentment gift card usage amount for this order line",
            "format": "int32",
            "example": 0
          },
          "presentment_giftcard_usage_amount_str": {
            "type": "string",
            "description": "The presentment gift card usage amount formatted as a string",
            "readOnly": true,
            "example": "€0.00"
          },
          "presentment_total_amount": {
            "type": "integer",
            "description": "The presentment total amount for this order line",
            "format": "int32",
            "example": 2199
          },
          "presentment_total_amount_str": {
            "type": "string",
            "description": "The presentment total amount formatted as a string",
            "readOnly": true,
            "example": "€21.99"
          },
          "selected_gameserver_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "tax_inclusive": {
            "type": "boolean",
            "description": "Indicates whether tax is included in the base price, or added on top",
            "example": false
          },
          "payout_splits": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/OrderLinePayoutSplitDto"
            },
            "description": "The payout splits for this order line"
          },
          "pricing_region_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The regional pricing region ID for this order line, null if no regional pricing set",
            "example": "eu"
          },
          "custom_variables": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "$ref": "#/components/schemas/CustomVariableLineItemDto"
            },
            "description": "Key-value pair of selected custom variables for this order."
          }
        },
        "additionalProperties": false,
        "description": "Represents an order line item in a customer's order"
      },
      "OrderLinePayoutSplitDto": {
        "required": [
          "platform_fee",
          "user_id"
        ],
        "type": "object",
        "properties": {
          "user_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "percentage": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The percentage in basis points.",
            "format": "int64"
          },
          "platform_fee": {
            "type": "integer",
            "description": "The platform fee percentage in basis points.\nOnly used by platforms.",
            "format": "int64"
          }
        },
        "additionalProperties": false,
        "description": "Represents an order line-level payout split."
      },
      "OrderResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "order": {
            "$ref": "#/components/schemas/OrderDto"
          }
        },
        "additionalProperties": false
      },
      "OrderStatus": {
        "enum": [
          "created",
          "completed",
          "canceled",
          "refunded",
          "chargeback"
        ],
        "type": "string"
      },
      "OrderType": {
        "enum": [
          "one_time",
          "subscription_initial",
          "subscription_renewal",
          "subscription_proration",
          "mixed"
        ],
        "type": "string",
        "description": "Defines the type of items contained in an order",
        "x-enumDescriptions": {
          "one_time": "Order contains only one-time purchase items",
          "subscription_initial": "Order is the initial charge for a subscription",
          "subscription_renewal": "Order is a recurring renewal charge for a subscription",
          "subscription_proration": "Order is a proration charge for a subscription",
          "mixed": "Order contains both one-time purchase and subscription items"
        },
        "x-paynow-docs-enum-descriptions": {
          "one_time": "Order contains only one-time purchase items",
          "subscription_initial": "Order is the initial charge for a subscription",
          "subscription_renewal": "Order is a recurring renewal charge for a subscription",
          "subscription_proration": "Order is a proration charge for a subscription",
          "mixed": "Order contains both one-time purchase and subscription items"
        }
      },
      "OrdersSummaryDto_V2": {
        "required": [
          "lifetime_order_count",
          "month_to_date_order_count",
          "previous_month_order_count",
          "revenue_basis",
          "today_order_count",
          "yesterday_order_count"
        ],
        "type": "object",
        "properties": {
          "revenue_basis": {
            "$ref": "#/components/schemas/RevenueBasisDto_V2"
          },
          "today_revenue": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "today_order_count": {
            "type": "integer",
            "format": "int64"
          },
          "yesterday_revenue": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "yesterday_order_count": {
            "type": "integer",
            "format": "int64"
          },
          "month_to_date_revenue": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "month_to_date_order_count": {
            "type": "integer",
            "format": "int64"
          },
          "previous_month_revenue": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "previous_month_order_count": {
            "type": "integer",
            "format": "int64"
          },
          "lifetime_revenue": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "lifetime_order_count": {
            "type": "integer",
            "format": "int64"
          },
          "lifetime_average_order_value": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          }
        },
        "additionalProperties": false
      },
      "OrdersSummaryForRangeDto_V2": {
        "required": [
          "order_count",
          "revenue_basis"
        ],
        "type": "object",
        "properties": {
          "revenue_basis": {
            "$ref": "#/components/schemas/RevenueBasisDto_V2"
          },
          "revenue": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "average_order_value": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "order_count": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "P24DetailsDto": {
        "required": [
          "bank"
        ],
        "type": "object",
        "properties": {
          "bank": {
            "type": "string",
            "description": "The bank identifier",
            "example": "ing"
          },
          "payer_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The payer name",
            "example": "Jan Kowalski"
          }
        },
        "additionalProperties": false,
        "description": "Przelewy24 payment method details"
      },
      "PayByBankDetailsDto": {
        "type": "object",
        "properties": {
          "bank_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The bank name",
            "example": "Chase Bank"
          },
          "bic": {
            "type": [
              "null",
              "string"
            ],
            "description": "The Bank Identifier Code",
            "example": "CHASUS33"
          },
          "country": {
            "type": [
              "null",
              "string"
            ],
            "description": "The country code",
            "example": "US"
          },
          "payer_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The payer name",
            "example": "John Smith"
          }
        },
        "additionalProperties": false,
        "description": "Pay by Bank payment method details"
      },
      "PayNowActorType": {
        "enum": [
          "anonymous",
          "user",
          "api_key",
          "customer",
          "game_server",
          "internal",
          "admin",
          "platform",
          "global_customer"
        ],
        "type": "string"
      },
      "PayNowError": {
        "required": [
          "code",
          "message",
          "status"
        ],
        "type": "object",
        "properties": {
          "status": {
            "type": "integer",
            "description": "The HTTP status code.",
            "format": "int32",
            "example": 400
          },
          "code": {
            "type": "string",
            "description": "The PayNow parseable error code.",
            "example": "bad-request"
          },
          "message": {
            "type": "string",
            "description": "The human-readable error message.",
            "example": "Bad Request Example"
          },
          "trace_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "A distributed trace ID used for debugging.",
            "example": "234a5bcd543ef3fa53ce929d0e0e4736"
          },
          "errors": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/ValidationError"
            },
            "description": "An array of multiple errors. Only used by some API services."
          }
        },
        "additionalProperties": false,
        "description": "Represents a PayNow error"
      },
      "PayPalDetailsDto": {
        "required": [
          "country",
          "payer_email",
          "payer_id",
          "payer_name",
          "vault"
        ],
        "type": "object",
        "properties": {
          "payer_id": {
            "type": "string",
            "description": "The PayPal payer identifier",
            "example": "PAYERID123"
          },
          "payer_email": {
            "type": "string",
            "description": "The PayPal account email",
            "example": "john.doe@example.com"
          },
          "payer_name": {
            "type": "string",
            "description": "The PayPal account holder name",
            "example": "John Doe"
          },
          "country": {
            "type": "string",
            "description": "The country code of the PayPal account",
            "example": "US"
          },
          "vault": {
            "type": "boolean",
            "description": "Indicates if this PayPal account is vaulted",
            "example": true
          },
          "pending_vault_approval": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates if vault approval is pending",
            "example": false
          },
          "standalone_setup": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates if this is a standalone setup",
            "example": false
          }
        },
        "additionalProperties": false,
        "description": "PayPal payment method details"
      },
      "PaycoDetailsDto": {
        "type": "object",
        "properties": {
          "buyer_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The buyer identifier assigned by the local payment processor",
            "example": "buyer_abc123"
          }
        },
        "additionalProperties": false,
        "description": "Payco payment method details"
      },
      "PaymentAcceptanceDistributionDataDto": {
        "required": [
          "gross_volume",
          "total_orders"
        ],
        "type": "object",
        "properties": {
          "total_orders": {
            "type": "integer",
            "format": "int64"
          },
          "gross_volume": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "PaymentAcceptanceDistributionDto": {
        "required": [
          "current",
          "payment_status"
        ],
        "type": "object",
        "properties": {
          "payment_status": {
            "type": "string"
          },
          "current": {
            "$ref": "#/components/schemas/PaymentAcceptanceDistributionDataDto"
          },
          "comparison": {
            "$ref": "#/components/schemas/PaymentAcceptanceDistributionDataDto"
          }
        },
        "additionalProperties": false
      },
      "PaymentChargebackStatusDto": {
        "enum": [
          "none",
          "pending",
          "won",
          "lost"
        ],
        "type": "string",
        "description": "Represents chargeback status of a payment",
        "x-enumDescriptions": {
          "none": "No chargeback",
          "pending": "Chargeback is pending",
          "won": "Chargeback dispute was won",
          "lost": "Chargeback dispute was lost"
        },
        "x-paynow-docs-enum-descriptions": {
          "none": "No chargeback",
          "pending": "Chargeback is pending",
          "won": "Chargeback dispute was won",
          "lost": "Chargeback dispute was lost"
        }
      },
      "PaymentDeclineCode": {
        "enum": [
          "unknown",
          "generic_decline",
          "call_issuer",
          "authentication_required",
          "currency_not_supported",
          "duplicate_transaction",
          "expired_card",
          "fraudulent",
          "incorrect_number",
          "incorrect_cvc",
          "incorrect_pin",
          "incorrect_zip",
          "insufficient_funds",
          "invalid_account",
          "invalid_amount",
          "invalid_expiry_month",
          "invalid_expiry_year",
          "issuer_not_available",
          "lost_card",
          "merchant_blacklist",
          "new_account_information_available",
          "no_action_taken",
          "pickup_card",
          "pin_try_exceeded",
          "restricted_card",
          "stolen_card",
          "testmode_decline",
          "try_again_later",
          "security_violation",
          "card_velocity_exceeded",
          "do_not_honor",
          "processing_error",
          "card_not_supported",
          "transaction_not_allowed",
          "authorization_revoked",
          "store_blocked"
        ],
        "type": "string",
        "description": "A payment decline reason code.",
        "x-enumDescriptions": {
          "unknown": "An unknown error occurred during payment processing.",
          "generic_decline": "The payment was declined for an unspecified reason.",
          "call_issuer": "The payment provider requires the customer to contact them.",
          "authentication_required": "Additional authentication is needed to complete the transaction.",
          "currency_not_supported": "The chosen currency is not supported by this payment method.",
          "duplicate_transaction": "An identical transaction was recently processed.",
          "expired_card": "The payment method has passed its expiration date.",
          "fraudulent": "The payment was flagged as potentially fraudulent.",
          "incorrect_number": "The provided payment number is invalid.",
          "incorrect_cvc": "The security code for the payment method is incorrect.",
          "incorrect_pin": "The entered PIN is not valid.",
          "incorrect_zip": "The provided billing postal code is incorrect.",
          "insufficient_funds": "The payment method lacks sufficient funds for the transaction.",
          "invalid_account": "The payment method or associated account is not valid.",
          "invalid_amount": "The transaction amount is not allowed or is invalid.",
          "invalid_expiry_month": "The expiration month for the payment method is invalid.",
          "invalid_expiry_year": "The expiration year for the payment method is invalid.",
          "issuer_not_available": "The payment provider's systems are currently unavailable.",
          "lost_card": "The payment method has been reported as lost.",
          "merchant_blacklist": "The transaction was blocked by PayNow's security measures.",
          "new_account_information_available": "Updated information is available for the payment method.",
          "no_action_taken": "The payment provider took no action on this transaction.",
          "pickup_card": "The payment method has been flagged and cannot be used.",
          "pin_try_exceeded": "Too many incorrect PIN attempts have been made.",
          "restricted_card": "The payment method has restrictions preventing its use.",
          "stolen_card": "The payment method has been reported as stolen.",
          "testmode_decline": "A test payment method was used in a live environment.",
          "try_again_later": "A temporary issue prevented the transaction from completing.",
          "security_violation": "A security issue occurred during the transaction.",
          "card_velocity_exceeded": "The payment method has exceeded its usage limits.",
          "do_not_honor": "The payment provider has chosen not to process this transaction.",
          "processing_error": "An error occurred while processing the payment.",
          "card_not_supported": "This payment method doesn't support this type of transaction.",
          "transaction_not_allowed": "This specific transaction is not permitted for this payment method.",
          "authorization_revoked": "The payment authorization has been revoked.",
          "store_blocked": "The payment was blocked by one of your store's configured rules."
        },
        "x-paynow-docs-enum-descriptions": {
          "unknown": "An unknown error occurred during payment processing.",
          "generic_decline": "The payment was declined for an unspecified reason.",
          "call_issuer": "The payment provider requires the customer to contact them.",
          "authentication_required": "Additional authentication is needed to complete the transaction.",
          "currency_not_supported": "The chosen currency is not supported by this payment method.",
          "duplicate_transaction": "An identical transaction was recently processed.",
          "expired_card": "The payment method has passed its expiration date.",
          "fraudulent": "The payment was flagged as potentially fraudulent.",
          "incorrect_number": "The provided payment number is invalid.",
          "incorrect_cvc": "The security code for the payment method is incorrect.",
          "incorrect_pin": "The entered PIN is not valid.",
          "incorrect_zip": "The provided billing postal code is incorrect.",
          "insufficient_funds": "The payment method lacks sufficient funds for the transaction.",
          "invalid_account": "The payment method or associated account is not valid.",
          "invalid_amount": "The transaction amount is not allowed or is invalid.",
          "invalid_expiry_month": "The expiration month for the payment method is invalid.",
          "invalid_expiry_year": "The expiration year for the payment method is invalid.",
          "issuer_not_available": "The payment provider's systems are currently unavailable.",
          "lost_card": "The payment method has been reported as lost.",
          "merchant_blacklist": "The transaction was blocked by PayNow's security measures.",
          "new_account_information_available": "Updated information is available for the payment method.",
          "no_action_taken": "The payment provider took no action on this transaction.",
          "pickup_card": "The payment method has been flagged and cannot be used.",
          "pin_try_exceeded": "Too many incorrect PIN attempts have been made.",
          "restricted_card": "The payment method has restrictions preventing its use.",
          "stolen_card": "The payment method has been reported as stolen.",
          "testmode_decline": "A test payment method was used in a live environment.",
          "try_again_later": "A temporary issue prevented the transaction from completing.",
          "security_violation": "A security issue occurred during the transaction.",
          "card_velocity_exceeded": "The payment method has exceeded its usage limits.",
          "do_not_honor": "The payment provider has chosen not to process this transaction.",
          "processing_error": "An error occurred while processing the payment.",
          "card_not_supported": "This payment method doesn't support this type of transaction.",
          "transaction_not_allowed": "This specific transaction is not permitted for this payment method.",
          "authorization_revoked": "The payment authorization has been revoked.",
          "store_blocked": "The payment was blocked by one of your store's configured rules."
        }
      },
      "PaymentDto": {
        "required": [
          "amount",
          "chargeback_status",
          "created_at",
          "currency",
          "customer",
          "customer_id",
          "gateway",
          "gateway_entity_identifier",
          "gateway_fee_amount",
          "gateway_id",
          "id",
          "method",
          "order_id",
          "platform_fee_amount",
          "platform_fee_rate",
          "presentment_amount",
          "presentment_currency",
          "status",
          "store_id",
          "store_net_amount",
          "tax_amount"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "order_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer": {
            "$ref": "#/components/schemas/CustomerDto"
          },
          "refunds": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/RefundDto"
            },
            "description": "The list of refunds associated with this payment"
          },
          "gateway": {
            "type": "string",
            "description": "The payment gateway provider",
            "example": "stripe"
          },
          "gateway_entity_identifier": {
            "type": "string",
            "description": "The gateway entity identifier"
          },
          "gateway_id": {
            "type": "string",
            "description": "The gateway payment identifier"
          },
          "method": {
            "$ref": "#/components/schemas/PaymentMethodDto"
          },
          "method_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "status": {
            "$ref": "#/components/schemas/PaymentStatusDto"
          },
          "currency": {
            "type": "string",
            "description": "The currency code used for this payment in the store's currency",
            "example": "usd"
          },
          "amount": {
            "type": "integer",
            "description": "The total payment amount in smallest currency unit",
            "format": "int32",
            "example": 10000
          },
          "gateway_fee_amount": {
            "type": "integer",
            "description": "The gateway fee amount in smallest currency unit",
            "format": "int32",
            "example": 320
          },
          "tax_amount": {
            "type": "integer",
            "description": "The tax amount in smallest currency unit",
            "format": "int32",
            "example": 850
          },
          "platform_fee_amount": {
            "type": "integer",
            "description": "The platform fee amount in smallest currency unit",
            "format": "int32",
            "example": 500
          },
          "store_net_amount": {
            "type": "integer",
            "description": "The net amount going to the store in smallest currency unit",
            "format": "int32",
            "example": 8330
          },
          "presentment_currency": {
            "type": "string",
            "description": "The currency code used for presentment to the customer",
            "example": "eur"
          },
          "presentment_amount": {
            "type": "integer",
            "description": "The amount presented to the customer in smallest currency unit",
            "format": "int32",
            "example": 9500
          },
          "fx_rate": {
            "type": [
              "null",
              "number"
            ],
            "description": "The foreign exchange rate used for currency conversion",
            "format": "double",
            "example": 1.085
          },
          "platform_fee_rate": {
            "type": "integer",
            "description": "The platform fee rate applied to this payment (in basis points)",
            "format": "int32",
            "example": 500
          },
          "chargeback_status": {
            "$ref": "#/components/schemas/PaymentChargebackStatusDto"
          },
          "chargeback_status_updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the chargeback status was last updated",
            "format": "date-time"
          },
          "payout_split_rules": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/PaymentPayoutSplitRuleDto"
            },
            "description": "The payout split rules for multi-party payments"
          },
          "payout_split_results": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/PaymentPayoutSplitResultDto"
            },
            "description": "The payout split results for multi-party payments"
          },
          "created_at": {
            "type": "string",
            "description": "The date and time when this payment was created",
            "format": "date-time",
            "example": "2025-04-01T15:30:45Z"
          },
          "pending_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when this payment entered pending status",
            "format": "date-time",
            "example": "2025-04-01T15:30:46Z"
          },
          "completed_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when this payment was completed",
            "format": "date-time",
            "example": "2025-04-01T15:31:12Z"
          },
          "canceled_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when this payment was canceled",
            "format": "date-time"
          },
          "failed_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when this payment failed",
            "format": "date-time"
          },
          "refunded_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when this payment was last refunded",
            "format": "date-time"
          },
          "chargeback_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when a chargeback was initiated on this payment",
            "format": "date-time"
          },
          "last_payment_error": {
            "$ref": "#/components/schemas/LastPaymentErrorDto"
          }
        },
        "additionalProperties": false,
        "description": "Represents a payment transaction"
      },
      "PaymentGatewayDto": {
        "enum": [
          "invalid",
          "stripe",
          "paypal",
          "forumpay",
          "steamskins",
          "nuvei",
          "pagseguro",
          "tazapay",
          "paysafe",
          "checkoutcom"
        ],
        "type": "string"
      },
      "PaymentMethodChargebackRateDto_V2": {
        "required": [
          "chargeback_rate",
          "method_type"
        ],
        "type": "object",
        "properties": {
          "method_type": {
            "type": "string"
          },
          "chargeback_rate": {
            "type": "number",
            "format": "float"
          }
        },
        "additionalProperties": false
      },
      "PaymentMethodDetailsDto": {
        "type": "object",
        "properties": {
          "card": {
            "$ref": "#/components/schemas/CardDetailsDto"
          },
          "cashapp": {
            "$ref": "#/components/schemas/CashAppDetailsDto"
          },
          "paypal": {
            "$ref": "#/components/schemas/PayPalDetailsDto"
          },
          "link": {
            "$ref": "#/components/schemas/LinkDetailsDto"
          },
          "crypto": {
            "$ref": "#/components/schemas/CryptoDetailsDto"
          },
          "steamskins": {
            "$ref": "#/components/schemas/SteamSkinsDetailsDto"
          },
          "ideal": {
            "$ref": "#/components/schemas/IdealDetailsDto"
          },
          "p24": {
            "$ref": "#/components/schemas/P24DetailsDto"
          },
          "bancontact": {
            "$ref": "#/components/schemas/BancontactDetailsDto"
          },
          "klarna": {
            "$ref": "#/components/schemas/KlarnaDetailsDto"
          },
          "alipay": {
            "$ref": "#/components/schemas/AlipayDetailsDto"
          },
          "pay_by_bank": {
            "$ref": "#/components/schemas/PayByBankDetailsDto"
          },
          "pix": {
            "$ref": "#/components/schemas/PixDetailsDto"
          },
          "paysafecard": {
            "$ref": "#/components/schemas/PaysafeCardDetailsDto"
          },
          "kr_card": {
            "$ref": "#/components/schemas/KrCardDetailsDto"
          },
          "kakao_pay": {
            "$ref": "#/components/schemas/KakaoPayDetailsDto"
          },
          "naver_pay": {
            "$ref": "#/components/schemas/NaverPayDetailsDto"
          },
          "samsung_pay": {
            "$ref": "#/components/schemas/SamsungPayDetailsDto"
          },
          "payco": {
            "$ref": "#/components/schemas/PaycoDetailsDto"
          },
          "bizum": {
            "$ref": "#/components/schemas/BizumDetailsDto"
          },
          "blik": {
            "$ref": "#/components/schemas/BlikDetailsDto"
          },
          "swish": {
            "$ref": "#/components/schemas/SwishDetailsDto"
          },
          "upi": {
            "$ref": "#/components/schemas/UpiDetailsDto"
          },
          "eps": {
            "$ref": "#/components/schemas/EpsDetailsDto"
          }
        },
        "additionalProperties": false,
        "description": "Contains detailed information about a payment method.\nDISCLAIMER: These fields are not guaranteed to be backwards compatible and may change or be removed without notice."
      },
      "PaymentMethodDistributionDataDto": {
        "required": [
          "gross_volume"
        ],
        "type": "object",
        "properties": {
          "gross_volume": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "PaymentMethodDistributionDto": {
        "required": [
          "current",
          "method_type"
        ],
        "type": "object",
        "properties": {
          "method_type": {
            "type": "string"
          },
          "current": {
            "$ref": "#/components/schemas/PaymentMethodDistributionDataDto"
          },
          "comparison": {
            "$ref": "#/components/schemas/PaymentMethodDistributionDataDto"
          }
        },
        "additionalProperties": false
      },
      "PaymentMethodDto": {
        "required": [
          "created_at",
          "gateway",
          "gateway_customer_id",
          "gateway_entity_identifier",
          "gateway_id",
          "gateway_type",
          "id",
          "method_details",
          "method_type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "gateway": {
            "type": "string",
            "description": "The payment gateway provider"
          },
          "gateway_id": {
            "type": "string",
            "description": "The gateway's identifier for this payment method"
          },
          "gateway_customer_id": {
            "type": "string",
            "description": "The gateway's customer identifier"
          },
          "gateway_type": {
            "type": "string",
            "description": "The gateway-specific type identifier",
            "example": "card"
          },
          "method_type": {
            "type": "string",
            "description": "The payment method type",
            "example": "card"
          },
          "method_details": {
            "$ref": "#/components/schemas/PaymentMethodDetailsDto"
          },
          "created_at": {
            "type": "string",
            "description": "The date and time when this payment method was created",
            "format": "date-time",
            "example": "2025-03-15T10:20:30Z"
          },
          "gateway_entity_identifier": {
            "type": "string",
            "description": "The gateway entity identifier"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when this payment method was last updated",
            "format": "date-time",
            "example": "2025-03-20T14:30:00Z"
          }
        },
        "additionalProperties": false,
        "description": "Represents a stored payment method"
      },
      "PaymentMethodTypeApprovalStatusDto": {
        "enum": [
          "invalid",
          "pending",
          "approved",
          "rejected",
          "submitted"
        ],
        "type": "string"
      },
      "PaymentMethodTypeCountryCurrencyMappingDto": {
        "required": [
          "country",
          "currencies"
        ],
        "type": "object",
        "properties": {
          "country": {
            "type": "string"
          },
          "currencies": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "PaymentMethodTypeDto": {
        "required": [
          "approval_required",
          "b2b_supported",
          "b2c_supported",
          "category",
          "confirmation",
          "country_currency_mapping",
          "enabled",
          "fee_overrides",
          "gateways",
          "id",
          "kyc_required",
          "name",
          "refunds_supported",
          "revenue_usage",
          "subscriptions_supported",
          "supported_countries",
          "supported_currencies",
          "supported_settlement_currencies"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "name": {
            "type": "string"
          },
          "logo_url": {
            "type": [
              "null",
              "string"
            ]
          },
          "checkout_logo_url_light": {
            "type": [
              "null",
              "string"
            ]
          },
          "checkout_logo_url_dark": {
            "type": [
              "null",
              "string"
            ]
          },
          "category": {
            "type": "string"
          },
          "confirmation": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "refunds_supported": {
            "type": "boolean"
          },
          "subscriptions_supported": {
            "type": "boolean"
          },
          "kyc_required": {
            "type": "boolean"
          },
          "supported_currencies": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "supported_settlement_currencies": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "supported_countries": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "gateways": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PaymentGatewayDto"
            }
          },
          "fee_overrides": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PaymentMethodTypeFeeOverrideDto"
            }
          },
          "country_currency_mapping": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PaymentMethodTypeCountryCurrencyMappingDto"
            }
          },
          "revenue_usage": {
            "type": "integer",
            "format": "int64"
          },
          "monthly_revenue_limit": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int64"
          },
          "default_monthly_revenue_limit": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int64"
          },
          "settlement_time": {
            "type": [
              "null",
              "string"
            ]
          },
          "min_transaction_amount": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int64"
          },
          "max_transaction_amount": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int64"
          },
          "b2c_supported": {
            "type": "boolean"
          },
          "b2b_supported": {
            "type": "boolean"
          },
          "approval_required": {
            "type": "boolean"
          },
          "approval_status": {
            "$ref": "#/components/schemas/PaymentMethodTypeApprovalStatusDto"
          },
          "approval_decline_reason": {
            "type": [
              "null",
              "string"
            ]
          },
          "approval_requested_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "approval_decided_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "PaymentMethodTypeFeeOverrideDto": {
        "required": [
          "begins_at",
          "card_brands",
          "card_funding_types",
          "card_networks",
          "card_product_categories",
          "card_regulated_statuses",
          "countries",
          "fee_cents",
          "fee_percentage"
        ],
        "type": "object",
        "properties": {
          "fee_percentage": {
            "type": "integer",
            "format": "int32"
          },
          "fee_cents": {
            "type": "integer",
            "format": "int32"
          },
          "countries": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "card_brands": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "card_networks": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "card_funding_types": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "card_regulated_statuses": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "card_product_categories": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "fee_schedule_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "begins_at": {
            "type": "string",
            "format": "date-time"
          },
          "ends_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "PaymentMethodUpdateSessionDto": {
        "required": [
          "session_url"
        ],
        "type": "object",
        "properties": {
          "session_url": {
            "type": "string",
            "description": "The URL the store owner has to visit to update the subscription's payment method."
          }
        },
        "additionalProperties": false,
        "description": "A customer portal session scoped to updating the payment method of the store's\nactive subscription."
      },
      "PaymentPayoutSplitResultDto": {
        "required": [
          "connected_platform_fee_amount",
          "gateway_fee_amount",
          "gross_amount",
          "line_id",
          "net_amount",
          "platform_fee_amount",
          "tax_amount",
          "user_id"
        ],
        "type": "object",
        "properties": {
          "user_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "gross_amount": {
            "type": "integer",
            "description": "The gross amount before fees in smallest currency unit",
            "format": "int32",
            "example": 10000
          },
          "tax_amount": {
            "type": "integer",
            "description": "The tax amount in smallest currency unit",
            "format": "int32",
            "example": 850
          },
          "gateway_fee_amount": {
            "type": "integer",
            "description": "The gateway fee amount in smallest currency unit",
            "format": "int32",
            "example": 320
          },
          "platform_fee_amount": {
            "type": "integer",
            "description": "The platform fee amount in smallest currency unit",
            "format": "int32",
            "example": 500
          },
          "connected_platform_fee_amount": {
            "type": "integer",
            "description": "The connected platform fee amount in smallest currency unit",
            "format": "int32",
            "example": 100
          },
          "net_amount": {
            "type": "integer",
            "description": "The net amount after all fees in smallest currency unit",
            "format": "int32",
            "example": 8230
          },
          "line_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false,
        "description": "Represents payout split results for multi-party payments"
      },
      "PaymentPayoutSplitRuleDto": {
        "required": [
          "line_amount_tax",
          "line_amount_total",
          "line_id",
          "splits"
        ],
        "type": "object",
        "properties": {
          "line_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "line_amount_total": {
            "type": "integer",
            "description": "The total amount of the line item in smallest currency unit",
            "format": "int32",
            "example": 10000
          },
          "line_amount_tax": {
            "type": "integer",
            "description": "The tax amount of the line item in smallest currency unit",
            "format": "int32",
            "example": 850
          },
          "splits": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PaymentPayoutSplitRuleSplitDto"
            },
            "description": "The list of splits defining how the payout should be divided"
          }
        },
        "additionalProperties": false,
        "description": "Represents payout split rules for a payment line"
      },
      "PaymentPayoutSplitRuleSplitDto": {
        "required": [
          "platform_fee_percentage",
          "user_id"
        ],
        "type": "object",
        "properties": {
          "user_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "percentage": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The percentage of the line amount this user receives (in basis points, e.g., 5000 = 50%)",
            "format": "int32",
            "example": 5000
          },
          "platform_fee_percentage": {
            "type": "integer",
            "description": "The platform fee percentage applied to this split (in basis points)",
            "format": "int32",
            "example": 500
          }
        },
        "additionalProperties": false,
        "description": "Represents a single split configuration within a payout split rule"
      },
      "PaymentPopularTimesOfDayDto": {
        "required": [
          "hour",
          "total",
          "weekday"
        ],
        "type": "object",
        "properties": {
          "weekday": {
            "type": "string"
          },
          "hour": {
            "type": "string"
          },
          "total": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "PaymentStatusDto": {
        "enum": [
          "unknown",
          "created",
          "pending",
          "completed",
          "canceled",
          "failed",
          "refunded",
          "chargeback",
          "refund_failed",
          "refund_processing"
        ],
        "type": "string",
        "description": "Represents payment status",
        "x-enumDescriptions": {
          "unknown": "Unknown status",
          "created": "Payment has been created but not yet processed",
          "pending": "Payment is pending processing",
          "completed": "Payment has been completed successfully",
          "canceled": "Payment has been canceled",
          "failed": "Payment has failed",
          "refunded": "Payment has been fully refunded",
          "chargeback": "Payment has been charged back",
          "refund_failed": "Refund processing failed",
          "refund_processing": "Refund is currently processing"
        },
        "x-paynow-docs-enum-descriptions": {
          "unknown": "Unknown status",
          "created": "Payment has been created but not yet processed",
          "pending": "Payment is pending processing",
          "completed": "Payment has been completed successfully",
          "canceled": "Payment has been canceled",
          "failed": "Payment has failed",
          "refunded": "Payment has been fully refunded",
          "chargeback": "Payment has been charged back",
          "refund_failed": "Refund processing failed",
          "refund_processing": "Refund is currently processing"
        }
      },
      "PaysafeCardDetailsDto": {
        "type": "object",
        "properties": {
          "first_name": {
            "type": [
              "null",
              "string"
            ]
          },
          "last_name": {
            "type": [
              "null",
              "string"
            ]
          },
          "psc_id": {
            "type": [
              "null",
              "string"
            ]
          },
          "association_id": {
            "type": [
              "null",
              "string"
            ]
          }
        },
        "additionalProperties": false,
        "description": "Paysafecard payment method details"
      },
      "Period": {
        "type": "string",
        "additionalProperties": false,
        "description": "ISO 8601 duration format",
        "format": "period",
        "example": "P1Y2M3DT4H5M6S"
      },
      "PixDetailsDto": {
        "type": "object",
        "properties": {
          "bank_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The bank name",
            "example": "Banco do Brasil"
          },
          "bank_account_number": {
            "type": [
              "null",
              "string"
            ],
            "description": "The bank account number",
            "example": "12345-6"
          },
          "payer_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The payer name",
            "example": "João Silva"
          }
        },
        "additionalProperties": false,
        "description": "Pix payment method details"
      },
      "PlanDto": {
        "required": [
          "id",
          "is_custom",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": [
              "null",
              "string"
            ]
          },
          "is_custom": {
            "type": "boolean"
          },
          "inherits_from_plan_id": {
            "type": [
              "null",
              "string"
            ]
          }
        },
        "additionalProperties": false
      },
      "PlanPreviewDto": {
        "required": [
          "id",
          "is_custom",
          "name",
          "platform_fee_rate",
          "subscription_price_monthly"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The unique identifier of the plan."
          },
          "name": {
            "type": "string",
            "description": "The display name of the plan."
          },
          "description": {
            "type": [
              "null",
              "string"
            ],
            "description": "The description of the plan."
          },
          "is_custom": {
            "type": "boolean",
            "description": "Whether the plan is negotiated for a specific store rather than publicly offered."
          },
          "inherits_from_plan_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The identifier of the plan this one inherits its limits and feature flags from, if any."
          },
          "platform_fee_rate": {
            "type": "integer",
            "description": "The platform fee charged on the store's revenue, in basis points.",
            "format": "int64"
          },
          "subscription_price_monthly": {
            "type": "integer",
            "description": "The monthly subscription price, in the smallest currency unit.",
            "format": "int64"
          },
          "subscription_price_annually": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The annual subscription price, in the smallest currency unit, when the plan is billed annually.",
            "format": "int64"
          }
        },
        "additionalProperties": false,
        "description": "Represents a publicly listed plan a store can subscribe to."
      },
      "PlanPricingDto": {
        "required": [
          "begins_at",
          "id",
          "plan_id",
          "platform_fee_rate",
          "subscription_price_monthly"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "plan_id": {
            "type": "string"
          },
          "platform_fee_rate": {
            "type": "integer",
            "format": "int64"
          },
          "subscription_price_monthly": {
            "type": "integer",
            "format": "int64"
          },
          "subscription_price_annually": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int64"
          },
          "begins_at": {
            "type": "string",
            "format": "date-time"
          },
          "ends_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "revenue_limit_exceeded": {
            "type": [
              "null",
              "boolean"
            ]
          }
        },
        "additionalProperties": false
      },
      "PlatformCapability": {
        "enum": [
          "invalid",
          "connected_users"
        ],
        "type": "string"
      },
      "PlatformStoreTypeAssociationDetailsDto": {
        "required": [
          "disable_billing_plans",
          "display_disclaimers",
          "full_external_management",
          "platform_id",
          "store_platform"
        ],
        "type": "object",
        "properties": {
          "platform_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "associated_platform": {
            "$ref": "#/components/schemas/PublicPlatformDto"
          },
          "store_platform": {
            "type": "string",
            "description": "The store platform identifier string (e.g. \"rust\", \"minecraft\")."
          },
          "paynow_platform_fee_percentage_override": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Overrides the default PayNow platform fee percentage for this association.\nExpressed in basis points (e.g. 250 = 2.50%).",
            "format": "int64"
          },
          "connected_platform_fee_percentage": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The fee percentage charged by the connected platform.\nExpressed in basis points (e.g. 250 = 2.50%).",
            "format": "int64"
          },
          "connected_platform_wallet_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "disable_billing_plans": {
            "type": "boolean",
            "description": "When true, billing plans are disabled for this platform/store type combination."
          },
          "display_disclaimers": {
            "type": "boolean",
            "description": "When true, legal or compliance disclaimers should be displayed to the end user."
          },
          "full_external_management": {
            "type": "boolean",
            "description": "Whether the management hides some PayNow UI"
          }
        },
        "additionalProperties": false
      },
      "PlatformType": {
        "enum": [
          "invalid",
          "marketplace",
          "store_platform",
          "other"
        ],
        "type": "string"
      },
      "PopularTimeOfDayDto_V2": {
        "required": [
          "day_of_week",
          "hour",
          "payment_count"
        ],
        "type": "object",
        "properties": {
          "day_of_week": {
            "$ref": "#/components/schemas/DayOfWeekDto"
          },
          "hour": {
            "type": "integer",
            "format": "int32"
          },
          "payment_count": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "PrepaidCardsBlockingTypeDto": {
        "enum": [
          "unspecified",
          "none",
          "trials",
          "all_recurring"
        ],
        "type": "string",
        "description": "Defines when prepaid cards should be blocked from use.",
        "x-enumDescriptions": {
          "unspecified": "Blocking type not specified.",
          "none": "Allow prepaid cards for all payment types.",
          "trials": "Block prepaid cards for trial subscriptions only.",
          "all_recurring": "Block prepaid cards for all recurring payments (trials and subscriptions)."
        },
        "x-paynow-docs-enum-descriptions": {
          "unspecified": "Blocking type not specified.",
          "none": "Allow prepaid cards for all payment types.",
          "trials": "Block prepaid cards for trial subscriptions only.",
          "all_recurring": "Block prepaid cards for all recurring payments (trials and subscriptions)."
        }
      },
      "ProductCommandDto": {
        "required": [
          "content",
          "online_only",
          "stage"
        ],
        "type": "object",
        "properties": {
          "stage": {
            "$ref": "#/components/schemas/ProductCommandStage"
          },
          "content": {
            "type": "string",
            "description": "Content of the command."
          },
          "online_only": {
            "type": "boolean",
            "description": "Value indicating whether the command should only execute when the player is online."
          },
          "override_execute_on_gameserver_ids": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "Value indicating on which game servers should the command be executed.\nIf left empty or null, then the default behavior applies\n(executing on all game servers or on the selected game server is selection is enabled)"
          }
        },
        "additionalProperties": false
      },
      "ProductCommandExecutionRuleDto": {
        "enum": [
          "invalid",
          "once_per_item",
          "once_per_order"
        ],
        "type": "string",
        "x-enumDescriptions": {
          "once_per_item": "Executes commands regularly, once per item (number of products * quantity times)",
          "once_per_order": "Executes command only once per entire order"
        },
        "x-paynow-docs-enum-descriptions": {
          "once_per_item": "Executes commands regularly, once per item (number of products * quantity times)",
          "once_per_order": "Executes command only once per entire order"
        }
      },
      "ProductCommandStage": {
        "enum": [
          "invalid",
          "on_purchase",
          "on_expire",
          "on_refund",
          "on_renew",
          "on_chargeback",
          "on_trial_start",
          "on_trial_expire"
        ],
        "type": "string",
        "description": "Defines the stages at which product commands can be executed.",
        "x-enumDescriptions": {
          "invalid": "Represents an invalid or unspecified command stage.",
          "on_purchase": "Commands that should be executed when a product is purchased.",
          "on_expire": "Commands that should be executed when a product expires.",
          "on_refund": "Commands that should be executed when a product is refunded.",
          "on_renew": "Commands that should be executed when a subscription is renewed.",
          "on_chargeback": "Commands that should be executed when an order is charged back.",
          "on_trial_start": "Commands that should be executed when a trial is started.",
          "on_trial_expire": "Commands that should be executed when a trial expires."
        },
        "x-paynow-docs-enum-descriptions": {
          "invalid": "Represents an invalid or unspecified command stage.",
          "on_purchase": "Commands that should be executed when a product is purchased.",
          "on_expire": "Commands that should be executed when a product expires.",
          "on_refund": "Commands that should be executed when a product is refunded.",
          "on_renew": "Commands that should be executed when a subscription is renewed.",
          "on_chargeback": "Commands that should be executed when an order is charged back.",
          "on_trial_start": "Commands that should be executed when a trial is started.",
          "on_trial_expire": "Commands that should be executed when a trial expires."
        }
      },
      "ProductDeliverableActionsDto": {
        "required": [
          "grant_giftcard"
        ],
        "type": "object",
        "properties": {
          "grant_giftcard": {
            "type": "boolean",
            "description": "Value indicating whether to grant a giftcard with the product with the subtotal amount."
          }
        },
        "additionalProperties": false
      },
      "ProductDependentMigrationDto": {
        "required": [
          "created_at",
          "created_by",
          "id",
          "migration_targets",
          "product_id",
          "send_all_commands_to_new_servers",
          "send_new_commands_to_all_servers",
          "status",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "migration_targets": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductDependentMigrationTargetDto"
            }
          },
          "status": {
            "$ref": "#/components/schemas/ProductDependentMigrationStatusDto"
          },
          "send_new_commands_to_all_servers": {
            "type": "boolean"
          },
          "send_all_commands_to_new_servers": {
            "type": "boolean"
          },
          "completed_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "ProductDependentMigrationEstimateTargetCountDto": {
        "required": [
          "total_entities",
          "type"
        ],
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/ProductDependentMigrationTargetTypeDto"
          },
          "total_entities": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "ProductDependentMigrationEstimateVersionDto": {
        "required": [
          "product_version_created_at",
          "product_version_id",
          "target_counts"
        ],
        "type": "object",
        "properties": {
          "product_version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_version_created_at": {
            "type": "string",
            "format": "date-time"
          },
          "target_counts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductDependentMigrationEstimateTargetCountDto"
            }
          }
        },
        "additionalProperties": false
      },
      "ProductDependentMigrationStatusDto": {
        "enum": [
          "invalid",
          "created",
          "completed"
        ],
        "type": "string"
      },
      "ProductDependentMigrationTargetDto": {
        "required": [
          "type",
          "versions"
        ],
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/ProductDependentMigrationTargetTypeDto"
          },
          "versions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductDependentMigrationTargetVersionDto"
            }
          }
        },
        "additionalProperties": false
      },
      "ProductDependentMigrationTargetTypeDto": {
        "enum": [
          "invalid",
          "active_subscriptions",
          "active_unused_delivery_items",
          "non_expirable_delivery_items"
        ],
        "type": "string"
      },
      "ProductDependentMigrationTargetVersionDto": {
        "required": [
          "migrated",
          "new_product_version_id",
          "old_product_version_created_at",
          "old_product_version_id",
          "total_entities_migrated"
        ],
        "type": "object",
        "properties": {
          "old_product_version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "old_product_version_created_at": {
            "type": "string",
            "format": "date-time"
          },
          "new_product_version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "total_entities_migrated": {
            "type": "integer",
            "format": "int32"
          },
          "migrated": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "ProductDownloadableFileDto": {
        "required": [
          "created_at",
          "created_by",
          "id",
          "is_uploaded",
          "product_id",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "is_uploaded": {
            "type": "boolean"
          },
          "file_name": {
            "type": [
              "null",
              "string"
            ]
          },
          "file_content_type": {
            "type": [
              "null",
              "string"
            ]
          },
          "file_size": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int64"
          },
          "file_hash": {
            "type": [
              "null",
              "string"
            ]
          },
          "description": {
            "type": [
              "null",
              "string"
            ]
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          }
        },
        "additionalProperties": false
      },
      "ProductDto": {
        "required": [
          "allow_one_time_purchase",
          "allow_subscription",
          "commands",
          "custom_variable_ids",
          "customer_stock_limit",
          "description",
          "gameservers",
          "id",
          "images",
          "name",
          "payout_splits",
          "price",
          "remove_after_enabled",
          "remove_after_time_scale",
          "remove_after_time_value",
          "required_product_ids",
          "single_game_server_only",
          "slug",
          "sort_order",
          "stock_available",
          "store_id",
          "store_stock_limit",
          "subscription_interval_scale",
          "subscription_interval_value",
          "tags",
          "trial",
          "upselling",
          "version_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "image_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "The URL to the product image."
          },
          "images": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductImageDto"
            },
            "description": "The product's images in display order. The first image is the primary image."
          },
          "slug": {
            "type": "string",
            "description": "The unique slug for the product."
          },
          "name": {
            "type": "string",
            "description": "The display name of the product."
          },
          "description": {
            "type": "string",
            "description": "The detailed description of the product."
          },
          "label": {
            "type": [
              "null",
              "string"
            ],
            "description": "The display label for the product."
          },
          "sort_order": {
            "type": "integer",
            "description": "The sort order for displaying the product.",
            "format": "int32"
          },
          "price": {
            "type": "integer",
            "description": "The price of the product, in the lowest denominator (e.g. cents).",
            "format": "int64"
          },
          "single_game_server_only": {
            "type": "boolean",
            "description": "Indicates whether the product is limited to a single game server."
          },
          "allow_one_time_purchase": {
            "type": "boolean",
            "description": "Indicates whether one-time purchases are allowed."
          },
          "allow_subscription": {
            "type": "boolean",
            "description": "Indicates whether subscription purchases are allowed."
          },
          "subscription_interval_value": {
            "type": "integer",
            "description": "The subscription interval value.",
            "format": "int32"
          },
          "subscription_interval_scale": {
            "$ref": "#/components/schemas/ProductSubscriptionIntervalScale"
          },
          "trial": {
            "$ref": "#/components/schemas/ProductTrialConfigurationDto"
          },
          "upselling": {
            "$ref": "#/components/schemas/ProductUpsellConfigurationDto"
          },
          "remove_after_enabled": {
            "type": "boolean",
            "description": "Indicates whether automatic removal is enabled."
          },
          "remove_after_time_value": {
            "type": "integer",
            "description": "The time value for automatic removal.",
            "format": "int32"
          },
          "remove_after_time_scale": {
            "$ref": "#/components/schemas/ProductRemoveAfterIntervalScale"
          },
          "stock_available": {
            "$ref": "#/components/schemas/ProductStockAvailableDto"
          },
          "store_stock_limit": {
            "$ref": "#/components/schemas/ProductStockLimitDto"
          },
          "customer_stock_limit": {
            "$ref": "#/components/schemas/ProductStockLimitDto"
          },
          "stock_limit_do_not_include_removed": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether removed items should be excluded from stock limits."
          },
          "tags": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductTagDto"
            },
            "description": "The tags associated with the product."
          },
          "gameservers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductGameServerDto"
            },
            "description": "The game servers associated with the product."
          },
          "commands": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductCommandDto"
            },
            "description": "The commands to be executed at different stages."
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "created_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the product was created.",
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the product was last updated.",
            "format": "date-time"
          },
          "deliverable_actions": {
            "$ref": "#/components/schemas/ProductDeliverableActionsDto"
          },
          "metadata": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "type": "string"
            },
            "description": "Additional metadata for the product."
          },
          "payout_splits": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductPayoutSplitDto"
            },
            "description": "The payout splits for revenue distribution."
          },
          "tax_code": {
            "$ref": "#/components/schemas/ProductTaxCode"
          },
          "allow_concurrent_active_items": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether concurrent active items are allowed."
          },
          "is_hidden": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether the product is hidden."
          },
          "is_gifting_disabled": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether gifting is disabled."
          },
          "enabled_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the product becomes enabled.",
            "format": "date-time"
          },
          "enabled_until": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time until which the product remains enabled.",
            "format": "date-time"
          },
          "required_product_ids": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "The IDs of products required for purchasing this product."
          },
          "required_product_all": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether all required products are needed."
          },
          "custom_variable_ids": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "The IDs of associated custom variables."
          },
          "is_gift_cards_disabled": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates if applying gift cards should be disabled on the product."
          },
          "is_coupons_disabled": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates if applying coupons should be disabled on the product."
          },
          "is_affiliate_links_disabled": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates if applying affiliate links should be disabled on the product."
          },
          "tier_group_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false
      },
      "ProductGameServerDto": {
        "required": [
          "enabled",
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "name": {
            "type": "string",
            "description": "The name of the game server.",
            "example": "US 2x TRIO"
          },
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether this game server is enabled."
          }
        },
        "additionalProperties": false
      },
      "ProductImageDto": {
        "required": [
          "media_asset_id",
          "type",
          "url"
        ],
        "type": "object",
        "properties": {
          "media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "url": {
            "type": "string",
            "description": "The public URL the image is served from."
          },
          "type": {
            "$ref": "#/components/schemas/MediaAssetTypeDto"
          }
        },
        "additionalProperties": false,
        "description": "Represents one of a product's images."
      },
      "ProductPayoutSplitDto": {
        "required": [
          "platform_fee",
          "user_id"
        ],
        "type": "object",
        "properties": {
          "user_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "percentage": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The percentage of the payment allocated to the user, in basis points (500 = 5%).\nThe last payout split must have this field set to `null` to receive the remaining portion.",
            "format": "int64"
          },
          "platform_fee": {
            "type": "integer",
            "description": "The platform fee percentage your platform receives, in basis points (500 = 5%).",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "ProductPricingRegionDto": {
        "required": [
          "blended_vat_rate",
          "country_codes",
          "enabled",
          "group_id",
          "id",
          "local_currency",
          "local_currency_fx_rate",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "group_id": {
            "type": "string"
          },
          "local_currency": {
            "type": "string"
          },
          "local_currency_fx_rate": {
            "type": "number",
            "format": "double"
          },
          "blended_vat_rate": {
            "type": "number",
            "format": "double"
          },
          "name": {
            "type": "string"
          },
          "country_codes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "enabled": {
            "type": "boolean"
          },
          "price": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int64"
          },
          "default_price_multiplier": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int64"
          },
          "currency": {
            "type": [
              "null",
              "string"
            ]
          },
          "tax_inclusive": {
            "type": [
              "null",
              "boolean"
            ]
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "ProductPricingRegionGroupDto": {
        "required": [
          "description",
          "id",
          "name",
          "recommended_base_price_multiplier"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "recommended_base_price_multiplier": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "ProductPricingRegionOverrideDto": {
        "type": "object",
        "properties": {
          "price": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int64"
          },
          "enabled": {
            "type": [
              "null",
              "boolean"
            ]
          },
          "currency": {
            "type": [
              "null",
              "string"
            ]
          },
          "tax_inclusive": {
            "type": [
              "null",
              "boolean"
            ]
          }
        },
        "additionalProperties": false
      },
      "ProductRemoveAfterIntervalScale": {
        "enum": [
          "invalid",
          "day",
          "week",
          "month"
        ],
        "type": "string"
      },
      "ProductResult": {
        "required": [
          "id",
          "total"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "total": {
            "type": "integer",
            "format": "int64"
          },
          "product": {
            "$ref": "#/components/schemas/ProductDto"
          }
        },
        "additionalProperties": false
      },
      "ProductStockAvailableDto": {
        "required": [
          "customer_available",
          "store_available"
        ],
        "type": "object",
        "properties": {
          "store_available": {
            "type": "integer",
            "description": "Indicates how many stock is left store-wide.",
            "format": "int32"
          },
          "customer_available": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "ProductStockLimitDto": {
        "required": [
          "enabled",
          "include_trials",
          "time_scale"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether stock limit is enabled."
          },
          "quantity": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The quantity limit.",
            "format": "int32"
          },
          "time_value": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The time value for stock limit period.",
            "format": "int32"
          },
          "time_scale": {
            "$ref": "#/components/schemas/ProductStockTimeScale"
          },
          "include_trials": {
            "type": "boolean",
            "description": "Indicates if trials should be included in the active stock limit calculation."
          }
        },
        "additionalProperties": false
      },
      "ProductStockTimeScale": {
        "enum": [
          "invalid",
          "day",
          "week",
          "month",
          "year"
        ],
        "type": "string"
      },
      "ProductSubscriptionIntervalScale": {
        "enum": [
          "invalid",
          "day",
          "week",
          "month",
          "year"
        ],
        "type": "string"
      },
      "ProductTagDto": {
        "required": [
          "id",
          "name",
          "slug"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "slug": {
            "type": "string",
            "description": "The unique slug for the tag.",
            "example": "packages"
          },
          "name": {
            "type": "string",
            "description": "The display name of the tag.",
            "example": "Packages"
          }
        },
        "additionalProperties": false
      },
      "ProductTaxCode": {
        "enum": [
          "unknown",
          "digital_goods_subscription",
          "digital_goods_permanent",
          "saas",
          "downloaded_software",
          "digital_goods_subscription_gaming",
          "digital_goods_permanent_gaming",
          "iaas",
          "paas",
          "saas_security",
          "saas_storage"
        ],
        "type": "string",
        "description": "Determines the category of the product for taxation purposes.\nContact support for help with setting the correct tax code.",
        "x-enumDescriptions": {
          "unknown": "Unknown tax code.",
          "digital_goods_subscription": "You provide customers access to photographs, audiovisual works, audio works, and books, delivered electronically to a customer for non-permanent access, with right of use conditioned on continued payment to the seller.",
          "digital_goods_permanent": "You provide customers access to photographs, audiovisual works, audio works, and books, delivered electronically to a customer.",
          "saas": "SaaS: Pre-written software, delivered electronically.\n            You provide customers access to a hosted software application, described as computer programs designed to permit the user to perform a group of coordinated functions, tasks, or activities.\n            You are typically responsible for all aspects of making the software service available.",
          "downloaded_software": "Pre-written, non-custom computer software that is delivered electronically for download onto customers' devices/servers. No tangible personal property (e.g. CD-ROM, etc.) is delivered or used in conjunction with the download.",
          "digital_goods_subscription_gaming": "Cloud based or downloaded access to digital gaming services (used by default for game servers).",
          "digital_goods_permanent_gaming": "Permanent digital goods for gaming (not recommended).",
          "iaas": "Infrastructure as a Service: Providing users remote access to data center equipment and computing power.",
          "paas": "Platform as a Service: A cloud computing service bundle that includes both the infrastructure (servers, storage, and networking)\n            and the middleware (development tools, business intelligence services, database management systems) that provides the customer\n            a complete development and deployment environment in the cloud.",
          "saas_security": "Cloud-based SaaS, designed to secure customer data.\n            Pre-written software, delivered electronically, designed specifically to provide protection of computer systems, software,\n            or data against unauthorized access or intrusion.\n            This includes separately charged maintenance and updates delivered electronically, whether included in the cost of the software\n            or charged as a separate line item.",
          "saas_storage": "Cloud-based SaaS, designed to backup customer data.\n            Pre-written software, delivered electronically, designed purely as storage for a customer's data.\n            You provide customers access to a software product solely to facilitate the storage of digital products, digital codes,\n            computer software or master copies of software.\n            This includes separately charged maintenance and updates delivered electronically, whether included in the cost of the software\n            or charged as a separate line item."
        },
        "x-paynow-docs-enum-descriptions": {
          "unknown": "Unknown tax code.",
          "digital_goods_subscription": "You provide customers access to photographs, audiovisual works, audio works, and books, delivered electronically to a customer for non-permanent access, with right of use conditioned on continued payment to the seller.",
          "digital_goods_permanent": "You provide customers access to photographs, audiovisual works, audio works, and books, delivered electronically to a customer.",
          "saas": "SaaS: Pre-written software, delivered electronically.\n            You provide customers access to a hosted software application, described as computer programs designed to permit the user to perform a group of coordinated functions, tasks, or activities.\n            You are typically responsible for all aspects of making the software service available.",
          "downloaded_software": "Pre-written, non-custom computer software that is delivered electronically for download onto customers' devices/servers. No tangible personal property (e.g. CD-ROM, etc.) is delivered or used in conjunction with the download.",
          "digital_goods_subscription_gaming": "Cloud based or downloaded access to digital gaming services (used by default for game servers).",
          "digital_goods_permanent_gaming": "Permanent digital goods for gaming (not recommended).",
          "iaas": "Infrastructure as a Service: Providing users remote access to data center equipment and computing power.",
          "paas": "Platform as a Service: A cloud computing service bundle that includes both the infrastructure (servers, storage, and networking)\n            and the middleware (development tools, business intelligence services, database management systems) that provides the customer\n            a complete development and deployment environment in the cloud.",
          "saas_security": "Cloud-based SaaS, designed to secure customer data.\n            Pre-written software, delivered electronically, designed specifically to provide protection of computer systems, software,\n            or data against unauthorized access or intrusion.\n            This includes separately charged maintenance and updates delivered electronically, whether included in the cost of the software\n            or charged as a separate line item.",
          "saas_storage": "Cloud-based SaaS, designed to backup customer data.\n            Pre-written software, delivered electronically, designed purely as storage for a customer's data.\n            You provide customers access to a software product solely to facilitate the storage of digital products, digital codes,\n            computer software or master copies of software.\n            This includes separately charged maintenance and updates delivered electronically, whether included in the cost of the software\n            or charged as a separate line item."
        }
      },
      "ProductTrialConfigurationDto": {
        "required": [
          "allow_repeat_trials",
          "enabled",
          "new_customer_order_lookback_scale",
          "new_customer_order_lookback_value",
          "new_customers_only",
          "period_scale",
          "period_value",
          "repeat_trial_cooldown_scale",
          "repeat_trial_cooldown_value",
          "revoke_immediately_when_canceled"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indicates if trials should be enabled for the product."
          },
          "period_value": {
            "type": "integer",
            "description": "The trial period value.",
            "format": "int32"
          },
          "period_scale": {
            "$ref": "#/components/schemas/ProductSubscriptionIntervalScale"
          },
          "revoke_immediately_when_canceled": {
            "type": "boolean",
            "description": "Indicates if the trial should be revoked immediately when canceled or at the end of the trial."
          },
          "new_customers_only": {
            "type": "boolean",
            "description": "Restricts trials to customers who have no orders within the lookback period.\nWhen enabled, customers with recent orders will be ineligible for trials."
          },
          "new_customer_order_lookback_value": {
            "type": "integer",
            "description": "The lookback period value for determining if a customer is \"new\".\nOnly used when new_customers_only is enabled.",
            "format": "int32"
          },
          "new_customer_order_lookback_scale": {
            "$ref": "#/components/schemas/ProductSubscriptionIntervalScale"
          },
          "allow_repeat_trials": {
            "type": "boolean",
            "description": "Allows customers to trial again after a cooldown period following their previous trial.\nWhen disabled, customers can only trial once and never become eligible again."
          },
          "repeat_trial_cooldown_value": {
            "type": "integer",
            "description": "The cooldown period value before a customer becomes eligible for another trial.\nOnly used when allow_repeat_trial is enabled.",
            "format": "int32"
          },
          "repeat_trial_cooldown_scale": {
            "$ref": "#/components/schemas/ProductSubscriptionIntervalScale"
          }
        },
        "additionalProperties": false,
        "description": "Represents the configuration for trials of a product"
      },
      "ProductUpsellConfigurationDto": {
        "required": [
          "enabled",
          "recommendations"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indicates if upselling should be enabled for the product.\nIf disabled, the product will never be recommended regardless of the global config."
          },
          "recommendations": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductUpsellRecommendationDto"
            },
            "description": "Upselling recommendation for the product."
          }
        },
        "additionalProperties": false
      },
      "ProductUpsellRecommendationDto": {
        "required": [
          "discount_amount",
          "discount_type",
          "prefer_as_subscription",
          "recommended_product_id",
          "type"
        ],
        "type": "object",
        "properties": {
          "recommended_product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "type": {
            "$ref": "#/components/schemas/UpsellTypeDto"
          },
          "discount_type": {
            "$ref": "#/components/schemas/UpsellDiscountTypeDto"
          },
          "discount_amount": {
            "type": "integer",
            "format": "int64"
          },
          "minimum_base_product_quantity": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int32"
          },
          "minimum_recommended_product_quantity": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int32"
          },
          "quantity_to_add": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int32"
          },
          "prefer_as_subscription": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "ProrationBehaviorDto": {
        "enum": [
          "invalid",
          "immediate",
          "next_billing_period",
          "none"
        ],
        "type": "string",
        "description": "Describes how proration is handled when a subscription change is applied.",
        "x-enumDescriptions": {
          "immediate": "Subscription will be updated instantly, and a proration charge will be applied.",
          "next_billing_period": "Subscription will be updated at the end of the billing period, no proration will be applied.",
          "none": "No proration is applied, subscription is updated instantly."
        },
        "x-paynow-docs-enum-descriptions": {
          "immediate": "Subscription will be updated instantly, and a proration charge will be applied.",
          "next_billing_period": "Subscription will be updated at the end of the billing period, no proration will be applied.",
          "none": "No proration is applied, subscription is updated instantly."
        }
      },
      "PublicPlatformDto": {
        "required": [
          "accent_color",
          "business_name",
          "capabilities",
          "country_code",
          "created_at",
          "description",
          "id",
          "logo_url",
          "name",
          "slug",
          "type",
          "website_url"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "slug": {
            "type": "string"
          },
          "type": {
            "$ref": "#/components/schemas/PlatformType"
          },
          "country_code": {
            "type": "string"
          },
          "business_name": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "website_url": {
            "type": "string"
          },
          "logo_url": {
            "type": "string"
          },
          "accent_color": {
            "type": "string"
          },
          "capabilities": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PlatformCapability"
            }
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "disabled_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "PurchaseFollowUpStoreConfigurationCommandDto": {
        "required": [
          "command",
          "id",
          "online_only",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "command": {
            "type": "string",
            "description": "The command to execute."
          },
          "online_only": {
            "type": "boolean",
            "description": "Indicates if the command should be executed if the player is online."
          }
        },
        "additionalProperties": false,
        "description": "Represents a command associated with the store-level purchase follow uo configuration."
      },
      "PurchaseFollowUpStoreConfigurationDto": {
        "required": [
          "commands",
          "coupon_configuration",
          "enabled",
          "invalid",
          "minimum_order_value",
          "store_id",
          "trigger_after",
          "updated_at",
          "updated_by"
        ],
        "type": "object",
        "properties": {
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "enabled": {
            "type": "boolean",
            "description": "A value indicating whether the abandoned checkout feature is enabled for the store."
          },
          "invalid": {
            "type": "boolean",
            "description": "A value indicating whether the abandoned checkout configuration for the store is invalid."
          },
          "trigger_after": {
            "$ref": "#/components/schemas/Period"
          },
          "minimum_order_value": {
            "type": "integer",
            "description": "The minimum order value required to trigger an abandoned checkout email.",
            "format": "int64"
          },
          "maximum_order_value": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The optional maximum order value beyond which an abandoned checkout email will not be sent.",
            "format": "int64"
          },
          "max_coupons_per_customer_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The optional maximum coupons limit per customer beyond which an abandoned checkout email will not be sent.",
            "format": "int32"
          },
          "max_coupons_per_customer_period": {
            "$ref": "#/components/schemas/Period"
          },
          "max_coupons_global_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The optional maximum coupons limit store wide beyond which an abandoned checkout email will not be sent.",
            "format": "int32"
          },
          "max_coupons_global_period": {
            "$ref": "#/components/schemas/Period"
          },
          "coupon_configuration": {
            "$ref": "#/components/schemas/MarketingCouponConfigurationDto"
          },
          "commands": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PurchaseFollowUpStoreConfigurationCommandDto"
            },
            "description": "The commands you want to execute when the email is sent."
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "updated_at": {
            "type": "string",
            "description": "The date and time when the configuration was last updated.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents the store-level configuration for abandoned checkout settings."
      },
      "PurchaseFollowUpStoreConfigurationUpdateCommandDto": {
        "required": [
          "command",
          "online_only"
        ],
        "type": "object",
        "properties": {
          "command": {
            "type": "string",
            "description": "The command to execute."
          },
          "online_only": {
            "type": "boolean",
            "description": "Indicates if the command should be executed if the player is online."
          }
        },
        "additionalProperties": false,
        "description": "Represents a command associated with the store-level purchase follow uo configuration."
      },
      "PurchaseFollowUpStoreConfigurationUpdateDto": {
        "required": [
          "commands",
          "coupon_configuration",
          "enabled",
          "minimum_order_value",
          "trigger_after"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "A value indicating whether the abandoned checkout feature is enabled for the store."
          },
          "trigger_after": {
            "$ref": "#/components/schemas/Period"
          },
          "minimum_order_value": {
            "type": "integer",
            "description": "The minimum order value required to trigger an abandoned checkout email.",
            "format": "int64"
          },
          "maximum_order_value": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The optional maximum order value beyond which an abandoned checkout email will not be sent.",
            "format": "int64"
          },
          "max_coupons_per_customer_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The optional maximum coupons limit per customer beyond which an abandoned checkout email will not be sent.",
            "format": "int32"
          },
          "max_coupons_per_customer_period": {
            "$ref": "#/components/schemas/Period"
          },
          "max_coupons_global_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The optional maximum coupons limit store wide beyond which an abandoned checkout email will not be sent.",
            "format": "int32"
          },
          "max_coupons_global_period": {
            "$ref": "#/components/schemas/Period"
          },
          "commands": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PurchaseFollowUpStoreConfigurationUpdateCommandDto"
            }
          },
          "coupon_configuration": {
            "$ref": "#/components/schemas/MarketingCouponConfigurationDto"
          }
        },
        "additionalProperties": false,
        "description": "Used for updating the store-level configuration for abandoned checkout settings."
      },
      "QueuedDiscordActionDto": {
        "required": [
          "action_type",
          "delivery_item_id",
          "discord_server_id",
          "enqueued_at",
          "execution_stage",
          "executions",
          "id",
          "product_id",
          "product_version_id",
          "revocation_stages",
          "status",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "execution_stage": {
            "$ref": "#/components/schemas/DiscordActionExecutionStage"
          },
          "status": {
            "$ref": "#/components/schemas/QueuedDiscordActionStatus"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "order_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "delivery_item_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "checkout_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "checkout_line_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "discord_server_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "action_type": {
            "$ref": "#/components/schemas/DiscordActionType"
          },
          "discord_user_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "channel_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "role_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "message": {
            "type": [
              "null",
              "string"
            ]
          },
          "revocation_stages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DiscordActionRevocationStage"
            }
          },
          "enqueued_at": {
            "type": "string",
            "format": "date-time"
          },
          "finalised_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "executions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/QueuedDiscordActionExecutionDto"
            }
          }
        },
        "additionalProperties": false
      },
      "QueuedDiscordActionExecutionDto": {
        "required": [
          "executed_at",
          "execution_status",
          "id",
          "queue_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "queue_id": {
            "type": "integer",
            "format": "int64"
          },
          "executed_at": {
            "type": "string",
            "format": "date-time"
          },
          "execution_status": {
            "$ref": "#/components/schemas/QueuedDiscordActionExecutionStatus"
          },
          "message": {
            "type": [
              "null",
              "string"
            ]
          },
          "trace_id": {
            "type": [
              "null",
              "string"
            ]
          }
        },
        "additionalProperties": false
      },
      "QueuedDiscordActionExecutionStatus": {
        "enum": [
          "success",
          "failure"
        ],
        "type": "string"
      },
      "QueuedDiscordActionStatus": {
        "enum": [
          "active",
          "complete",
          "errored",
          "canceled"
        ],
        "type": "string"
      },
      "QueuedWebhookDto": {
        "required": [
          "created_at",
          "event",
          "executions",
          "id",
          "payload",
          "state",
          "webhook_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "webhook_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "state": {
            "$ref": "#/components/schemas/WebhookStateDto"
          },
          "next_retry": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "event": {
            "$ref": "#/components/schemas/WebhookEventType"
          },
          "payload": { },
          "executions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ExecutedWebhookDto"
            }
          }
        },
        "additionalProperties": false
      },
      "RefundDto": {
        "required": [
          "amount",
          "amount_str",
          "created_at",
          "currency",
          "customer_id",
          "gateway_fee_amount",
          "gateway_fee_amount_str",
          "id",
          "payment_id",
          "platform_fee_amount",
          "platform_fee_amount_str",
          "refund_from_connected_user_balance",
          "status",
          "store_id",
          "store_net_amount",
          "store_net_amount_str",
          "store_refund_amount",
          "store_refund_amount_str",
          "tax_amount",
          "tax_amount_str"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "payment_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "order_line_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "status": {
            "$ref": "#/components/schemas/RefundStatus"
          },
          "failure_reason": {
            "type": [
              "null",
              "string"
            ],
            "description": "Reason for failure if the refund has failed"
          },
          "currency": {
            "type": "string",
            "description": "Three-letter currency code of the refund"
          },
          "amount": {
            "type": "integer",
            "description": "Amount of the refund in smallest currency unit (e.g., cents)",
            "format": "int64"
          },
          "amount_str": {
            "type": "string",
            "description": "String representation of the refund amount, formatted for display"
          },
          "gateway_fee_amount": {
            "type": "integer",
            "description": "Amount of payment processor fees in smallest currency unit",
            "format": "int64"
          },
          "gateway_fee_amount_str": {
            "type": "string",
            "description": "String representation of gateway fee amount, formatted for display"
          },
          "tax_amount": {
            "type": "integer",
            "description": "Amount of tax being refunded in smallest currency unit",
            "format": "int64"
          },
          "tax_amount_str": {
            "type": "string",
            "description": "String representation of tax amount, formatted for display"
          },
          "platform_fee_amount": {
            "type": "integer",
            "description": "Amount of platform fees in smallest currency unit",
            "format": "int64"
          },
          "platform_fee_amount_str": {
            "type": "string",
            "description": "String representation of platform fee amount, formatted for display"
          },
          "store_net_amount": {
            "type": "integer",
            "description": "Net amount for the store after fees in smallest currency unit",
            "format": "int64"
          },
          "store_net_amount_str": {
            "type": "string",
            "description": "String representation of store net amount, formatted for display"
          },
          "store_refund_amount": {
            "type": "integer",
            "description": "Amount of the refund to be paid by the store in smallest currency unit",
            "format": "int64"
          },
          "store_refund_amount_str": {
            "type": "string",
            "description": "String representation of store refund amount, formatted for display"
          },
          "presentment_currency": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional currency code used for presentment to the customer if different from the base currency"
          },
          "presentment_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Optional amount in presentment currency in smallest currency unit",
            "format": "int64"
          },
          "fx_rate": {
            "type": [
              "null",
              "string"
            ],
            "description": "Exchange rate used while refunding. Only present for payments made in non-settlement currency."
          },
          "refund_from_connected_user_balance": {
            "type": "boolean",
            "description": "Indicates whether the refund should be taken from the connected user's balance.\nOnly relevant for platforms."
          },
          "note": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional note explaining why the refund was issued"
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "created_at": {
            "type": "string",
            "description": "Date and time when the refund was created",
            "format": "date-time"
          },
          "approved_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional date and time when the refund was approved",
            "format": "date-time"
          },
          "pending_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional date and time when the refund entered pending status",
            "format": "date-time"
          },
          "completed_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional date and time when the refund was completed",
            "format": "date-time"
          },
          "canceled_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional date and time when the refund was canceled",
            "format": "date-time"
          },
          "failed_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional date and time when the refund failed",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "RefundStatus": {
        "enum": [
          "created",
          "approved",
          "processing",
          "completed",
          "canceled",
          "failed"
        ],
        "type": "string",
        "description": "Represents the current status of a refund in the system",
        "x-enumDescriptions": {
          "created": "Refund has been created but not yet processed",
          "approved": "Refund has been approved but not yet processed\n            (reserved for customer requested refunds)",
          "processing": "Refund is currently being processed by the payment system",
          "completed": "Refund has been successfully completed",
          "canceled": "Refund has been canceled before completion",
          "failed": "Refund processing has failed"
        },
        "x-paynow-docs-enum-descriptions": {
          "created": "Refund has been created but not yet processed",
          "approved": "Refund has been approved but not yet processed\n            (reserved for customer requested refunds)",
          "processing": "Refund is currently being processed by the payment system",
          "completed": "Refund has been successfully completed",
          "canceled": "Refund has been canceled before completion",
          "failed": "Refund processing has failed"
        }
      },
      "ResendCommandsForGameServerRequestDto": {
        "type": "object",
        "properties": {
          "starts_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "ends_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "inventory_item_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "order_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "subscription_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false
      },
      "ResendCommandsForGameServerResponseDto": {
        "required": [
          "enqueued_commands_count"
        ],
        "type": "object",
        "properties": {
          "enqueued_commands_count": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "ResendWebhookDto": {
        "required": [
          "webhook_id"
        ],
        "type": "object",
        "properties": {
          "webhook_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false
      },
      "RevenueBasisDto_V2": {
        "enum": [
          "unspecified",
          "gross",
          "gross_excluding_taxes",
          "net"
        ],
        "type": "string"
      },
      "RoleDto": {
        "required": [
          "created_at",
          "created_by",
          "description",
          "id",
          "name",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "permissions": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "type": "boolean"
            }
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "SaleDiscountTypeDto": {
        "enum": [
          "percent",
          "amount"
        ],
        "type": "string"
      },
      "SaleDto": {
        "required": [
          "apply_to_product_ids",
          "apply_to_tag_ids",
          "begins_at",
          "created_at",
          "created_by",
          "discount_amount",
          "discount_type",
          "duration",
          "duration_in_intervals",
          "enabled",
          "id",
          "minimum_order_value",
          "name",
          "store_id",
          "version_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the sale is enabled."
          },
          "name": {
            "type": "string",
            "description": "The name of the sale."
          },
          "discount_type": {
            "$ref": "#/components/schemas/SaleDiscountTypeDto"
          },
          "discount_amount": {
            "type": "integer",
            "description": "The discount value. For percent discounts, this represents the percentage \nmultiplied by 10 (e.g., 250 = 25%). For amount discounts, this represents \nthe value in the smallest currency unit (e.g., cents).",
            "format": "int32"
          },
          "duration": {
            "$ref": "#/components/schemas/SaleDurationDto"
          },
          "duration_in_intervals": {
            "type": "integer",
            "description": "The number of subscription intervals the coupon is valid for, used if the duration is repeating.",
            "format": "int32"
          },
          "apply_to_product_ids": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "A list of product IDs the sale applies to."
          },
          "apply_to_tag_ids": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "A list of tag IDs the sale applies to."
          },
          "minimum_order_value": {
            "type": "integer",
            "description": "The minimum order value required to apply the sale, in the smallest currency unit (e.g., cents).",
            "format": "int32"
          },
          "begins_at": {
            "type": "string",
            "description": "The date and time when the sale begins.",
            "format": "date-time"
          },
          "ends_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the sale ends.",
            "format": "date-time"
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "created_at": {
            "type": "string",
            "description": "The date and time when the sale was created.",
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the sale was last updated.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents a detailed view of a Sale, including configuration and audit information."
      },
      "SaleDurationDto": {
        "enum": [
          "unspecified",
          "once",
          "forever",
          "repeating"
        ],
        "type": "string"
      },
      "SaleResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "sale": {
            "$ref": "#/components/schemas/SaleDto"
          }
        },
        "additionalProperties": false
      },
      "SalesTaxJurisdictionDto": {
        "required": [
          "name",
          "taxes"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The name of the tax jurisdiction.",
            "example": "EU OSS"
          },
          "taxes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SalesTaxJurisdictionTaxDto"
            },
            "description": "List of taxes applied within this jurisdiction."
          },
          "not_taxed_reason": {
            "type": [
              "null",
              "string"
            ],
            "description": "Explanation for why taxes are not applied, if applicable.\nThis property is null when taxes are applied."
          }
        },
        "additionalProperties": false,
        "description": "Object representing a sales tax jurisdiction and its associated taxes."
      },
      "SalesTaxJurisdictionTaxDto": {
        "required": [
          "tax_amount",
          "tax_name",
          "tax_rate",
          "taxable_amount"
        ],
        "type": "object",
        "properties": {
          "tax_name": {
            "type": "string",
            "description": "The name of the tax."
          },
          "taxable_amount": {
            "type": "string",
            "description": "The amount subject to taxation, formatted as a string."
          },
          "tax_amount": {
            "type": "string",
            "description": "The calculated tax amount, formatted as a string."
          },
          "tax_rate": {
            "type": "string",
            "description": "The rate at which the tax is applied, formatted as a string."
          }
        },
        "additionalProperties": false,
        "description": "Object representing a specific tax within a sales tax jurisdiction."
      },
      "SamsungPayDetailsDto": {
        "type": "object",
        "properties": {
          "buyer_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The buyer identifier assigned by the local payment processor",
            "example": "buyer_abc123"
          }
        },
        "additionalProperties": false,
        "description": "Samsung Pay payment method details"
      },
      "SearchDashboardResponseDto": {
        "required": [
          "affiliate_links",
          "api_keys",
          "bans",
          "coupons",
          "custom_variables",
          "customers",
          "email_deliveries",
          "email_templates",
          "facets",
          "gameservers",
          "giftcards",
          "global_commands",
          "orders",
          "products",
          "sales",
          "stores",
          "subscriptions",
          "tags",
          "tier_groups",
          "trials",
          "webhook_deliveries",
          "webhooks"
        ],
        "type": "object",
        "properties": {
          "stores": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/StoreResult"
            }
          },
          "customers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CustomerResult"
            }
          },
          "orders": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/OrderResult"
            }
          },
          "gameservers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GameserverResult"
            }
          },
          "products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductResult"
            }
          },
          "coupons": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CouponResult"
            }
          },
          "sales": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SaleResult"
            }
          },
          "giftcards": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GiftcardResult"
            }
          },
          "tags": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TagsResult"
            }
          },
          "affiliate_links": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AffiliateLinkResult"
            }
          },
          "trials": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TrialResult"
            }
          },
          "subscriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SubscriptionResult"
            }
          },
          "bans": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BanResult"
            }
          },
          "api_keys": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ApiKeyResult"
            }
          },
          "tier_groups": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TierGroupResult"
            }
          },
          "custom_variables": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CustomVariableResult"
            }
          },
          "global_commands": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GlobalCommandResult"
            }
          },
          "webhooks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WebhookResult"
            }
          },
          "email_templates": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EmailTemplateResult"
            }
          },
          "email_deliveries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EmailDeliveryResult"
            }
          },
          "webhook_deliveries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WebhookDeliveryResult"
            }
          },
          "facets": {
            "type": "object",
            "properties": {
              "unknown": {
                "type": "integer",
                "format": "int64"
              },
              "orders": {
                "type": "integer",
                "format": "int64"
              },
              "trials": {
                "type": "integer",
                "format": "int64"
              },
              "subscriptions": {
                "type": "integer",
                "format": "int64"
              },
              "customers": {
                "type": "integer",
                "format": "int64"
              },
              "coupons": {
                "type": "integer",
                "format": "int64"
              },
              "gameservers": {
                "type": "integer",
                "format": "int64"
              },
              "products": {
                "type": "integer",
                "format": "int64"
              },
              "sales": {
                "type": "integer",
                "format": "int64"
              },
              "api_keys": {
                "type": "integer",
                "format": "int64"
              },
              "bans": {
                "type": "integer",
                "format": "int64"
              },
              "affiliate_links": {
                "type": "integer",
                "format": "int64"
              },
              "tags": {
                "type": "integer",
                "format": "int64"
              },
              "giftcards": {
                "type": "integer",
                "format": "int64"
              },
              "stores": {
                "type": "integer",
                "format": "int64"
              },
              "users": {
                "type": "integer",
                "format": "int64"
              },
              "tickets": {
                "type": "integer",
                "format": "int64"
              },
              "tier_groups": {
                "type": "integer",
                "format": "int64"
              },
              "custom_variables": {
                "type": "integer",
                "format": "int64"
              },
              "global_commands": {
                "type": "integer",
                "format": "int64"
              },
              "webhooks": {
                "type": "integer",
                "format": "int64"
              },
              "email_templates": {
                "type": "integer",
                "format": "int64"
              },
              "email_deliveries": {
                "type": "integer",
                "format": "int64"
              },
              "webhook_deliveries": {
                "type": "integer",
                "format": "int64"
              },
              "payouts": {
                "type": "integer",
                "format": "int64"
              }
            },
            "additionalProperties": false
          }
        },
        "additionalProperties": false
      },
      "SetDiscordActionDto": {
        "required": [
          "action_type",
          "discord_server_id",
          "execution_stage"
        ],
        "type": "object",
        "properties": {
          "discord_server_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "action_type": {
            "$ref": "#/components/schemas/DiscordActionType"
          },
          "execution_stage": {
            "$ref": "#/components/schemas/DiscordActionExecutionStage"
          },
          "revocation_stages": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/DiscordActionRevocationStage"
            }
          },
          "channel_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "role_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "message": {
            "type": [
              "null",
              "string"
            ]
          }
        },
        "additionalProperties": false
      },
      "SetWebstoreActiveRequestDto": {
        "required": [
          "is_active"
        ],
        "type": "object",
        "properties": {
          "is_active": {
            "type": "boolean",
            "description": "Whether the hosted webstore is served to customers. A disabled webstore shows a not-active page."
          }
        },
        "additionalProperties": false,
        "description": "Represents a request to enable or disable a store's hosted webstore."
      },
      "SetWebstoreCustomDomainRequestDto": {
        "required": [
          "domain",
          "verification_type"
        ],
        "type": "object",
        "properties": {
          "domain": {
            "type": "string",
            "description": "The domain to serve the webstore from, without a scheme (e.g., store.example.com)."
          },
          "verification_type": {
            "$ref": "#/components/schemas/WebstoreCustomDomainVerificationTypeDto"
          }
        },
        "additionalProperties": false,
        "description": "Represents a request to attach a custom domain to a webstore."
      },
      "SetWebstoreDefaultTemplateRequestDto": {
        "required": [
          "template_id"
        ],
        "type": "object",
        "properties": {
          "template_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false,
        "description": "Represents a request to set the template a webstore renders."
      },
      "SetWebstoreSlugRequestDto": {
        "required": [
          "slug"
        ],
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "description": "The new slug to serve the webstore from. Slugs are unique across all webstores."
          }
        },
        "additionalProperties": false,
        "description": "Represents a request to change the slug a webstore is served from."
      },
      "StartDataMigrationFromTebexRequestDto": {
        "required": [
          "headless_token",
          "plugin_token"
        ],
        "type": "object",
        "properties": {
          "headless_token": {
            "type": "string",
            "description": "The public-facing Headless API token."
          },
          "plugin_token": {
            "type": "string",
            "description": "An API token associated to a Tebex game server."
          }
        },
        "additionalProperties": false
      },
      "StartDownloadableFileUploadRequestDto": {
        "required": [
          "file_content_type",
          "file_name"
        ],
        "type": "object",
        "properties": {
          "file_name": {
            "type": "string"
          },
          "file_content_type": {
            "type": "string"
          },
          "description": {
            "type": [
              "null",
              "string"
            ]
          }
        },
        "additionalProperties": false
      },
      "StartDownloadableFileUploadResponseDto": {
        "required": [
          "downloadable_file_id",
          "upload_signed_url"
        ],
        "type": "object",
        "properties": {
          "downloadable_file_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "upload_signed_url": {
            "type": "string"
          }
        },
        "additionalProperties": false
      },
      "StatsDimensionTypeDto_V2": {
        "enum": [
          "unspecified",
          "product",
          "gameserver",
          "tag",
          "affiliate_link",
          "coupon",
          "giftcard",
          "payout_id",
          "billing_email",
          "sale",
          "country"
        ],
        "type": "string"
      },
      "StatsDistributionTypeDto_V2": {
        "enum": [
          "unspecified",
          "order_country",
          "payment_method",
          "payment_acceptance",
          "customer_lifecycle",
          "customer_platform"
        ],
        "type": "string"
      },
      "SteamId": {
        "type": "string",
        "additionalProperties": false,
        "description": "A 64-bit Steam account identifier. Accepts string or numeric format.",
        "format": "steam-id",
        "example": "76561197960287930"
      },
      "SteamSkinsDetailsDto": {
        "required": [
          "items"
        ],
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SteamSkinsInventoryItemDetailsDto"
            },
            "description": "The list of Steam inventory items used for payment"
          }
        },
        "additionalProperties": false,
        "description": "Steam Skins payment method details"
      },
      "SteamSkinsInventoryItemDetailsDto": {
        "required": [
          "app_id",
          "id",
          "name",
          "price"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The unique identifier of the Steam item"
          },
          "app_id": {
            "type": "integer",
            "description": "The Steam app ID",
            "format": "int32",
            "example": 730
          },
          "name": {
            "type": "string",
            "description": "The name of the item",
            "example": "AK-47 | Redline"
          },
          "price": {
            "type": "integer",
            "description": "The price of the item in the smallest currency unit",
            "format": "int32",
            "example": 2500
          }
        },
        "additionalProperties": false
      },
      "StoreAlertDto": {
        "required": [
          "admin_visible",
          "created_at",
          "id",
          "metadata",
          "status",
          "store_id",
          "store_visible",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "entity_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "status": {
            "$ref": "#/components/schemas/StoreAlertStatus"
          },
          "type": {
            "$ref": "#/components/schemas/StoreAlertType"
          },
          "custom_title": {
            "type": [
              "null",
              "string"
            ]
          },
          "custom_message": {
            "type": [
              "null",
              "string"
            ]
          },
          "action_required_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "action_link": {
            "type": [
              "null",
              "string"
            ]
          },
          "store_visible": {
            "type": "boolean"
          },
          "admin_visible": {
            "type": "boolean"
          },
          "resolved_by": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "expires_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "resolved_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "metadata": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "StoreAlertStatus": {
        "enum": [
          "info",
          "warning",
          "action_required",
          "resolved"
        ],
        "type": "string"
      },
      "StoreAlertType": {
        "enum": [
          "other",
          "excessive_chargeback_rate",
          "kyc_required",
          "business_details_required",
          "increased_fraud_rate",
          "unsupported_product",
          "product_compliance_check",
          "integration_issue",
          "storefront_compliance",
          "support_inquiry",
          "feature_eligibility",
          "feature_enrolled"
        ],
        "type": "string"
      },
      "StoreBillingDetailsDto": {
        "type": "object",
        "properties": {
          "country": {
            "type": [
              "null",
              "string"
            ],
            "description": "The country of the billing address."
          },
          "state": {
            "type": [
              "null",
              "string"
            ],
            "description": "The state or province of the billing address."
          },
          "city": {
            "type": [
              "null",
              "string"
            ],
            "description": "The city of the billing address."
          },
          "postal_code": {
            "type": [
              "null",
              "string"
            ],
            "description": "The postal code or zip code of the billing address."
          },
          "line_1": {
            "type": [
              "null",
              "string"
            ],
            "description": "The first line of the billing street address."
          },
          "line_2": {
            "type": [
              "null",
              "string"
            ],
            "description": "The second line of the billing street address, if any (apartment, suite, etc.)."
          },
          "tax_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The tax identifier the store is invoiced under, if any."
          }
        },
        "additionalProperties": false,
        "description": "Represents the billing address and tax details a store is invoiced under."
      },
      "StoreBillingStatusDto": {
        "required": [
          "alerts",
          "feature_flags",
          "is_locked",
          "no_billing_details",
          "plan",
          "plan_limits",
          "plan_pricing",
          "revenue_usage",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "is_locked": {
            "type": "boolean"
          },
          "lock_reason": {
            "type": [
              "null",
              "string"
            ]
          },
          "no_billing_details": {
            "type": "boolean"
          },
          "revenue_usage": {
            "type": "integer",
            "format": "int64"
          },
          "plan_limits": {
            "type": "object",
            "additionalProperties": {
              "type": "integer",
              "format": "int64"
            }
          },
          "feature_flags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "alerts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/StoreAlertDto"
            }
          },
          "plan": {
            "$ref": "#/components/schemas/PlanDto"
          },
          "plan_pricing": {
            "$ref": "#/components/schemas/PlanPricingDto"
          },
          "subscription": {
            "$ref": "#/components/schemas/StoreSubscriptionDto"
          },
          "payment_method": {
            "$ref": "#/components/schemas/PaymentMethodDto"
          }
        },
        "additionalProperties": false
      },
      "StoreChargebackDto": {
        "required": [
          "created_at",
          "currency",
          "customer_id",
          "disputed_amount",
          "id",
          "is_refundable",
          "network_case_type",
          "order_id",
          "payment_id",
          "reason",
          "stage",
          "status",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "order_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "payment_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "status": {
            "$ref": "#/components/schemas/TrustChargebackStatus"
          },
          "reason": {
            "$ref": "#/components/schemas/TrustChargebackReason"
          },
          "stage": {
            "$ref": "#/components/schemas/TrustChargebackStage"
          },
          "network_case_type": {
            "$ref": "#/components/schemas/TrustChargebackNetworkCaseType"
          },
          "network_reason_code": {
            "type": [
              "null",
              "string"
            ],
            "description": "The card network's reason code for the chargeback, if available."
          },
          "disputed_amount": {
            "type": "integer",
            "description": "The disputed amount, in the smallest currency unit.",
            "format": "int64"
          },
          "currency": {
            "type": "string",
            "description": "The three-letter ISO currency code of 'disputed_amount', in lowercase."
          },
          "is_refundable": {
            "type": "boolean",
            "description": "Whether the payment can still be refunded."
          },
          "created_at": {
            "type": "string",
            "description": "The date and time the chargeback was opened.",
            "format": "date-time"
          },
          "escalated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time the inquiry escalated to a claim, if it did.",
            "format": "date-time"
          },
          "response_deadline_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time by which a response must be submitted, if one is required.",
            "format": "date-time"
          },
          "closed_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time the chargeback was closed, if it is closed.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents a chargeback or pre-chargeback inquiry raised against a payment."
      },
      "StoreDto": {
        "required": [
          "currency",
          "description",
          "game",
          "id",
          "live_mode",
          "name",
          "owner_id",
          "platform",
          "short_id",
          "slug"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "short_id": {
            "type": "string",
            "description": "The short identifier of the store."
          },
          "owner_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "slug": {
            "type": "string",
            "description": "The URL-safe slug used to identify the store (e.g. \"my-rust-server\")."
          },
          "name": {
            "type": "string",
            "description": "The display name of the store."
          },
          "platform": {
            "type": "string",
            "description": "The platform this store is associated with (e.g. \"rust\", \"minecraft\")."
          },
          "game": {
            "type": "string",
            "description": "Alias for 'platform'. Returns the platform identifier as a game name.",
            "readOnly": true
          },
          "currency": {
            "type": "string",
            "description": "The ISO 4217 currency code used by this store for pricing (e.g. \"usd\", \"eur\")"
          },
          "description": {
            "type": "string",
            "description": "A human-readable description of the store shown to customers and PayNow."
          },
          "website_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "The store's public website URL."
          },
          "contact_email": {
            "type": [
              "null",
              "string"
            ],
            "description": "General contact email address for the store."
          },
          "support_email": {
            "type": [
              "null",
              "string"
            ],
            "description": "Dedicated support email address for customer inquiries."
          },
          "support_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "URL to the store's support portal or help page."
          },
          "integration_type": {
            "type": [
              "null",
              "string"
            ],
            "description": "The integration type used by the store."
          },
          "live_mode": {
            "type": "boolean",
            "description": "When set to true, the store is processing real transactions in live mode."
          },
          "logo_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "URL of the store's full-size logo image."
          },
          "logo_square_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "URL of the store's square/icon logo image."
          },
          "logo_media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "logo_square_media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "minecraft_bedrock_username_prefix": {
            "type": [
              "null",
              "string"
            ],
            "description": "Username prefix used to identify Minecraft Bedrock players (e.g. \".\")."
          },
          "created_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The UTC timestamp when the store was created.",
            "format": "date-time"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The UTC timestamp when the store was last updated.",
            "format": "date-time"
          },
          "onboarding_completed_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The UTC timestamp when the store completed onboarding.",
            "format": "date-time"
          },
          "platform_store_type_association": {
            "$ref": "#/components/schemas/PlatformStoreTypeAssociationDetailsDto"
          }
        },
        "additionalProperties": false,
        "description": "Represents a PayNow store and its associated configuration."
      },
      "StoreMemberDto": {
        "required": [
          "id",
          "user",
          "user_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "user_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "user": {
            "$ref": "#/components/schemas/StoreMemberUserDto"
          },
          "added_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The UTC timestamp when the member was added to the store.",
            "format": "date-time"
          },
          "added_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "role_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false,
        "description": "Represents a member of a PayNow store."
      },
      "StoreMemberUserDto": {
        "required": [
          "id",
          "type"
        ],
        "type": "object",
        "properties": {
          "type": {
            "$ref": "#/components/schemas/PayNowActorType"
          },
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "email": {
            "type": [
              "null",
              "string"
            ],
            "description": "The email address associated with the user.\nOnly visible if you are the store owner."
          },
          "first_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The first name of the actor.\nHidden if the user has a set nickname, and you are not the store owner."
          },
          "last_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The last name of the actor.\nHidden if the user has a set nickname, and you are not the store owner."
          },
          "nickname": {
            "type": [
              "null",
              "string"
            ],
            "description": "The nickname of the user."
          }
        },
        "additionalProperties": false,
        "description": "Represents identity and profile information for a store member."
      },
      "StorePaymentSettingsDto": {
        "required": [
          "adaptive_currency_enabled",
          "block_prepaid_cards",
          "chargeback_coverage",
          "force_3d_secure",
          "max_checkout_amount",
          "promo_code_stacking_behavior",
          "show_adaptive_currency_on_storefront",
          "show_all_payment_methods_for_subscriptions",
          "store_tax_inclusive_pricing"
        ],
        "type": "object",
        "properties": {
          "show_all_payment_methods_for_subscriptions": {
            "type": "boolean",
            "description": "Whether to show all available payment methods for subscription purchases."
          },
          "store_tax_inclusive_pricing": {
            "type": "boolean",
            "description": "Whether store pricing is tax-inclusive."
          },
          "block_prepaid_cards": {
            "$ref": "#/components/schemas/PrepaidCardsBlockingTypeDto"
          },
          "promo_code_stacking_behavior": {
            "$ref": "#/components/schemas/StorePromoCodeStackingBehaviorDto"
          },
          "adaptive_currency_enabled": {
            "type": "boolean",
            "description": "Whether the 'Adaptive Currency' feature is enabled."
          },
          "show_adaptive_currency_on_storefront": {
            "type": "boolean",
            "description": "Whether the displayed currency on the storefront should be the Adaptive Currency by default."
          },
          "max_checkout_amount": {
            "type": "integer",
            "description": "Maximum checkout amount allowed in cents.",
            "format": "int64"
          },
          "force_3d_secure": {
            "type": "boolean",
            "description": "Whether to force 3D Secure authentication for all transactions."
          },
          "chargeback_coverage": {
            "$ref": "#/components/schemas/ChargebackCoverageTypeDto"
          },
          "chargeback_coverage_max_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Maximum per-transaction chargeback coverage amount in cents.",
            "format": "int64"
          }
        },
        "additionalProperties": false,
        "description": "Store payment configuration settings."
      },
      "StorePricingRegionOverrideDto": {
        "type": "object",
        "properties": {
          "default_price_multiplier": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int64"
          },
          "enabled": {
            "type": [
              "null",
              "boolean"
            ]
          },
          "currency": {
            "type": [
              "null",
              "string"
            ]
          },
          "tax_inclusive": {
            "type": [
              "null",
              "boolean"
            ]
          }
        },
        "additionalProperties": false
      },
      "StorePromoCodeStackingBehaviorDto": {
        "enum": [
          "invalid",
          "disabled",
          "enabled",
          "gift_cards_only"
        ],
        "type": "string",
        "description": "Defines the behavior of promo code stacking.",
        "x-enumDescriptions": {
          "invalid": "Invalid state.",
          "disabled": "Promo code stacking is disabled.",
          "enabled": "Promo code stacking is enabled.",
          "gift_cards_only": "Promo code stacking is enabled only for gift cards."
        },
        "x-paynow-docs-enum-descriptions": {
          "invalid": "Invalid state.",
          "disabled": "Promo code stacking is disabled.",
          "enabled": "Promo code stacking is enabled.",
          "gift_cards_only": "Promo code stacking is enabled only for gift cards."
        }
      },
      "StoreRequirementActionParty": {
        "enum": [
          "invalid",
          "store",
          "paynow",
          "payment_processor",
          "payout_provider",
          "kyc_provider",
          "external"
        ],
        "type": "string",
        "description": "Determines the party that needs to perform or requests a verification",
        "x-enumDescriptions": {
          "store": "The associated store",
          "paynow": "We as a platform, RequestedByDetail is the admin actor ID in that case (or null if internal)",
          "payment_processor": "Payment processor, e.g. Stripe",
          "payout_provider": "Payout provider, e.g. Trolley, PayPal",
          "kyc_provider": "KYC provider, e.g. Stripe, Onefootprint",
          "external": "External party, not fitting in any other category, e.g. government, regulators"
        },
        "x-paynow-docs-enum-descriptions": {
          "store": "The associated store",
          "paynow": "We as a platform, RequestedByDetail is the admin actor ID in that case (or null if internal)",
          "payment_processor": "Payment processor, e.g. Stripe",
          "payout_provider": "Payout provider, e.g. Trolley, PayPal",
          "kyc_provider": "KYC provider, e.g. Stripe, Onefootprint",
          "external": "External party, not fitting in any other category, e.g. government, regulators"
        }
      },
      "StoreRequirementCategory": {
        "enum": [
          "invalid",
          "business",
          "kyc",
          "compliance",
          "risk",
          "technical",
          "financial",
          "legal",
          "other"
        ],
        "type": "string",
        "description": "Represents categories of requirements that must be fulfilled for store setup and compliance in the PayNow platform.",
        "x-enumDescriptions": {
          "invalid": "Invalid or unspecified category. Default value that should not be used in production.",
          "business": "Business information and operational requirements.\n            Includes company details, business model, store policies, refund procedures,\n            and operational guidelines for running a store on PayNow.",
          "kyc": "Know Your Customer (KYC) identity verification requirements.\n            Includes government-issued ID verification, proof of address, and identity confirmation\n            as per PayNow's KYC Policy and conducted via any third party KYC partners",
          "compliance": "Regulatory compliance requirements including AML checks and content policies.\n            Covers sanctions screening, FATF checks, prohibited customer/product screening,\n            and content compliance as defined in PayNow's policies.",
          "risk": "Risk management and fraud prevention requirements.\n            Includes transaction monitoring, unusual activity detection, and ongoing\n            risk assessment procedures to protect against fraudulent activities.",
          "technical": "Technical integration and setup requirements.\n            Covers API configuration, webhook setup, platform integration, and any technical\n            prerequisites for store operation.",
          "financial": "Financial setup and verification requirements.\n            Includes payment processing configuration, banking information, Tipalti/Trolley payout setup,\n            tax documentation (W-9, W-8, etc.), and payment method verification.",
          "legal": "Legal agreement and policy acceptance requirements.\n            Covers acceptance of User Agreement, Terms of Service, Privacy Policy,\n            and any other legal documents required by PayNow for store operation.",
          "other": "Other miscellaneous requirements that don't fit into the above categories.\n            Used for special cases or additional requirements specific to certain store types\n            or jurisdictions."
        },
        "x-paynow-docs-enum-descriptions": {
          "invalid": "Invalid or unspecified category. Default value that should not be used in production.",
          "business": "Business information and operational requirements.\n            Includes company details, business model, store policies, refund procedures,\n            and operational guidelines for running a store on PayNow.",
          "kyc": "Know Your Customer (KYC) identity verification requirements.\n            Includes government-issued ID verification, proof of address, and identity confirmation\n            as per PayNow's KYC Policy and conducted via any third party KYC partners",
          "compliance": "Regulatory compliance requirements including AML checks and content policies.\n            Covers sanctions screening, FATF checks, prohibited customer/product screening,\n            and content compliance as defined in PayNow's policies.",
          "risk": "Risk management and fraud prevention requirements.\n            Includes transaction monitoring, unusual activity detection, and ongoing\n            risk assessment procedures to protect against fraudulent activities.",
          "technical": "Technical integration and setup requirements.\n            Covers API configuration, webhook setup, platform integration, and any technical\n            prerequisites for store operation.",
          "financial": "Financial setup and verification requirements.\n            Includes payment processing configuration, banking information, Tipalti/Trolley payout setup,\n            tax documentation (W-9, W-8, etc.), and payment method verification.",
          "legal": "Legal agreement and policy acceptance requirements.\n            Covers acceptance of User Agreement, Terms of Service, Privacy Policy,\n            and any other legal documents required by PayNow for store operation.",
          "other": "Other miscellaneous requirements that don't fit into the above categories.\n            Used for special cases or additional requirements specific to certain store types\n            or jurisdictions."
        }
      },
      "StoreRequirementStatus": {
        "enum": [
          "invalid",
          "pending",
          "under_review",
          "requires_revision",
          "approved",
          "expired",
          "waived",
          "rejected_final"
        ],
        "type": "string",
        "x-enumDescriptions": {
          "pending": "Requirement created, awaiting action",
          "under_review": "Submitted, under review, or awaiting external verification",
          "requires_revision": "Rejected, needs store to resubmit with corrections",
          "approved": "Requirement successfully fulfilled",
          "expired": "Requirement expired and needs renewal",
          "waived": "Requirement waived by PayNow (manual override)",
          "rejected_final": "Requirement fully rejected - usually terminal state for the entire store"
        },
        "x-paynow-docs-enum-descriptions": {
          "pending": "Requirement created, awaiting action",
          "under_review": "Submitted, under review, or awaiting external verification",
          "requires_revision": "Rejected, needs store to resubmit with corrections",
          "approved": "Requirement successfully fulfilled",
          "expired": "Requirement expired and needs renewal",
          "waived": "Requirement waived by PayNow (manual override)",
          "rejected_final": "Requirement fully rejected - usually terminal state for the entire store"
        }
      },
      "StoreRestrictionFlagDto": {
        "enum": [
          "none",
          "payments_disabled",
          "payouts_disabled"
        ],
        "type": "string"
      },
      "StoreResult": {
        "required": [
          "id",
          "store"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store": {
            "$ref": "#/components/schemas/StoreDto"
          }
        },
        "additionalProperties": false
      },
      "StoreSubscriptionDto": {
        "required": [
          "cancel_at_period_end",
          "created_at",
          "currency",
          "gateway",
          "gateway_checkout_id",
          "gateway_payment_method_id",
          "gateway_subscription_id",
          "id",
          "plan_id",
          "renewal_period",
          "status",
          "store_id",
          "user_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "user_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "plan_id": {
            "type": "string"
          },
          "gateway": {
            "type": "string"
          },
          "gateway_subscription_id": {
            "type": "string"
          },
          "gateway_checkout_id": {
            "type": "string"
          },
          "gateway_payment_method_id": {
            "type": "string"
          },
          "currency": {
            "type": "string"
          },
          "status": {
            "$ref": "#/components/schemas/StoreSubscriptionStatus"
          },
          "renewal_period": {
            "$ref": "#/components/schemas/StoreSubscriptionRenewalPeriod"
          },
          "downgrade_period_end_plan_id": {
            "type": [
              "null",
              "string"
            ]
          },
          "cancel_at_period_end": {
            "type": "boolean"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "ended_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "cancel_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "current_period_start": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "current_period_end": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "StoreSubscriptionRenewalPeriod": {
        "enum": [
          "monthly",
          "annually"
        ],
        "type": "string"
      },
      "StoreSubscriptionStatus": {
        "enum": [
          "incomplete",
          "trialing",
          "active",
          "requires_action",
          "canceled"
        ],
        "type": "string"
      },
      "StoreTrustDto": {
        "required": [
          "created_at",
          "events",
          "pending_requirements",
          "restrictions",
          "status",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "status": {
            "$ref": "#/components/schemas/StoreTrustStatusDto"
          },
          "status_reason": {
            "type": [
              "null",
              "string"
            ]
          },
          "restrictions": {
            "$ref": "#/components/schemas/StoreRestrictionFlagDto"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "onboarding_steps": {
            "$ref": "#/components/schemas/StoreTrustOnboardingStepsDto"
          },
          "events": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/StoreTrustEventDto"
            }
          },
          "pending_requirements": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TrustStoreRequirementDto"
            }
          }
        },
        "additionalProperties": false
      },
      "StoreTrustEventDto": {
        "required": [
          "actor",
          "created_at",
          "id",
          "store_id",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "type": {
            "$ref": "#/components/schemas/StoreTrustEventTypeDto"
          },
          "description": {
            "type": [
              "null",
              "string"
            ]
          },
          "store_requirement_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_review_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "actor": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "StoreTrustEventTypeDto": {
        "enum": [
          "invalid",
          "onboarded",
          "escalated_to_review",
          "action_required",
          "restricted",
          "offboarded",
          "reactivated",
          "requirement_added",
          "requirement_submitted",
          "requirement_verified",
          "requirement_rejected",
          "requirement_deadline_missed",
          "requirement_waived",
          "requirement_requires_revision",
          "restriction_added",
          "restriction_lifted",
          "review_scheduled",
          "review_completed",
          "risk_tier_changed",
          "decision_parameters_changed"
        ],
        "type": "string"
      },
      "StoreTrustOnboardingStepsDto": {
        "required": [
          "downloadable_files_added",
          "gameserver_linked",
          "kyc_completed",
          "payout_onboarding_completed",
          "products_created",
          "store_id",
          "store_owner_id",
          "webhooks_active"
        ],
        "type": "object",
        "properties": {
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_owner_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "payout_onboarding_completed": {
            "type": "boolean"
          },
          "kyc_completed": {
            "type": "boolean"
          },
          "products_created": {
            "type": "boolean"
          },
          "gameserver_linked": {
            "type": "boolean"
          },
          "webhooks_active": {
            "type": "boolean"
          },
          "downloadable_files_added": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "StoreTrustStatusDto": {
        "enum": [
          "invalid",
          "pending_review",
          "requires_action",
          "under_review",
          "active",
          "restricted",
          "offboarded"
        ],
        "type": "string"
      },
      "StoreUpsellCheckoutStyleDto": {
        "enum": [
          "unknown",
          "inline",
          "inline_and_prepayment_dialog",
          "dedicated_step"
        ],
        "type": "string"
      },
      "StoreUpsellRecommendationDto": {
        "required": [
          "discount_amount",
          "discount_type",
          "prefer_as_subscription",
          "recommended_product_id",
          "type"
        ],
        "type": "object",
        "properties": {
          "recommended_product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "type": {
            "$ref": "#/components/schemas/UpsellTypeDto"
          },
          "discount_type": {
            "$ref": "#/components/schemas/UpsellDiscountTypeDto"
          },
          "discount_amount": {
            "type": "integer",
            "format": "int64"
          },
          "minimum_base_product_quantity": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int32"
          },
          "quantity_to_add": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int32"
          },
          "prefer_as_subscription": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "StoreUpsellSettingsDto": {
        "required": [
          "automatic_recommendations_discount_amount",
          "automatic_recommendations_discount_type",
          "automatic_recommendations_enabled",
          "checkout_style",
          "enabled",
          "recommendation_overrides",
          "recommendation_overrides_enabled",
          "updated_at",
          "updated_by"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "automatic_recommendations_enabled": {
            "type": "boolean"
          },
          "automatic_recommendations_discount_type": {
            "$ref": "#/components/schemas/UpsellDiscountTypeDto"
          },
          "automatic_recommendations_discount_amount": {
            "type": "integer",
            "format": "int64"
          },
          "recommendation_overrides_enabled": {
            "type": "boolean"
          },
          "recommendation_overrides": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/StoreUpsellRecommendationDto"
            }
          },
          "checkout_style": {
            "$ref": "#/components/schemas/StoreUpsellCheckoutStyleDto"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          }
        },
        "additionalProperties": false
      },
      "StorefrontCustomerDto": {
        "required": [
          "id",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "profile": {
            "$ref": "#/components/schemas/CustomerGenericProfileDto"
          },
          "steam_id": {
            "$ref": "#/components/schemas/SteamId"
          },
          "steam": {
            "$ref": "#/components/schemas/StorefrontCustomerSteamProfileDto"
          },
          "minecraft_uuid": {
            "type": [
              "null",
              "string"
            ],
            "description": "The customer's Minecraft UUID, if they have linked their Minecraft account.\nNot set for offline Minecraft stores. If the platform type is Minecraft - Geyser,\nand the profile is a bedrock account, this will be a UUID generated from the Xbox XUID.",
            "example": "f84c6a79-0a4e-45e0-879b-cd49ebd4c4e2"
          },
          "minecraft": {
            "$ref": "#/components/schemas/StorefrontCustomerMinecraftProfileDto"
          },
          "minecraft_platform": {
            "$ref": "#/components/schemas/CustomerMinecraftPlatform"
          },
          "xbox_xuid": {
            "type": [
              "null",
              "string"
            ],
            "description": "The customer's Xbox XUID, if available."
          },
          "name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The display name for the customer.",
            "example": "m0uka"
          }
        },
        "additionalProperties": false,
        "description": "A storefront representation of a customer in the PayNow system with their associated profiles and metadata."
      },
      "StorefrontCustomerMinecraftProfileDto": {
        "required": [
          "avatar_url",
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The UUID of the Minecraft player.\nIf the platform is Minecraft Offline, this will be the name itself.\nIf the platform is Minecraft Geyser, and this is a Bedrock account, this ID will be an Xbox XUID.",
            "example": "f84c6a79-0a4e-45e0-879b-cd49ebd4c4e2"
          },
          "name": {
            "type": "string",
            "description": "The username of the Minecraft player.",
            "example": "notch"
          },
          "avatar_url": {
            "type": "string",
            "description": "The URL to the player's Minecraft skin rendered as an avatar."
          }
        },
        "additionalProperties": false,
        "description": "A storefront representation of a customers Minecraft profile."
      },
      "StorefrontCustomerSteamProfileDto": {
        "required": [
          "avatar_url",
          "id",
          "name"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/SteamId"
          },
          "name": {
            "type": "string",
            "description": "The display name of the user on Steam."
          },
          "avatar_url": {
            "type": "string",
            "description": "The URL to the user's Steam avatar image."
          }
        },
        "additionalProperties": false,
        "description": "A storefront representation of a customers Steam profile."
      },
      "StorefrontOrderDto": {
        "required": [
          "currency",
          "customer",
          "customer_id",
          "discount_amount",
          "discount_amount_str",
          "giftcard_usage_amount",
          "giftcard_usage_amount_str",
          "id",
          "is_subscription",
          "lines",
          "presentment_currency",
          "presentment_discount_amount",
          "presentment_discount_amount_str",
          "presentment_giftcard_usage_amount",
          "presentment_giftcard_usage_amount_str",
          "presentment_subtotal_amount",
          "presentment_subtotal_amount_str",
          "presentment_tax_amount",
          "presentment_tax_amount_str",
          "presentment_total_amount",
          "presentment_total_amount_str",
          "pretty_id",
          "status",
          "store_id",
          "subtotal_amount",
          "subtotal_amount_str",
          "tax_amount",
          "tax_amount_str",
          "total_amount",
          "total_amount_str",
          "type"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "pretty_id": {
            "type": "string",
            "description": "Human-readable identifier for the order.",
            "readOnly": true
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer": {
            "$ref": "#/components/schemas/StorefrontCustomerDto"
          },
          "status": {
            "$ref": "#/components/schemas/OrderStatus"
          },
          "type": {
            "$ref": "#/components/schemas/OrderType"
          },
          "checkout_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "subscription_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "is_subscription": {
            "type": "boolean",
            "description": "Indicates whether this order is a subscription order."
          },
          "currency": {
            "type": "string",
            "description": "Currency code used for this order."
          },
          "discount_amount": {
            "type": "integer",
            "description": "The total discount amount applied to this order in smallest currency unit",
            "format": "int32",
            "example": 500
          },
          "discount_amount_str": {
            "type": "string",
            "description": "The discount amount formatted as a string",
            "example": "$5.00"
          },
          "subtotal_amount": {
            "type": "integer",
            "description": "The subtotal amount for this order in smallest currency unit",
            "format": "int32",
            "example": 9995
          },
          "subtotal_amount_str": {
            "type": "string",
            "description": "The subtotal amount formatted as a string",
            "example": "$99.95"
          },
          "tax_amount": {
            "type": "integer",
            "description": "The tax amount for this order in smallest currency unit",
            "format": "int32",
            "example": 999
          },
          "tax_amount_str": {
            "type": "string",
            "description": "The tax amount formatted as a string",
            "example": "$9.99"
          },
          "total_amount": {
            "type": "integer",
            "description": "The total amount for this order in smallest currency unit",
            "format": "int32",
            "example": 10494
          },
          "total_amount_str": {
            "type": "string",
            "description": "The total amount formatted as a string",
            "example": "$104.94"
          },
          "giftcard_usage_amount": {
            "type": "integer",
            "description": "The amount of gift card value used for this order in smallest currency unit",
            "format": "int32",
            "example": 0
          },
          "giftcard_usage_amount_str": {
            "type": "string",
            "description": "The gift card usage amount formatted as a string",
            "example": "$0.00"
          },
          "presentment_currency": {
            "type": "string",
            "description": "The presentment currency code used for this order (currency shown to customer)",
            "example": "eur"
          },
          "presentment_subtotal_amount": {
            "type": "integer",
            "description": "The presentment subtotal amount in smallest currency unit",
            "format": "int32",
            "example": 9995
          },
          "presentment_subtotal_amount_str": {
            "type": "string",
            "description": "The presentment subtotal amount formatted as a string",
            "readOnly": true,
            "example": "€99.95"
          },
          "presentment_discount_amount": {
            "type": "integer",
            "description": "The presentment discount amount in smallest currency unit",
            "format": "int32",
            "example": 500
          },
          "presentment_discount_amount_str": {
            "type": "string",
            "description": "The presentment discount amount formatted as a string",
            "readOnly": true,
            "example": "€5.00"
          },
          "presentment_giftcard_usage_amount": {
            "type": "integer",
            "description": "The presentment gift card usage amount in the smallest currency unit",
            "format": "int32",
            "example": 0
          },
          "presentment_giftcard_usage_amount_str": {
            "type": "string",
            "description": "The presentment gift card usage amount formatted as a string",
            "readOnly": true,
            "example": "€0.00"
          },
          "presentment_tax_amount": {
            "type": "integer",
            "description": "The presentment tax amount in smallest currency unit",
            "format": "int32",
            "example": 999
          },
          "presentment_tax_amount_str": {
            "type": "string",
            "description": "The presentment tax amount formatted as a string",
            "readOnly": true,
            "example": "€9.99"
          },
          "presentment_total_amount": {
            "type": "integer",
            "description": "The presentment total amount in the smallest currency unit",
            "format": "int32",
            "example": 10494
          },
          "presentment_total_amount_str": {
            "type": "string",
            "description": "The presentment total amount formatted as a string",
            "readOnly": true,
            "example": "€104.94"
          },
          "billing_cycle_sequence": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Sequence number of the billing cycle, if this order is associated with a subscription.",
            "format": "int32"
          },
          "lines": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/StorefrontOrderLineDto"
            },
            "description": "Line items associated with this order."
          },
          "created_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Date and time when the order was created.",
            "format": "date-time"
          },
          "completed_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Date and time when the order was completed.",
            "format": "date-time"
          },
          "canceled_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Date and time when the order was canceled.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Data transfer object representing a store order."
      },
      "StorefrontOrderLineDto": {
        "required": [
          "checkout_line_id",
          "discount_amount",
          "discount_amount_str",
          "gift",
          "giftcard_usage_amount",
          "giftcard_usage_amount_str",
          "id",
          "presentment_discount_amount",
          "presentment_discount_amount_str",
          "presentment_giftcard_usage_amount",
          "presentment_giftcard_usage_amount_str",
          "presentment_subtotal_amount",
          "presentment_subtotal_amount_str",
          "presentment_tax_amount",
          "presentment_tax_amount_str",
          "presentment_total_amount",
          "presentment_total_amount_str",
          "price",
          "price_str",
          "product_id",
          "product_image_url",
          "product_name",
          "product_version_id",
          "quantity",
          "subtotal_amount",
          "subtotal_amount_str",
          "tax_amount",
          "tax_amount_str",
          "tax_inclusive",
          "total_amount",
          "total_amount_str"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "checkout_line_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "subscription_line_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "trial_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_name": {
            "type": "string",
            "description": "Name of the product associated with this order line."
          },
          "product_image_url": {
            "type": "string",
            "description": "URL for the product image."
          },
          "subscription_interval_value": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Numeric value of the subscription billing interval, if this line is a subscription.",
            "format": "int32"
          },
          "subscription_interval_scale": {
            "type": [
              "null",
              "string"
            ],
            "description": "Scale of the subscription billing interval (e.g., \"day\", \"month\", \"year\"), if applicable."
          },
          "gift": {
            "type": "boolean",
            "description": "Indicates whether this order line is a gift to another customer."
          },
          "gift_to_customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "gift_to_customer": {
            "$ref": "#/components/schemas/StorefrontCustomerDto"
          },
          "price": {
            "type": "integer",
            "description": "The unit price of the product in the smallest currency unit (e.g., cents)",
            "format": "int32",
            "example": 1999
          },
          "price_str": {
            "type": "string",
            "description": "The unit price of the product formatted as a string",
            "example": "$19.99"
          },
          "quantity": {
            "type": "integer",
            "description": "The quantity of the product in this order line",
            "format": "int32",
            "example": 1
          },
          "discount_amount": {
            "type": "integer",
            "description": "The discount amount (from sales, coupons, and affiliate links) applied to this order line",
            "format": "int32",
            "example": 0
          },
          "discount_amount_str": {
            "type": "string",
            "description": "The discount amount formatted as a string",
            "example": "$0.00"
          },
          "giftcard_usage_amount": {
            "type": "integer",
            "description": "The amount of gift card used for this order line",
            "format": "int32",
            "example": 0
          },
          "giftcard_usage_amount_str": {
            "type": "string",
            "description": "The gift card usage amount formatted as a string",
            "example": "$0.00"
          },
          "subtotal_amount": {
            "type": "integer",
            "description": "The subtotal amount for this order line",
            "format": "int32",
            "example": 1999
          },
          "subtotal_amount_str": {
            "type": "string",
            "description": "The subtotal amount formatted as a string",
            "example": "$19.99"
          },
          "tax_amount": {
            "type": "integer",
            "description": "The tax amount for this order line",
            "format": "int32",
            "example": 200
          },
          "tax_amount_str": {
            "type": "string",
            "description": "The tax amount formatted as a string",
            "example": "$2.00"
          },
          "total_amount": {
            "type": "integer",
            "description": "The total amount for this order line",
            "format": "int32",
            "example": 2199
          },
          "total_amount_str": {
            "type": "string",
            "description": "The total amount formatted as a string",
            "example": "$21.99"
          },
          "presentment_subtotal_amount": {
            "type": "integer",
            "description": "The presentment subtotal amount for this order line",
            "format": "int32",
            "example": 1999
          },
          "presentment_subtotal_amount_str": {
            "type": "string",
            "description": "The presentment subtotal amount formatted as a string",
            "readOnly": true,
            "example": "€19.99"
          },
          "presentment_discount_amount": {
            "type": "integer",
            "description": "The presentment discount amount for this order line",
            "format": "int32",
            "example": 0
          },
          "presentment_discount_amount_str": {
            "type": "string",
            "description": "The presentment discount amount formatted as a string",
            "readOnly": true,
            "example": "€0.00"
          },
          "presentment_tax_amount": {
            "type": "integer",
            "description": "The presentment tax amount for this order line",
            "format": "int32",
            "example": 200
          },
          "presentment_tax_amount_str": {
            "type": "string",
            "description": "The presentment tax amount formatted as a string",
            "readOnly": true,
            "example": "€2.00"
          },
          "presentment_giftcard_usage_amount": {
            "type": "integer",
            "description": "The presentment gift card usage amount for this order line",
            "format": "int32",
            "example": 0
          },
          "presentment_giftcard_usage_amount_str": {
            "type": "string",
            "description": "The presentment gift card usage amount formatted as a string",
            "readOnly": true,
            "example": "€0.00"
          },
          "presentment_total_amount": {
            "type": "integer",
            "description": "The presentment total amount for this order line",
            "format": "int32",
            "example": 2199
          },
          "presentment_total_amount_str": {
            "type": "string",
            "description": "The presentment total amount formatted as a string",
            "readOnly": true,
            "example": "€21.99"
          },
          "selected_gameserver_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "tax_inclusive": {
            "type": "boolean",
            "description": "Indicates whether tax is included in the base price, or added on top",
            "example": false
          },
          "pricing_region_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The regional pricing region ID for this order line, null if no regional pricing set",
            "example": "eu"
          },
          "custom_variables": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "$ref": "#/components/schemas/CustomVariableLineItemDto"
            },
            "description": "Key-value pair of selected custom variables for this order."
          }
        },
        "additionalProperties": false,
        "description": "Represents a line item within an order."
      },
      "StorefrontStoreDto": {
        "required": [
          "creator_currency",
          "currency",
          "game",
          "id",
          "live_mode",
          "name",
          "platform",
          "slug"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "slug": {
            "type": "string",
            "description": "The URL-friendly identifier for the store, used in store URLs.",
            "example": "m0ukas-awesome-store"
          },
          "name": {
            "type": "string",
            "description": "The display name of the store shown to customers.",
            "example": "m0uka's awesome store"
          },
          "platform": {
            "type": "string",
            "description": "The platform or the game of the store.",
            "example": "rust"
          },
          "game": {
            "type": "string",
            "description": "The game of the store. Equivalent to the `platform` for backwards compatibility.",
            "readOnly": true
          },
          "currency": {
            "type": "string",
            "description": "The three-letter ISO currency code used for pricing in this store.\nIf using the Adaptive Currency feature, this will be updated to reflect customer's local currency\n(based on passed in IP / country headers).",
            "example": "eur"
          },
          "creator_currency": {
            "type": "string",
            "description": "The three-letter ISO currency code signifying the main currency of the store.",
            "example": "usd"
          },
          "description": {
            "type": [
              "null",
              "string"
            ],
            "description": "A detailed description of the store. Only present for some platform types."
          },
          "website_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "The URL of the store's main website, if not using Hosted Webstores."
          },
          "support_email": {
            "type": [
              "null",
              "string"
            ],
            "description": "The email address customers can use to contact store support.",
            "example": "support@example.com"
          },
          "support_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "The URL of the store's support page."
          },
          "integration_type": {
            "type": [
              "null",
              "string"
            ],
            "description": "The type of integration this store uses with external systems."
          },
          "live_mode": {
            "type": "boolean",
            "description": "Indicates whether the store is in live mode (true) or test mode (false)."
          },
          "logo_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "The URL to the store's main logo image."
          },
          "logo_square_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "The URL to the store's square logo image."
          },
          "created_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the store was created.",
            "format": "date-time"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the store was last updated.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents a store entity within the storefront system."
      },
      "SubscriptionBillingAmountDto": {
        "required": [
          "currency",
          "discount",
          "subtotal",
          "tax",
          "total"
        ],
        "type": "object",
        "properties": {
          "currency": {
            "type": "string",
            "description": "ISO 4217 currency code, in lowercase."
          },
          "subtotal": {
            "type": "integer",
            "description": "Base amount before discounts or tax, in smallest currency units.",
            "format": "int64"
          },
          "discount": {
            "type": "integer",
            "description": "Total discount applied, in smallest currency units.",
            "format": "int64"
          },
          "tax": {
            "type": "integer",
            "description": "Tax amount, in smallest currency units.",
            "format": "int64"
          },
          "total": {
            "type": "integer",
            "description": "Amount due after discounts and tax, in smallest currency units.",
            "format": "int64"
          }
        },
        "additionalProperties": false,
        "description": "Represents a billing amount breakdown for a subscription."
      },
      "SubscriptionCancelFlowDto": {
        "required": [
          "subscription_id"
        ],
        "type": "object",
        "properties": {
          "subscription_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false,
        "description": "Portal flow for cancelling a specific subscription"
      },
      "SubscriptionChangeAmountDto": {
        "required": [
          "currency",
          "discount",
          "subtotal",
          "tax",
          "total"
        ],
        "type": "object",
        "properties": {
          "currency": {
            "type": "string",
            "description": "ISO 4217 currency code, in lowercase."
          },
          "subtotal": {
            "type": "integer",
            "description": "Base amount before discounts or tax, in smallest currency units.",
            "format": "int64"
          },
          "discount": {
            "type": "integer",
            "description": "Total discount applied, in smallest currency units.",
            "format": "int64"
          },
          "tax": {
            "type": "integer",
            "description": "Tax amount, in smallest currency units.",
            "format": "int64"
          },
          "total": {
            "type": "integer",
            "description": "Amount due after discounts and tax, in smallest currency units.",
            "format": "int64"
          }
        },
        "additionalProperties": false,
        "description": "Pricing breakdown for a subscription change, in the smallest units of the given currency (e.g. cents)."
      },
      "SubscriptionChangeDto": {
        "required": [
          "created_at",
          "id",
          "lines",
          "next_billing_amount",
          "next_billing_presentment_amount",
          "off_session",
          "prorated_amount",
          "proration_behavior",
          "status",
          "subscription_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "subscription_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "prorated_order_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "status": {
            "$ref": "#/components/schemas/SubscriptionChangeStatusDto"
          },
          "proration_behavior": {
            "$ref": "#/components/schemas/ProrationBehaviorDto"
          },
          "off_session": {
            "type": "boolean",
            "description": "Whether this change was initiated without active customer interaction."
          },
          "prorated_amount": {
            "$ref": "#/components/schemas/SubscriptionChangeProratedAmountDto"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "applied_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          },
          "lines": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SubscriptionChangeLineDto"
            }
          },
          "next_billing_amount": {
            "$ref": "#/components/schemas/SubscriptionChangeAmountDto"
          },
          "next_billing_presentment_amount": {
            "$ref": "#/components/schemas/SubscriptionChangeAmountDto"
          }
        },
        "additionalProperties": false,
        "description": "A pending or applied change to a subscription."
      },
      "SubscriptionChangeLineAmountDto": {
        "required": [
          "currency",
          "discount",
          "subtotal",
          "tax",
          "total"
        ],
        "type": "object",
        "properties": {
          "currency": {
            "type": "string",
            "description": "ISO 4217 currency code in lowercase."
          },
          "subtotal": {
            "type": "integer",
            "description": "Base amount before discounts or tax, in smallest currency units.",
            "format": "int64"
          },
          "discount": {
            "type": "integer",
            "description": "Total discount applied, in smallest currency units.",
            "format": "int64"
          },
          "tax": {
            "type": "integer",
            "description": "Tax amount, in smallest currency units.",
            "format": "int64"
          },
          "total": {
            "type": "integer",
            "description": "Amount due after discounts and tax, in smallest currency units.",
            "format": "int64"
          }
        },
        "additionalProperties": false,
        "description": "Pricing breakdown for a single subscription change line, in the smallest units of the given currency (e.g. cents)."
      },
      "SubscriptionChangeLineDto": {
        "required": [
          "amount",
          "id",
          "is_deleted",
          "presentment_amount",
          "price",
          "product",
          "prorated_amount",
          "prorated_presentment_amount",
          "remaining_minutes",
          "tax_inclusive",
          "total_minutes"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "subscription_line_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "is_deleted": {
            "type": "boolean",
            "description": "Whether this line is being removed by the change."
          },
          "tax_inclusive": {
            "type": "boolean",
            "description": "Whether tax is included in the base price."
          },
          "price": {
            "type": "integer",
            "description": "Base price in smallest settlement currency units.",
            "format": "int64"
          },
          "product": {
            "$ref": "#/components/schemas/SubscriptionChangeLineProductDto"
          },
          "amount": {
            "$ref": "#/components/schemas/SubscriptionChangeLineAmountDto"
          },
          "presentment_amount": {
            "$ref": "#/components/schemas/SubscriptionChangeLineAmountDto"
          },
          "prorated_amount": {
            "type": "integer",
            "description": "Prorated charge for this line in smallest settlement currency units.",
            "format": "int64"
          },
          "prorated_presentment_amount": {
            "type": "integer",
            "description": "Prorated charge for this line in smallest presentment currency units.",
            "format": "int64"
          },
          "remaining_minutes": {
            "type": "integer",
            "description": "Minutes remaining in the billing period at the time of change - used to calculate proration.",
            "format": "int64"
          },
          "total_minutes": {
            "type": "integer",
            "description": "Total minutes in the billing period - used to calculate proration.",
            "format": "int64"
          }
        },
        "additionalProperties": false,
        "description": "A single line item within a subscription change."
      },
      "SubscriptionChangeLineProductDto": {
        "required": [
          "custom_variables",
          "id",
          "name",
          "version_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "name": {
            "type": "string",
            "description": "Display name of the product."
          },
          "image_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "URL of the product image, if set."
          },
          "selected_gameserver_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "pricing_region_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The pricing region used to determine the price, if applicable."
          },
          "custom_variables": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/CustomVariableLineItemDto"
            },
            "description": "Custom variables set on this line item, keyed by variable identifier."
          }
        },
        "additionalProperties": false,
        "description": "The product associated with a subscription change line."
      },
      "SubscriptionChangeProratedAmountDto": {
        "required": [
          "currency",
          "presentment_currency",
          "presentment_prorated_amount",
          "prorated_amount"
        ],
        "type": "object",
        "properties": {
          "currency": {
            "type": "string",
            "description": "ISO 4217 settlement currency code, in lowercase."
          },
          "prorated_amount": {
            "type": "integer",
            "description": "Total prorated charge in smallest settlement currency units, including tax.",
            "format": "int64"
          },
          "presentment_currency": {
            "type": "string",
            "description": "ISO 4217 presentment currency code, in lowercase."
          },
          "presentment_prorated_amount": {
            "type": "integer",
            "description": "Total prorated charge in smallest presentment currency units, including tax.",
            "format": "int64"
          }
        },
        "additionalProperties": false,
        "description": "The total prorated charge for a subscription change, expressed in both settlement and presentment currencies."
      },
      "SubscriptionChangeStatusDto": {
        "enum": [
          "invalid",
          "pending_payment",
          "pending_renewal",
          "applied",
          "canceled",
          "pending_verification"
        ],
        "type": "string",
        "description": "Represents the status of a subscription change.",
        "x-enumDescriptions": {
          "pending_payment": "The change is pending payment before it can be applied.",
          "pending_renewal": "The change will be applied at the next renewal.",
          "applied": "The change has been applied to the subscription.",
          "canceled": "The change was canceled and will not be applied.",
          "pending_verification": "The change requires a verification code sent to the customer's e-mail."
        },
        "x-paynow-docs-enum-descriptions": {
          "pending_payment": "The change is pending payment before it can be applied.",
          "pending_renewal": "The change will be applied at the next renewal.",
          "applied": "The change has been applied to the subscription.",
          "canceled": "The change was canceled and will not be applied.",
          "pending_verification": "The change requires a verification code sent to the customer's e-mail."
        }
      },
      "SubscriptionDto": {
        "required": [
          "cancel_at_period_end",
          "coupon_ids",
          "created_at",
          "currency",
          "customer",
          "discount_amount",
          "discount_amount_str",
          "gift",
          "id",
          "initial_discount_amount",
          "initial_discount_amount_str",
          "initial_giftcard_usage_amount",
          "initial_giftcard_usage_amount_str",
          "initial_subtotal_amount",
          "initial_subtotal_amount_str",
          "initial_tax_amount",
          "initial_tax_amount_str",
          "initial_total_amount",
          "initial_total_amount_str",
          "interval_scale",
          "interval_value",
          "lines",
          "next_billing_amount",
          "next_billing_presentment_amount",
          "past_due",
          "pretty_id",
          "price",
          "status",
          "store_id",
          "subtotal_amount",
          "subtotal_amount_str",
          "tax_amount",
          "tax_amount_str",
          "tax_inclusive",
          "tax_jurisdictions",
          "total_amount",
          "total_amount_str"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "pretty_id": {
            "type": "string",
            "description": "Human-readable identifier for the subscription."
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer": {
            "$ref": "#/components/schemas/CustomerDto"
          },
          "payment_method_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "payment_method": {
            "$ref": "#/components/schemas/PaymentMethodDto"
          },
          "pending_change": {
            "$ref": "#/components/schemas/SubscriptionChangeDto"
          },
          "next_billing_amount": {
            "$ref": "#/components/schemas/SubscriptionBillingAmountDto"
          },
          "next_billing_presentment_amount": {
            "$ref": "#/components/schemas/SubscriptionBillingAmountDto"
          },
          "status": {
            "$ref": "#/components/schemas/SubscriptionStatusDto"
          },
          "coupon_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "coupon_ids": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "Identifiers of coupons applied to this subscription."
          },
          "coupon_repeating_ends_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Date when a repeating coupon ends for this subscription.",
            "format": "date-time",
            "deprecated": true
          },
          "affiliate_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "checkout_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "checkout_line_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "billing_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Name used for billing purposes."
          },
          "billing_email": {
            "type": [
              "null",
              "string"
            ],
            "description": "Email used for billing purposes."
          },
          "billing_country": {
            "type": [
              "null",
              "string"
            ],
            "description": "Country code used for billing purposes."
          },
          "billing_tax_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The tax identification number used for this order (for B2B transactions)"
          },
          "tax_jurisdictions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SalesTaxJurisdictionDto"
            },
            "description": "List of tax jurisdictions applicable to this subscription."
          },
          "customer_ip": {
            "type": [
              "null",
              "string"
            ],
            "description": "IP address of the customer at the time of subscription."
          },
          "gift": {
            "type": "boolean",
            "description": "Indicates whether this subscription is a gift.",
            "readOnly": true,
            "deprecated": true
          },
          "gift_to_customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "gift_to_customer": {
            "$ref": "#/components/schemas/CustomerDto"
          },
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "Name of the product associated with this subscription.",
            "readOnly": true,
            "deprecated": true
          },
          "product_image_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "URL for the product image.",
            "readOnly": true,
            "deprecated": true
          },
          "interval_value": {
            "type": "integer",
            "description": "Numeric value of the billing interval.",
            "format": "int32"
          },
          "interval_scale": {
            "$ref": "#/components/schemas/ProductSubscriptionIntervalScale"
          },
          "currency": {
            "type": "string",
            "description": "Currency code used for billing this subscription."
          },
          "tax_inclusive": {
            "type": "boolean",
            "description": "Indicates whether tax is included in the base price itself.",
            "readOnly": true,
            "deprecated": true
          },
          "price": {
            "type": "integer",
            "description": "Base price of the subscription in smallest currency units (e.g., cents).",
            "format": "int64",
            "readOnly": true,
            "deprecated": true
          },
          "price_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the price.",
            "readOnly": true,
            "deprecated": true
          },
          "discount_amount": {
            "type": "integer",
            "description": "Amount of discount applied in smallest currency units.",
            "format": "int64"
          },
          "discount_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the discount amount.",
            "readOnly": true
          },
          "subtotal_amount": {
            "type": "integer",
            "description": "Subtotal amount in smallest currency units.",
            "format": "int64"
          },
          "subtotal_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the subtotal amount.",
            "readOnly": true
          },
          "tax_amount": {
            "type": "integer",
            "description": "Tax amount in smallest currency units.",
            "format": "int64"
          },
          "tax_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the tax amount.",
            "readOnly": true
          },
          "total_amount": {
            "type": "integer",
            "description": "Total amount in smallest currency units.",
            "format": "int64"
          },
          "total_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the total amount.",
            "readOnly": true
          },
          "initial_discount_amount": {
            "type": "integer",
            "description": "Initial discount amount in smallest currency units for the first billing cycle.",
            "format": "int64"
          },
          "initial_discount_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the initial discount amount.",
            "readOnly": true
          },
          "initial_subtotal_amount": {
            "type": "integer",
            "description": "Initial subtotal amount in smallest currency units for the first billing cycle.",
            "format": "int64"
          },
          "initial_subtotal_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the initial subtotal amount.",
            "readOnly": true
          },
          "initial_giftcard_usage_amount": {
            "type": "integer",
            "description": "Initial gift card usage amount in smallest currency units.",
            "format": "int64"
          },
          "initial_giftcard_usage_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the initial gift card usage amount.",
            "readOnly": true
          },
          "initial_tax_amount": {
            "type": "integer",
            "description": "Initial tax amount in smallest currency units for the first billing cycle.",
            "format": "int64"
          },
          "initial_tax_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the initial tax amount.",
            "readOnly": true
          },
          "initial_total_amount": {
            "type": "integer",
            "description": "Initial total amount in smallest currency units for the first billing cycle.",
            "format": "int64"
          },
          "initial_total_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the initial total amount.",
            "readOnly": true
          },
          "presentment_currency": {
            "type": [
              "null",
              "string"
            ],
            "description": "Presentment currency code (currency shown to customer)."
          },
          "presentment_subtotal_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Presentment subtotal amount in smallest currency units.",
            "format": "int64"
          },
          "presentment_subtotal_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the presentment subtotal amount.",
            "readOnly": true
          },
          "presentment_discount_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Presentment discount amount in smallest currency units.",
            "format": "int64"
          },
          "presentment_discount_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the presentment discount amount.",
            "readOnly": true
          },
          "presentment_tax_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Presentment tax amount in smallest currency units.",
            "format": "int64"
          },
          "presentment_tax_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the presentment tax amount.",
            "readOnly": true
          },
          "presentment_total_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Presentment total amount in smallest currency units.",
            "format": "int64"
          },
          "presentment_total_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the presentment total amount.",
            "readOnly": true
          },
          "initial_presentment_discount_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Initial presentment discount amount in smallest currency units for the first billing cycle.",
            "format": "int64"
          },
          "initial_presentment_discount_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the initial presentment discount amount.",
            "readOnly": true
          },
          "initial_presentment_subtotal_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Initial presentment subtotal amount in smallest currency units for the first billing cycle.",
            "format": "int64"
          },
          "initial_presentment_subtotal_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the initial presentment subtotal amount.",
            "readOnly": true
          },
          "initial_presentment_giftcard_usage_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Initial presentment gift card usage amount in smallest currency units.",
            "format": "int64"
          },
          "initial_presentment_giftcard_usage_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the initial presentment gift card usage amount.",
            "readOnly": true
          },
          "initial_presentment_tax_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Initial presentment tax amount in smallest currency units for the first billing cycle.",
            "format": "int64"
          },
          "initial_presentment_tax_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the initial presentment tax amount.",
            "readOnly": true
          },
          "initial_presentment_total_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Initial presentment total amount in smallest currency units for the first billing cycle.",
            "format": "int64"
          },
          "initial_presentment_total_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the initial presentment total amount.",
            "readOnly": true
          },
          "fx_rate": {
            "type": [
              "null",
              "string"
            ],
            "description": "The foreign exchange rate applied (if presentment currency differs from settlement currency)."
          },
          "pricing_region_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "Identifier for the pricing region associated with this subscription.",
            "readOnly": true,
            "deprecated": true
          },
          "current_period_start": {
            "type": [
              "null",
              "string"
            ],
            "description": "Start date of the current billing period.",
            "format": "date-time"
          },
          "current_period_end": {
            "type": [
              "null",
              "string"
            ],
            "description": "End date of the current billing period.",
            "format": "date-time"
          },
          "billing_cycle_sequence": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Sequence number of the current billing cycle.",
            "format": "int32"
          },
          "next_attempt_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Date and time when the next payment attempt will occur.",
            "format": "date-time"
          },
          "attempt_count": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Number of payment attempts made for the current billing cycle.",
            "format": "int32"
          },
          "created_at": {
            "type": "string",
            "description": "Date and time when the subscription was created.",
            "format": "date-time"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Date and time when the subscription was last updated.",
            "format": "date-time"
          },
          "active_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Date and time when the subscription became active.",
            "format": "date-time"
          },
          "canceled_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Date and time when the subscription was canceled.",
            "format": "date-time"
          },
          "cancel_reason": {
            "type": [
              "null",
              "string"
            ],
            "description": "Reason provided for cancellation."
          },
          "cancellation_requested_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "Date and time when a subscription cancellation (cancel_at_period_end) was requested.",
            "format": "date-time"
          },
          "cancel_at_period_end": {
            "type": "boolean",
            "description": "Whether the subscription will be canceled at the end of the billing period.",
            "readOnly": true
          },
          "past_due": {
            "type": "boolean",
            "description": "Whether the subscription is past due, and is in a dunning (retrying) state."
          },
          "lines": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SubscriptionLineDto"
            },
            "description": "Line items associated with this subscription."
          }
        },
        "additionalProperties": false,
        "description": "Data transfer object representing a store subscription."
      },
      "SubscriptionLineDto": {
        "required": [
          "currency",
          "discount_amount",
          "discount_amount_str",
          "id",
          "initial_discount_amount",
          "initial_discount_amount_str",
          "initial_giftcard_usage_amount",
          "initial_giftcard_usage_amount_str",
          "initial_subtotal_amount",
          "initial_subtotal_amount_str",
          "initial_tax_amount",
          "initial_tax_amount_str",
          "initial_total_amount",
          "initial_total_amount_str",
          "price",
          "product_id",
          "product_name",
          "product_version_id",
          "store_id",
          "subscription_id",
          "subtotal_amount",
          "subtotal_amount_str",
          "tax_amount",
          "tax_amount_str",
          "tax_inclusive",
          "total_amount",
          "total_amount_str"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "subscription_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "checkout_line_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "initial_order_line_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "pricing_region_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "Identifier for the pricing region associated with this subscription line."
          },
          "gift_to_customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "selected_gameserver_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "sale_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "sale_version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "trial_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_name": {
            "type": "string",
            "description": "Name of the product associated with this subscription line."
          },
          "product_image_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "URL for the product image."
          },
          "tax_inclusive": {
            "type": "boolean",
            "description": "Indicates whether tax is included in the base price itself."
          },
          "currency": {
            "type": "string",
            "description": "Currency code for this subscription line."
          },
          "price": {
            "type": "integer",
            "description": "Base price of the subscription line in smallest currency units (e.g., cents).",
            "format": "int64"
          },
          "discount_amount": {
            "type": "integer",
            "description": "Amount of discount applied in smallest currency units.",
            "format": "int64"
          },
          "discount_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the discount amount.",
            "readOnly": true
          },
          "subtotal_amount": {
            "type": "integer",
            "description": "Subtotal amount in smallest currency units.",
            "format": "int64"
          },
          "subtotal_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the subtotal amount.",
            "readOnly": true
          },
          "tax_amount": {
            "type": "integer",
            "description": "Tax amount in smallest currency units.",
            "format": "int64"
          },
          "tax_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the tax amount.",
            "readOnly": true
          },
          "total_amount": {
            "type": "integer",
            "description": "Total amount in smallest currency units.",
            "format": "int64"
          },
          "total_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the total amount.",
            "readOnly": true
          },
          "initial_discount_amount": {
            "type": "integer",
            "description": "Initial discount amount in smallest currency units for the first billing cycle.",
            "format": "int64"
          },
          "initial_discount_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the initial discount amount.",
            "readOnly": true
          },
          "initial_subtotal_amount": {
            "type": "integer",
            "description": "Initial subtotal amount in smallest currency units for the first billing cycle.",
            "format": "int64"
          },
          "initial_subtotal_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the initial subtotal amount.",
            "readOnly": true
          },
          "initial_giftcard_usage_amount": {
            "type": "integer",
            "description": "Initial gift card usage amount in smallest currency units.",
            "format": "int64"
          },
          "initial_giftcard_usage_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the initial gift card usage amount.",
            "readOnly": true
          },
          "initial_tax_amount": {
            "type": "integer",
            "description": "Initial tax amount in smallest currency units for the first billing cycle.",
            "format": "int64"
          },
          "initial_tax_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the initial tax amount.",
            "readOnly": true
          },
          "initial_total_amount": {
            "type": "integer",
            "description": "Initial total amount in smallest currency units for the first billing cycle.",
            "format": "int64"
          },
          "initial_total_amount_str": {
            "type": "string",
            "description": "Formatted string representation of the initial total amount.",
            "readOnly": true
          },
          "presentment_currency": {
            "type": [
              "null",
              "string"
            ],
            "description": "Presentment currency code (currency shown to customer)."
          },
          "presentment_subtotal_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Presentment subtotal amount in smallest currency units.",
            "format": "int64"
          },
          "presentment_subtotal_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the presentment subtotal amount.",
            "readOnly": true
          },
          "presentment_discount_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Presentment discount amount in smallest currency units.",
            "format": "int64"
          },
          "presentment_discount_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the presentment discount amount.",
            "readOnly": true
          },
          "presentment_tax_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Presentment tax amount in smallest currency units.",
            "format": "int64"
          },
          "presentment_tax_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the presentment tax amount.",
            "readOnly": true
          },
          "presentment_total_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Presentment total amount in smallest currency units.",
            "format": "int64"
          },
          "presentment_total_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the presentment total amount.",
            "readOnly": true
          },
          "initial_presentment_discount_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Initial presentment discount amount in smallest currency units for the first billing cycle.",
            "format": "int64"
          },
          "initial_presentment_discount_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the initial presentment discount amount.",
            "readOnly": true
          },
          "initial_presentment_subtotal_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Initial presentment subtotal amount in smallest currency units for the first billing cycle.",
            "format": "int64"
          },
          "initial_presentment_subtotal_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the initial presentment subtotal amount.",
            "readOnly": true
          },
          "initial_presentment_giftcard_usage_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Initial presentment gift card usage amount in smallest currency units.",
            "format": "int64"
          },
          "initial_presentment_giftcard_usage_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the initial presentment gift card usage amount.",
            "readOnly": true
          },
          "initial_presentment_tax_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Initial presentment tax amount in smallest currency units for the first billing cycle.",
            "format": "int64"
          },
          "initial_presentment_tax_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the initial presentment tax amount.",
            "readOnly": true
          },
          "initial_presentment_total_amount": {
            "type": [
              "null",
              "integer"
            ],
            "description": "Initial presentment total amount in smallest currency units for the first billing cycle.",
            "format": "int64"
          },
          "initial_presentment_total_amount_str": {
            "type": [
              "null",
              "string"
            ],
            "description": "Formatted string representation of the initial presentment total amount.",
            "readOnly": true
          }
        },
        "additionalProperties": false,
        "description": "Represents a line item within a subscription."
      },
      "SubscriptionPaymentMethodUpdateFlowDto": {
        "required": [
          "subscription_id"
        ],
        "type": "object",
        "properties": {
          "subscription_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false,
        "description": "Portal flow for updating the payment method of a specific subscription"
      },
      "SubscriptionRenewalPeriodDto": {
        "enum": [
          "monthly",
          "annually"
        ],
        "type": "string",
        "description": "Specifies how often a subscription renews.",
        "x-enumDescriptions": {
          "monthly": "The subscription renews every month.",
          "annually": "The subscription renews every year."
        },
        "x-paynow-docs-enum-descriptions": {
          "monthly": "The subscription renews every month.",
          "annually": "The subscription renews every year."
        }
      },
      "SubscriptionResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "subscription": {
            "$ref": "#/components/schemas/SubscriptionDto"
          }
        },
        "additionalProperties": false
      },
      "SubscriptionStatusDto": {
        "enum": [
          "invalid",
          "created",
          "active",
          "canceled"
        ],
        "type": "string",
        "description": "Represents the current state of a subscription.",
        "x-enumDescriptions": {
          "created": "The subscription has been created but is not yet active.",
          "active": "The subscription is currently active and will renew.",
          "canceled": "The subscription has been canceled and will no longer renew."
        },
        "x-paynow-docs-enum-descriptions": {
          "created": "The subscription has been created but is not yet active.",
          "active": "The subscription is currently active and will renew.",
          "canceled": "The subscription has been canceled and will no longer renew."
        }
      },
      "SubscriptionsSummaryDto_V2": {
        "required": [
          "active_subscription_count",
          "revenue_basis"
        ],
        "type": "object",
        "properties": {
          "revenue_basis": {
            "$ref": "#/components/schemas/RevenueBasisDto_V2"
          },
          "monthly_recurring_revenue": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "average_subscription_value": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "active_subscription_count": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "SubscriptionsSummaryForRangeDto_V2": {
        "required": [
          "churned_subscription_count",
          "new_subscription_count",
          "renewal_due_count",
          "renewal_paid_count",
          "revenue_basis"
        ],
        "type": "object",
        "properties": {
          "revenue_basis": {
            "$ref": "#/components/schemas/RevenueBasisDto_V2"
          },
          "new_subscription_count": {
            "type": "integer",
            "format": "int64"
          },
          "churned_revenue": {
            "$ref": "#/components/schemas/MoneyDto_V2"
          },
          "churned_subscription_count": {
            "type": "integer",
            "format": "int64"
          },
          "renewal_due_count": {
            "type": "integer",
            "format": "int64"
          },
          "renewal_paid_count": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "SwishDetailsDto": {
        "type": "object",
        "properties": {
          "fingerprint": {
            "type": [
              "null",
              "string"
            ],
            "description": "A unique fingerprint for this Swish account",
            "example": "fingerprint_xyz789"
          },
          "verified_phone_last4": {
            "type": [
              "null",
              "string"
            ],
            "description": "The last 4 digits of the phone number of the Swish account",
            "example": 6789
          }
        },
        "additionalProperties": false,
        "description": "Swish payment method details"
      },
      "TagDto": {
        "required": [
          "created_at",
          "created_by",
          "enabled",
          "id",
          "name",
          "slug",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "created_at": {
            "type": "string",
            "description": "When the tag was created",
            "format": "date-time"
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "name": {
            "type": "string",
            "description": "The unique name for the tag."
          },
          "slug": {
            "type": "string",
            "description": "The unique slug for the tag."
          },
          "description": {
            "type": [
              "null",
              "string"
            ],
            "description": "The description of the tag."
          },
          "image_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "The Image URL associated with the tag."
          },
          "media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether this tag is enabled."
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "When the tag was last updated.",
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          }
        },
        "additionalProperties": false
      },
      "TagsResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "tag": {
            "$ref": "#/components/schemas/TagDto"
          }
        },
        "additionalProperties": false
      },
      "TierGroupDto": {
        "required": [
          "created_at",
          "created_by",
          "id",
          "name",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "name": {
            "type": "string",
            "description": "The name of the tier group."
          },
          "created_at": {
            "type": "string",
            "description": "When the tier group was created.",
            "format": "date-time"
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "When was the tier group last updated.",
            "format": "date-time"
          },
          "updated_by": {
            "$ref": "#/components/schemas/ActorDto"
          }
        },
        "additionalProperties": false
      },
      "TierGroupResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "tier_group": {
            "$ref": "#/components/schemas/TierGroupDto"
          }
        },
        "additionalProperties": false
      },
      "TimeSeriesChartDto": {
        "required": [
          "chart",
          "primary_value",
          "primary_value_comparison",
          "series",
          "unit"
        ],
        "type": "object",
        "properties": {
          "chart": {
            "type": "string"
          },
          "currency": {
            "type": [
              "null",
              "string"
            ]
          },
          "primary_value": {
            "type": "number",
            "format": "double"
          },
          "primary_value_comparison": {
            "type": "number",
            "format": "double"
          },
          "unit": {
            "$ref": "#/components/schemas/TimeSeriesUnitDto"
          },
          "series": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TimeSeriesChartSeriesDto"
            }
          }
        },
        "additionalProperties": false
      },
      "TimeSeriesChartDto_V2": {
        "required": [
          "metric_type",
          "primary_value",
          "primary_value_comparison",
          "series",
          "unit"
        ],
        "type": "object",
        "properties": {
          "metric_type": {
            "$ref": "#/components/schemas/TimeSeriesChartMetricTypeDto_V2"
          },
          "dimension_type": {
            "$ref": "#/components/schemas/StatsDimensionTypeDto_V2"
          },
          "dimension_id": {
            "type": [
              "null",
              "string"
            ]
          },
          "revenue_basis": {
            "$ref": "#/components/schemas/RevenueBasisDto_V2"
          },
          "currency": {
            "type": [
              "null",
              "string"
            ]
          },
          "primary_value": {
            "type": "number",
            "format": "double"
          },
          "primary_value_comparison": {
            "type": "number",
            "format": "double"
          },
          "unit": {
            "$ref": "#/components/schemas/TimeSeriesUnitDto_V2"
          },
          "series": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TimeSeriesChartSeriesDto_V2"
            }
          }
        },
        "additionalProperties": false
      },
      "TimeSeriesChartMetricTypeDto_V2": {
        "enum": [
          "unspecified",
          "payment_volume",
          "payment_count",
          "order_volume",
          "order_count",
          "new_customer_count",
          "subscription_count",
          "trial_count",
          "abandoned_checkout_count",
          "purchase_followup_count",
          "upsell_count",
          "player_count",
          "mrr",
          "tax_volume",
          "gateway_fee_volume",
          "platform_fee_volume",
          "refund_volume",
          "customer_lifecycle_volume"
        ],
        "type": "string"
      },
      "TimeSeriesChartSeriesDto": {
        "required": [
          "data",
          "label"
        ],
        "type": "object",
        "properties": {
          "label": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TimeSeriesChartSeriesEntryDto"
            }
          }
        },
        "additionalProperties": false
      },
      "TimeSeriesChartSeriesDto_V2": {
        "required": [
          "entries",
          "label"
        ],
        "type": "object",
        "properties": {
          "label": {
            "type": "string"
          },
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TimeSeriesChartSeriesEntryDto_V2"
            }
          }
        },
        "additionalProperties": false
      },
      "TimeSeriesChartSeriesEntryDto": {
        "required": [
          "interval_end",
          "interval_start",
          "value"
        ],
        "type": "object",
        "properties": {
          "interval_start": {
            "type": "string",
            "format": "date-time"
          },
          "interval_end": {
            "type": "string",
            "format": "date-time"
          },
          "value": {
            "type": "number",
            "format": "double"
          }
        },
        "additionalProperties": false
      },
      "TimeSeriesChartSeriesEntryDto_V2": {
        "required": [
          "interval_end",
          "interval_start",
          "value"
        ],
        "type": "object",
        "properties": {
          "interval_start": {
            "type": "string",
            "format": "date-time"
          },
          "interval_end": {
            "type": "string",
            "format": "date-time"
          },
          "value": {
            "type": "number",
            "format": "double"
          }
        },
        "additionalProperties": false
      },
      "TimeSeriesUnitDto": {
        "enum": [
          "hour",
          "day",
          "week",
          "month",
          "quarter",
          "year"
        ],
        "type": "string"
      },
      "TimeSeriesUnitDto_V2": {
        "enum": [
          "hour",
          "day",
          "week",
          "month",
          "quarter",
          "year"
        ],
        "type": "string"
      },
      "ToggleStorePaymentMethodTypeRequestDto": {
        "required": [
          "enabled"
        ],
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "TrialDto": {
        "required": [
          "created_at",
          "customer",
          "customer_id",
          "id",
          "period_scale",
          "period_value",
          "pretty_id",
          "product_id",
          "product_name",
          "product_version_id",
          "status",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "pretty_id": {
            "type": "string",
            "description": "The human-readable formatted version of the trial identifier.",
            "readOnly": true
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "checkout_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "checkout_line_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer": {
            "$ref": "#/components/schemas/CustomerDto"
          },
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_name": {
            "type": "string",
            "description": "The name of the product being trialed."
          },
          "product_image_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "The URL of the product image, if available."
          },
          "period_value": {
            "type": "integer",
            "description": "The duration value of the trial period.",
            "format": "int32"
          },
          "period_scale": {
            "type": "string",
            "description": "The timescale unit for the trial period (e.g., \"days\", \"weeks\", \"months\")."
          },
          "starts_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the trial period starts, if applicable.",
            "format": "date-time"
          },
          "ends_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the trial period ends, if applicable.",
            "format": "date-time"
          },
          "status": {
            "$ref": "#/components/schemas/TrialStatusDto"
          },
          "created_at": {
            "type": "string",
            "description": "The date and time when the trial was created.",
            "format": "date-time"
          },
          "canceled_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the trial was canceled, if applicable.",
            "format": "date-time"
          },
          "canceled_by": {
            "$ref": "#/components/schemas/ActorDto"
          }
        },
        "additionalProperties": false
      },
      "TrialEligibilityOverrideDto": {
        "required": [
          "created_at",
          "created_by",
          "customer_id",
          "expires_at",
          "id",
          "pretty_id",
          "product_id",
          "product_name",
          "store_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "pretty_id": {
            "type": "string",
            "description": "The human-readable formatted version of the override identifier.",
            "readOnly": true
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_name": {
            "type": "string",
            "description": "The name of the product associated with this override."
          },
          "product_image_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "The URL of the product image, if available."
          },
          "created_at": {
            "type": "string",
            "description": "The date and time when this override was created.",
            "format": "date-time"
          },
          "created_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "expires_at": {
            "type": "string",
            "description": "The date and time when this override expires and is no longer valid.",
            "format": "date-time"
          },
          "used_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when this override was used to start a trial, if applicable.",
            "format": "date-time"
          },
          "used_on_trial_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "note": {
            "type": [
              "null",
              "string"
            ],
            "description": "An optional note or comment about this override."
          },
          "deleted_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when this override was deleted, if applicable.",
            "format": "date-time"
          },
          "deleted_by": {
            "$ref": "#/components/schemas/ActorDto"
          }
        },
        "additionalProperties": false
      },
      "TrialResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "trial": {
            "$ref": "#/components/schemas/TrialDto"
          }
        },
        "additionalProperties": false
      },
      "TrialStatusDto": {
        "enum": [
          "created",
          "active",
          "canceled",
          "completed"
        ],
        "type": "string",
        "x-enumDescriptions": {
          "created": "The trial has been created but is not yet active.",
          "active": "The trial is currently active.",
          "canceled": "The trial has been canceled.",
          "completed": "The trial has been completed."
        },
        "x-paynow-docs-enum-descriptions": {
          "created": "The trial has been created but is not yet active.",
          "active": "The trial is currently active.",
          "canceled": "The trial has been canceled.",
          "completed": "The trial has been completed."
        }
      },
      "TrialsSummaryDto_V2": {
        "required": [
          "active_trial_count"
        ],
        "type": "object",
        "properties": {
          "active_trial_count": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "TrialsSummaryForRangeDto_V2": {
        "required": [
          "canceled_trial_count",
          "converted_trial_count",
          "started_trial_count"
        ],
        "type": "object",
        "properties": {
          "started_trial_count": {
            "type": "integer",
            "format": "int64"
          },
          "canceled_trial_count": {
            "type": "integer",
            "format": "int64"
          },
          "converted_trial_count": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "TrustChargebackNetworkCaseType": {
        "enum": [
          "unspecified",
          "chargeback",
          "inquiry",
          "compliance",
          "block",
          "resolution"
        ],
        "type": "string",
        "description": "Specifies the type of case the card network opened for the chargeback.",
        "x-enumDescriptions": {
          "unspecified": "No card network case type is available, for example for PayPal disputes.",
          "chargeback": "A formal chargeback where the disputed funds are withdrawn.",
          "inquiry": "A pre-chargeback inquiry from the issuer.",
          "compliance": "A network compliance case filed outside the regular dispute process.",
          "block": "The network blocked the dispute before it became a chargeback. No funds move.",
          "resolution": "The dispute was resolved by automatically refunding the customer."
        },
        "x-paynow-docs-enum-descriptions": {
          "unspecified": "No card network case type is available, for example for PayPal disputes.",
          "chargeback": "A formal chargeback where the disputed funds are withdrawn.",
          "inquiry": "A pre-chargeback inquiry from the issuer.",
          "compliance": "A network compliance case filed outside the regular dispute process.",
          "block": "The network blocked the dispute before it became a chargeback. No funds move.",
          "resolution": "The dispute was resolved by automatically refunding the customer."
        }
      },
      "TrustChargebackReason": {
        "enum": [
          "invalid",
          "product_not_received",
          "product_not_as_described",
          "unauthorized",
          "credit_not_processed",
          "duplicate_charge",
          "incorrect_amount",
          "subscription_canceled",
          "general"
        ],
        "type": "string",
        "description": "Specifies the reason the customer gave for the chargeback.",
        "x-enumDescriptions": {
          "invalid": "The reason is unknown.",
          "product_not_received": "The customer says the product or service was not received.",
          "product_not_as_described": "The customer says the product or service was not as described.",
          "unauthorized": "The customer says they did not authorize the payment.",
          "credit_not_processed": "The customer says a promised refund or credit was not processed.",
          "duplicate_charge": "The customer says they were charged more than once.",
          "incorrect_amount": "The customer says they were charged the wrong amount.",
          "subscription_canceled": "The customer says they were charged after canceling a subscription.",
          "general": "Any other reason."
        },
        "x-paynow-docs-enum-descriptions": {
          "invalid": "The reason is unknown.",
          "product_not_received": "The customer says the product or service was not received.",
          "product_not_as_described": "The customer says the product or service was not as described.",
          "unauthorized": "The customer says they did not authorize the payment.",
          "credit_not_processed": "The customer says a promised refund or credit was not processed.",
          "duplicate_charge": "The customer says they were charged more than once.",
          "incorrect_amount": "The customer says they were charged the wrong amount.",
          "subscription_canceled": "The customer says they were charged after canceling a subscription.",
          "general": "Any other reason."
        }
      },
      "TrustChargebackStage": {
        "enum": [
          "invalid",
          "inquiry",
          "claim"
        ],
        "type": "string",
        "description": "Specifies the stage of a chargeback.",
        "x-enumDescriptions": {
          "invalid": "The stage is unknown.",
          "inquiry": "A pre-chargeback inquiry. No funds are withdrawn yet, and a refund may resolve it.",
          "claim": "A formal claim where the disputed funds are at stake."
        },
        "x-paynow-docs-enum-descriptions": {
          "invalid": "The stage is unknown.",
          "inquiry": "A pre-chargeback inquiry. No funds are withdrawn yet, and a refund may resolve it.",
          "claim": "A formal claim where the disputed funds are at stake."
        }
      },
      "TrustChargebackStatus": {
        "enum": [
          "invalid",
          "needs_response",
          "under_review",
          "won",
          "lost",
          "closed",
          "prevented"
        ],
        "type": "string",
        "description": "Specifies the status of a chargeback.",
        "x-enumDescriptions": {
          "invalid": "The status is unknown.",
          "needs_response": "The chargeback is open and awaiting a response.",
          "under_review": "A response was submitted and the chargeback is being reviewed.",
          "won": "The chargeback was resolved in the store's favor.",
          "lost": "The chargeback was resolved in the customer's favor.",
          "closed": "The inquiry was closed without escalating to a chargeback.",
          "prevented": "The chargeback was prevented before it was filed, see 'network_case_type' for how."
        },
        "x-paynow-docs-enum-descriptions": {
          "invalid": "The status is unknown.",
          "needs_response": "The chargeback is open and awaiting a response.",
          "under_review": "A response was submitted and the chargeback is being reviewed.",
          "won": "The chargeback was resolved in the store's favor.",
          "lost": "The chargeback was resolved in the customer's favor.",
          "closed": "The inquiry was closed without escalating to a chargeback.",
          "prevented": "The chargeback was prevented before it was filed, see 'network_case_type' for how."
        }
      },
      "TrustStoreRequirementDto": {
        "required": [
          "category",
          "code",
          "created_at",
          "id",
          "metadata",
          "name",
          "requested_by",
          "restricts_capabilities",
          "status",
          "store_id",
          "submissions"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "template_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "Template ID if this requirement was created from a template. Null for ad-hoc requirements."
          },
          "originating_flag_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "category": {
            "$ref": "#/components/schemas/StoreRequirementCategory"
          },
          "code": {
            "type": "string",
            "description": "Unique code identifying the type of requirement. Copied from template or custom for ad-hoc requirements."
          },
          "name": {
            "type": "string",
            "description": "Human-readable name of the requirement. Copied from template or custom for ad-hoc requirements."
          },
          "description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Detailed description explaining what the store needs to provide. Copied from template or custom for ad-hoc requirements."
          },
          "schema": {
            "type": "null",
            "description": "JSON schema defining the form fields, validation rules, and document requirements"
          },
          "metadata": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Additional metadata for this requirement (stored as JSON)"
          },
          "status": {
            "$ref": "#/components/schemas/StoreRequirementStatus"
          },
          "requested_by": {
            "$ref": "#/components/schemas/StoreRequirementActionParty"
          },
          "requested_by_detail": {
            "type": [
              "null",
              "string"
            ],
            "description": "Specifies the specific requester entity (e.g., \"stripe\", \"trolley\", or admin user ID)\nFree-form string for internal records"
          },
          "created_at": {
            "type": "string",
            "description": "When this requirement was created",
            "format": "date-time"
          },
          "updated_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "When this requirement was last updated",
            "format": "date-time"
          },
          "deadline_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "When this requirement must be completed by (optional)",
            "format": "date-time"
          },
          "submitted_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "When the store submitted their response to this requirement",
            "format": "date-time"
          },
          "verified_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "When this requirement was verified and approved",
            "format": "date-time"
          },
          "rejected_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "When this requirement was rejected for not meeting standards",
            "format": "date-time"
          },
          "restricts_capabilities": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Store capabilities that are restricted until this requirement is satisfied"
          },
          "submissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TrustStoreRequirementSubmissionDto"
            },
            "description": "Associated submissions for this requriement."
          }
        },
        "additionalProperties": false
      },
      "TrustStoreRequirementSubmissionDto": {
        "required": [
          "id",
          "store_id",
          "store_requirement_field_id",
          "store_requirement_id",
          "submitted_at",
          "submitted_by"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_requirement_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_requirement_field_id": {
            "type": "string",
            "description": "The identifier of the specific field within the store requirement."
          },
          "text_value": {
            "type": [
              "null",
              "string"
            ],
            "description": "The text value submitted for this field, if applicable."
          },
          "file_id": {
            "type": [
              "null",
              "string"
            ],
            "description": "The identifier of the uploaded file, if a file was submitted."
          },
          "file_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The original name of the uploaded file."
          },
          "file_content_type": {
            "type": [
              "null",
              "string"
            ],
            "description": "The MIME content type of the uploaded file."
          },
          "file_size_bytes": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The size of the uploaded file in bytes.",
            "format": "int64"
          },
          "submitted_at": {
            "type": "string",
            "description": "The timestamp when this submission was made.",
            "format": "date-time"
          },
          "submitted_by": {
            "$ref": "#/components/schemas/ActorDto"
          },
          "submitted_by_ip_address": {
            "type": [
              "null",
              "string"
            ],
            "description": "The IP address from which the submission was made."
          },
          "submitted_by_user_agent": {
            "type": [
              "null",
              "string"
            ],
            "description": "The user agent string of the client that made the submission."
          }
        },
        "additionalProperties": false
      },
      "UnqueueCommandsRequestDto": {
        "required": [
          "attempt_ids"
        ],
        "type": "object",
        "properties": {
          "attempt_ids": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            }
          }
        },
        "additionalProperties": false
      },
      "UnqueueCommandsResponseDto": {
        "required": [
          "unqueued_count"
        ],
        "type": "object",
        "properties": {
          "unqueued_count": {
            "type": "integer",
            "format": "int64"
          }
        },
        "additionalProperties": false
      },
      "UpdateAffiliateLinkDto": {
        "type": "object",
        "properties": {
          "wallet_id": {
            "type": "string",
            "description": "The identifier of the wallet that receives the affiliate commission payouts."
          },
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the affiliate link is enabled."
          },
          "code": {
            "type": "string",
            "description": "The unique code associated with the affiliate link."
          },
          "referer_type": {
            "$ref": "#/components/schemas/AffiliateLinkRefererTypeDto"
          },
          "tracking_length_days": {
            "type": "integer",
            "description": "The number of days a customer's referral is tracked after following the affiliate link.",
            "format": "int32"
          },
          "apply_for_subscriptions": {
            "type": "boolean",
            "description": "Whether the affiliate earns commission on subscription renewals.\nMust be enabled for 'commission_amount_steps' past the first cycle to apply - when disabled, only the initial purchase earns commission."
          },
          "discount_type": {
            "$ref": "#/components/schemas/AffiliateLinkDiscountTypeDto"
          },
          "discount_amount": {
            "type": "integer",
            "description": "The discount amount, in the smallest currency unit (e.g., cents) for fixed discounts, or tenths of a percent (e.g., 125 = 12.5%) for percentage discounts.",
            "format": "int64"
          },
          "commission_type": {
            "$ref": "#/components/schemas/AffiliateLinkCommissionTypeDto"
          },
          "commission_amount": {
            "type": "integer",
            "description": "The commission amount, in tenths of a percent (e.g., 125 = 12.5%) for percentage commissions.",
            "format": "int64"
          },
          "commission_amount_steps": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/AffiliateLinkCommissionAmountStepDto"
            },
            "description": "Per-cycle commission overrides. Requires 'apply_for_subscriptions' to be enabled for billing cycles past 1.\nWhen empty, the base commission amount applies to every renewal. When steps are defined, each renewal cycle pays its matching steps amount.\nCycles without a matching step earn no commission, except cycles past the last step when 'last_commission_amount_step_repeats' is true."
          },
          "last_commission_amount_step_repeats": {
            "type": "boolean",
            "description": "Whether the last commission amount steps rate continues to apply to all billing cycles past the last step.\nWhen false, cycles past the last step earn no commission."
          }
        }
      },
      "UpdateCheckoutStyleDto": {
        "type": "object",
        "properties": {
          "font_family": {
            "type": "string",
            "description": "The CSS font family used for text on the checkout, or null to use the default font."
          },
          "border_radius": {
            "type": "integer",
            "description": "The corner radius applied to buttons, inputs and panels on the checkout, in pixels, or null to\nuse the default radius.",
            "format": "int32"
          },
          "color_primary": {
            "type": "string",
            "description": "The accent colour used for primary buttons and highlights, as a CSS colour value, or null to\nuse the default."
          },
          "color_elements": {
            "type": "string",
            "description": "The background colour of panels and cards on the checkout, as a CSS colour value, or null to\nuse the default."
          },
          "color_input": {
            "type": "string",
            "description": "The background colour of input fields, as a CSS colour value, or null to use the default."
          },
          "color_background": {
            "type": "string",
            "description": "The background colour of the checkout page, as a CSS colour value, or null to use the default."
          },
          "color_text": {
            "type": "string",
            "description": "The colour of text on the checkout, as a CSS colour value, or null to use the default."
          },
          "color_outline": {
            "type": "string",
            "description": "The colour of borders and outlines on the checkout, as a CSS colour value, or null to use the\ndefault."
          },
          "background_media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        }
      },
      "UpdateCouponDto": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the coupon is enabled."
          },
          "code": {
            "type": "string",
            "description": "The unique code associated with the coupon."
          },
          "note": {
            "type": "string",
            "description": "A note or internal description of the coupon."
          },
          "duration": {
            "$ref": "#/components/schemas/CouponDurationDto"
          },
          "duration_in_months": {
            "type": "integer",
            "description": "The number of months the coupon is valid for, used if the duration is repeating.",
            "format": "int32",
            "deprecated": true
          },
          "duration_in_intervals": {
            "type": "integer",
            "description": "The number of subscription renewals the coupon is valid for, used if the duration is repeating.",
            "format": "int32"
          },
          "discount_type": {
            "$ref": "#/components/schemas/CouponDiscountTypeDto"
          },
          "discount_amount": {
            "type": "integer",
            "description": "The discount amount, interpreted based on discount type: for a fixed-amount\ndiscount, this is in the smallest currency unit (e.g., cents); for a\npercentage discount, this is in tenths of a percent (e.g., 100 = 10.0% off).",
            "format": "int64"
          },
          "discount_apply_individually": {
            "type": "boolean",
            "description": "Indicates whether the discount should be applied individually to required tags or products."
          },
          "discount_apply_before_sales": {
            "type": "boolean",
            "description": "Indicates whether the discount is applied before existing sales."
          },
          "apply_to_products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "A list of product IDs the coupon applies to."
          },
          "apply_to_tags": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "A list of tag IDs the coupon applies to."
          },
          "usable_by_customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "minimum_order_value": {
            "type": "integer",
            "description": "The minimum order value required to use the coupon.",
            "format": "int64"
          },
          "redeem_limit_store_enabled": {
            "type": "boolean",
            "description": "Indicates whether a global redemption limit is enabled."
          },
          "redeem_limit_store_amount": {
            "type": "integer",
            "description": "The maximum number of times the coupon can be redeemed across the store.",
            "format": "int64"
          },
          "redeem_limit_customer_enabled": {
            "type": "boolean",
            "description": "Indicates whether a per-customer redemption limit is enabled."
          },
          "redeem_limit_customer_amount": {
            "type": "integer",
            "description": "The maximum number of times the coupon can be redeemed per customer.",
            "format": "int64"
          },
          "usable_on_one_time_purchase": {
            "type": "boolean",
            "description": "Indicates whether the coupon can be used for one-time purchases."
          },
          "usable_on_subscription": {
            "type": "boolean",
            "description": "Indicates whether the coupon can be used for subscriptions."
          },
          "usable_at": {
            "type": "string",
            "description": "The date and time when the coupon becomes valid.",
            "format": "date-time"
          },
          "expires_at": {
            "type": "string",
            "description": "The date and time when the coupon expires.",
            "format": "date-time"
          }
        }
      },
      "UpdateEmailBrandingDto": {
        "type": "object",
        "properties": {
          "color": {
            "type": "string"
          },
          "header_image_light_media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "header_image_dark_media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        }
      },
      "UpdateEmailTemplateDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "content": {
            "type": "string"
          }
        }
      },
      "UpdateGameServerConsoleDto": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether PayNow keeps the connection to the console open."
          },
          "host": {
            "type": "string",
            "description": "The hostname or IP address the game server's console listens on."
          },
          "port": {
            "type": "integer",
            "description": "The port the game server's console listens on.",
            "format": "int32"
          },
          "password": {
            "type": "string",
            "description": "The password used to authenticate with the console, or null when it requires none."
          },
          "secure": {
            "type": "boolean",
            "description": "Indicates whether the connection is made over TLS."
          }
        }
      },
      "UpdateGameServerDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The display name of the game server."
          },
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the game server is currently enabled."
          }
        }
      },
      "UpdateGiftCardDto": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the gift card is currently enabled and can be used."
          },
          "code": {
            "type": "string",
            "description": "The unique code that customers use to redeem the gift card.",
            "example": "GIFT-2024-ABCD1234"
          },
          "note": {
            "type": "string",
            "description": "Optional note or description associated with the gift card."
          },
          "balance": {
            "type": "integer",
            "description": "The current balance remaining on the gift card in cents.",
            "format": "int64",
            "example": 2500
          },
          "usable_by_customer_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "usable_at": {
            "type": "string",
            "description": "The date and time when the gift card becomes usable.",
            "format": "date-time"
          },
          "expires_at": {
            "type": "string",
            "description": "The date and time when the gift card expires, if applicable.",
            "format": "date-time"
          }
        }
      },
      "UpdateInviteDto": {
        "type": "object",
        "properties": {
          "role_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "user_email": {
            "type": "string",
            "description": "The email address the invite was sent to."
          }
        }
      },
      "UpdateNavLinkDto": {
        "type": "object",
        "properties": {
          "tag_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "parent_node_id": {
            "type": "string",
            "description": "The 'node_id' of the link this one nests under, or null when it sits at the top level of the\nnavigation."
          },
          "order": {
            "type": "integer",
            "description": "The position of the link among its siblings, lowest first, or null when no explicit order has\nbeen set.",
            "format": "int32"
          }
        }
      },
      "UpdateNavLinkOrderChangeDto": {
        "required": [
          "node_id",
          "order"
        ],
        "type": "object",
        "properties": {
          "node_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "order": {
            "type": "integer",
            "format": "int32"
          }
        },
        "additionalProperties": false
      },
      "UpdateProductSortOrderRequestDto": {
        "required": [
          "product_ids"
        ],
        "type": "object",
        "properties": {
          "product_ids": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "An array of product IDs in the order that they should be sorted."
          }
        },
        "additionalProperties": false
      },
      "UpdateRoleDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "permissions": {
            "type": "object",
            "additionalProperties": {
              "type": "boolean"
            }
          }
        }
      },
      "UpdateSaleDto": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the sale is enabled."
          },
          "name": {
            "type": "string",
            "description": "The name of the sale."
          },
          "discount_type": {
            "$ref": "#/components/schemas/SaleDiscountTypeDto"
          },
          "discount_amount": {
            "type": "integer",
            "description": "The discount value. For percent discounts, this represents the percentage \nmultiplied by 10 (e.g., 250 = 25%). For amount discounts, this represents \nthe value in the smallest currency unit (e.g., cents).",
            "format": "int32"
          },
          "duration": {
            "$ref": "#/components/schemas/SaleDurationDto"
          },
          "duration_in_intervals": {
            "type": "integer",
            "description": "The number of subscription intervals the coupon is valid for, used if the duration is repeating.",
            "format": "int32"
          },
          "apply_to_product_ids": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "A list of product IDs the sale applies to."
          },
          "apply_to_tag_ids": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "A list of tag IDs the sale applies to."
          },
          "minimum_order_value": {
            "type": "integer",
            "description": "The minimum order value required to apply the sale, in the smallest currency unit (e.g., cents).",
            "format": "int32"
          },
          "begins_at": {
            "type": "string",
            "description": "The date and time when the sale begins.",
            "format": "date-time"
          },
          "ends_at": {
            "type": "string",
            "description": "The date and time when the sale ends.",
            "format": "date-time"
          }
        }
      },
      "UpdateStoreDto": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string",
            "description": "The URL-safe slug used to identify the store (e.g. \"my-rust-server\")."
          },
          "name": {
            "type": "string",
            "description": "The display name of the store."
          },
          "platform": {
            "type": "string",
            "description": "The platform this store is associated with (e.g. \"rust\", \"minecraft\")."
          },
          "game": {
            "type": "string",
            "description": "Alias for 'platform'. Returns the platform identifier as a game name."
          },
          "description": {
            "type": "string",
            "description": "A human-readable description of the store shown to customers and PayNow."
          },
          "website_url": {
            "type": "string",
            "description": "The store's public website URL."
          },
          "contact_email": {
            "type": "string",
            "description": "General contact email address for the store."
          },
          "support_email": {
            "type": "string",
            "description": "Dedicated support email address for customer inquiries."
          },
          "support_url": {
            "type": "string",
            "description": "URL to the store's support portal or help page."
          },
          "integration_type": {
            "type": "string",
            "description": "The integration type used by the store."
          },
          "live_mode": {
            "type": "boolean",
            "description": "When set to true, the store is processing real transactions in live mode."
          },
          "logo_media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "logo_square_media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "minecraft_bedrock_username_prefix": {
            "type": "string",
            "description": "Username prefix used to identify Minecraft Bedrock players (e.g. \".\")."
          }
        }
      },
      "UpdateStoreMemberDto": {
        "required": [
          "role_id"
        ],
        "type": "object",
        "properties": {
          "role_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false
      },
      "UpdateStorePaymentSettingsDto": {
        "type": "object",
        "properties": {
          "show_all_payment_methods_for_subscriptions": {
            "type": "boolean",
            "description": "Whether to show all available payment methods for subscription purchases."
          },
          "store_tax_inclusive_pricing": {
            "type": "boolean",
            "description": "Whether store pricing is tax-inclusive."
          },
          "block_prepaid_cards": {
            "$ref": "#/components/schemas/PrepaidCardsBlockingTypeDto"
          },
          "promo_code_stacking_behavior": {
            "$ref": "#/components/schemas/StorePromoCodeStackingBehaviorDto"
          },
          "adaptive_currency_enabled": {
            "type": "boolean",
            "description": "Whether the 'Adaptive Currency' feature is enabled."
          },
          "show_adaptive_currency_on_storefront": {
            "type": "boolean",
            "description": "Whether the displayed currency on the storefront should be the Adaptive Currency by default."
          }
        }
      },
      "UpdateStoreUpsellSettingsDto": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean"
          },
          "automatic_recommendations_enabled": {
            "type": "boolean"
          },
          "automatic_recommendations_discount_type": {
            "$ref": "#/components/schemas/UpsellDiscountTypeDto"
          },
          "automatic_recommendations_discount_amount": {
            "type": "integer",
            "format": "int64"
          },
          "recommendation_overrides_enabled": {
            "type": "boolean"
          },
          "recommendation_overrides": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/StoreUpsellRecommendationDto"
            }
          },
          "checkout_style": {
            "$ref": "#/components/schemas/StoreUpsellCheckoutStyleDto"
          }
        }
      },
      "UpdateSubscriptionLineRequestDto": {
        "required": [
          "custom_variables"
        ],
        "type": "object",
        "properties": {
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "product_version_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "custom_variables": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Custom variable values keyed by variable name."
          },
          "selected_gameserver_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false
      },
      "UpdateSubscriptionRequestDto": {
        "required": [
          "lines",
          "proration_behavior"
        ],
        "type": "object",
        "properties": {
          "lines": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/UpdateSubscriptionLineRequestDto"
            },
            "description": "The line items describing the desired state of the subscription after the change."
          },
          "proration_behavior": {
            "$ref": "#/components/schemas/ProrationBehaviorDto"
          }
        },
        "additionalProperties": false
      },
      "UpdateSubscriptionResponseDto": {
        "required": [
          "subscription_change"
        ],
        "type": "object",
        "properties": {
          "subscription_change": {
            "$ref": "#/components/schemas/SubscriptionChangeDto"
          },
          "pending_payment": {
            "$ref": "#/components/schemas/CheckoutPaymentInfoDto"
          }
        },
        "additionalProperties": false,
        "description": "Response returned after a subscription change is initiated."
      },
      "UpdateTierGroupRequestDto": {
        "required": [
          "name"
        ],
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The name of the tier group."
          }
        },
        "additionalProperties": false
      },
      "UpdateTrialEligibilityOverrideDto": {
        "type": "object",
        "properties": {
          "product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "expires_at": {
            "type": "string",
            "description": "The date and time when this override expires and is no longer valid.",
            "format": "date-time"
          },
          "note": {
            "type": "string",
            "description": "An optional note or comment about this override."
          }
        }
      },
      "UpdateWebhookDto": {
        "required": [
          "reset_secret",
          "subscribed_to",
          "url"
        ],
        "type": "object",
        "properties": {
          "url": {
            "type": "string"
          },
          "reset_secret": {
            "type": "boolean"
          },
          "subscribed_to": {
            "$ref": "#/components/schemas/WebhookEventType"
          },
          "discord_description_template": {
            "type": [
              "null",
              "string"
            ]
          },
          "discord_title": {
            "type": [
              "null",
              "string"
            ]
          },
          "discord_color": {
            "type": [
              "null",
              "string"
            ]
          },
          "discord_format": {
            "$ref": "#/components/schemas/WebhookDiscordFormatDto"
          },
          "discord_skip_zero_total_orders": {
            "type": [
              "null",
              "boolean"
            ]
          }
        },
        "additionalProperties": false
      },
      "UpdateWebstoreModuleDto": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the module is rendered. A disabled module keeps its settings but is not\nshown to customers."
          },
          "type": {
            "type": "string",
            "description": "The kind of module. Decides which 'settings' it accepts and how the template renders it."
          },
          "settings": {
            "description": "The module's type-specific configuration as a JSON object, or null when it has none."
          },
          "starts_at": {
            "type": "string",
            "description": "The date and time the module starts being shown, or null to show it as soon as it is enabled.",
            "format": "date-time"
          },
          "ends_at": {
            "type": "string",
            "description": "The date and time the module stops being shown, or null to show it indefinitely.",
            "format": "date-time"
          }
        }
      },
      "UpdateWebstoreTemplateDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The display name of the template."
          },
          "compatibility_mode": {
            "$ref": "#/components/schemas/WebstoreTemplateCompatibilityModeDto"
          }
        }
      },
      "UpdateWebstoreTemplateFileDto": {
        "type": "object",
        "properties": {
          "file_name": {
            "type": "string",
            "description": "The name of the file within the template, without an extension. The extension follows from\n'content_type'."
          },
          "content_type": {
            "type": "string",
            "description": "The MIME type of the file (e.g., text/html, text/css, application/json). Decides how the file\nis served and whether it is public."
          },
          "content": {
            "type": "string",
            "description": "The text content of the file. Null when files are listed; content is only returned when a\nsingle file is fetched or the template is fetched with 'include' set to 'files'."
          }
        }
      },
      "UpdateWebstoreTemplateFileRequestDto": {
        "required": [
          "content"
        ],
        "type": "object",
        "properties": {
          "content": {
            "type": "string",
            "description": "The full new text content of the file. It replaces the existing content in its entirety."
          }
        },
        "additionalProperties": false,
        "description": "Represents a request to replace the content of a template file."
      },
      "UpdateWebstoreTemplateVariableDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The label shown for the variable in the editor."
          },
          "variable": {
            "type": "string",
            "description": "The name the template's files reference the value by."
          },
          "type": {
            "$ref": "#/components/schemas/WebstoreTemplateVariableTypeDto"
          },
          "value": {
            "type": "string",
            "description": "The value of the variable, always stored as a string and parsed according to 'type' when the\ntemplate renders."
          }
        }
      },
      "UpiDetailsDto": {
        "type": "object",
        "properties": {
          "vpa": {
            "type": [
              "null",
              "string"
            ],
            "description": "The Virtual Payment Address of the customer",
            "example": "johndoe@upi"
          }
        },
        "additionalProperties": false,
        "description": "UPI payment method details"
      },
      "UpsellDiscountTypeDto": {
        "enum": [
          "unknown",
          "none",
          "fixed",
          "percentage"
        ],
        "type": "string"
      },
      "UpsellTypeDto": {
        "enum": [
          "unknown",
          "additional",
          "alternative",
          "increase_quantity"
        ],
        "type": "string",
        "x-enumDescriptions": {
          "unknown": "Unknown upsell type.",
          "additional": "An additional product offered alongside the current item.",
          "alternative": "An alternative product offered in place of the current item.",
          "increase_quantity": "An offer to increase the quantity of the current item."
        },
        "x-paynow-docs-enum-descriptions": {
          "unknown": "Unknown upsell type.",
          "additional": "An additional product offered alongside the current item.",
          "alternative": "An alternative product offered in place of the current item.",
          "increase_quantity": "An offer to increase the quantity of the current item."
        }
      },
      "UpsertBanRequestDto": {
        "type": "object",
        "properties": {
          "reason": {
            "type": [
              "null",
              "string"
            ]
          },
          "identities": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/BanIdentityDto"
            }
          },
          "expires_at": {
            "type": [
              "null",
              "string"
            ],
            "format": "date-time"
          }
        },
        "additionalProperties": false
      },
      "UpsertCustomVariableRequestDto": {
        "required": [
          "identifier",
          "name",
          "options",
          "type"
        ],
        "type": "object",
        "properties": {
          "identifier": {
            "type": "string",
            "description": "Unique identifier string for programmatic reference.\nMust contain only letters, numbers, underscores, and hyphens."
          },
          "name": {
            "type": "string",
            "description": "Display name shown to customers."
          },
          "description": {
            "type": [
              "null",
              "string"
            ],
            "description": "Description explaining the purpose of this custom variable."
          },
          "type": {
            "$ref": "#/components/schemas/CustomVariableType"
          },
          "value_regex": {
            "type": [
              "null",
              "string"
            ],
            "description": "Optional regex pattern for validating customer input.\nOnly applies to text and number types. Ignored for dropdown types."
          },
          "options": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CustomVariableOptionRequestDto"
            },
            "description": "Predefined options for dropdown-type custom variables.\nRequired for dropdown types, ignored for text and number types.\nWhen updating, this completely replaces all existing options."
          }
        },
        "additionalProperties": false,
        "description": "Unified request model for creating or updating custom variables.\nContains all the configurable properties of a custom variable."
      },
      "UpsertCustomerRequestDto": {
        "type": "object",
        "properties": {
          "steam_id": {
            "$ref": "#/components/schemas/SteamId"
          },
          "minecraft_uuid": {
            "type": [
              "null",
              "string"
            ],
            "description": "The Minecraft UUID for the customer."
          },
          "minecraft_platform": {
            "$ref": "#/components/schemas/CustomerMinecraftPlatform"
          },
          "xbox_xuid": {
            "type": [
              "null",
              "string"
            ],
            "description": "The Xbox XUID (Xbox User ID) for the customer."
          },
          "name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The name of the customer."
          },
          "metadata": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "type": "string"
            },
            "description": "Additional customer information stored as key-value pairs."
          }
        },
        "additionalProperties": false
      },
      "UpsertGlobalCommandDto": {
        "required": [
          "content",
          "execution_rule",
          "online_only",
          "stage"
        ],
        "type": "object",
        "properties": {
          "stage": {
            "$ref": "#/components/schemas/ProductCommandStage"
          },
          "content": {
            "type": "string",
            "description": "The command content to be executed."
          },
          "online_only": {
            "type": "boolean",
            "description": "Indicates whether the command should only be executed when the player is online."
          },
          "override_execute_on_gameserver_ids": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "List of specific game server IDs where this command should be executed."
          },
          "execution_rule": {
            "$ref": "#/components/schemas/ProductCommandExecutionRuleDto"
          }
        },
        "additionalProperties": false,
        "description": "Data transfer object used for creating new global commands or updating existing ones.\nSupports partial updates following PATCH semantics."
      },
      "UpsertProductRequestDto": {
        "type": "object",
        "properties": {
          "slug": {
            "type": [
              "null",
              "string"
            ],
            "description": "The unique URL-safe identifier (slug) for the product."
          },
          "name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The display name of the product."
          },
          "description": {
            "type": [
              "null",
              "string"
            ],
            "description": "The detailed description of the product."
          },
          "label": {
            "type": [
              "null",
              "string"
            ],
            "description": "The display label for the product."
          },
          "price": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The price of the product in the lowest denominator (e.g. cents).",
            "format": "int64"
          },
          "single_game_server_only": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether the customer is prompted to select a game server before purchasing."
          },
          "allow_one_time_purchase": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether one-time purchases are allowed."
          },
          "allow_subscription": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether subscription purchases are allowed."
          },
          "subscription_interval_value": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The subscription interval value.",
            "format": "int32"
          },
          "subscription_interval_scale": {
            "$ref": "#/components/schemas/ProductSubscriptionIntervalScale"
          },
          "trial": {
            "$ref": "#/components/schemas/UpsertProductTrialConfigurationDto"
          },
          "upselling": {
            "$ref": "#/components/schemas/UpsertProductUpsellConfigurationDto"
          },
          "remove_after_enabled": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether automatic removal is enabled."
          },
          "remove_after_time_value": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The time value for automatic removal.",
            "format": "int32"
          },
          "remove_after_time_scale": {
            "$ref": "#/components/schemas/ProductRemoveAfterIntervalScale"
          },
          "store_stock_limit": {
            "$ref": "#/components/schemas/ProductStockLimitDto"
          },
          "customer_stock_limit": {
            "$ref": "#/components/schemas/ProductStockLimitDto"
          },
          "stock_limit_do_not_include_removed": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether removed items should be excluded from stock limits."
          },
          "tags": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "The tag IDs associated with the product."
          },
          "gameservers": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "The gameserver IDs associated with the product."
          },
          "commands": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/ProductCommandDto"
            },
            "description": "The commands to be executed at different stages."
          },
          "deliverable_actions": {
            "$ref": "#/components/schemas/ProductDeliverableActionsDto"
          },
          "metadata": {
            "type": [
              "null",
              "object"
            ],
            "additionalProperties": {
              "type": "string"
            },
            "description": "Additional metadata for the product."
          },
          "payout_splits": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/ProductPayoutSplitDto"
            },
            "description": "The payout splits for revenue distribution.\nRequires special approval."
          },
          "tax_code": {
            "$ref": "#/components/schemas/ProductTaxCode"
          },
          "allow_concurrent_active_items": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether concurrent active items are allowed."
          },
          "is_hidden": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether the product is hidden."
          },
          "is_gifting_disabled": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether gifting is disabled."
          },
          "enabled_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time when the product becomes enabled.\nSet to `null` to keep enabled.",
            "format": "date-time"
          },
          "enabled_until": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time until which the product remains enabled.\nSet to `null` to keep enabled.",
            "format": "date-time"
          },
          "required_product_ids": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "The IDs of products required for purchasing this product."
          },
          "required_product_all": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether all required products are needed."
          },
          "custom_variable_ids": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "The IDs of associated custom variables."
          },
          "media_asset_ids": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/FlakeId"
            },
            "description": "The IDs of the media assets to show as the product's images, in display order."
          },
          "is_gift_cards_disabled": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates if applying gift cards should be disabled on the product."
          },
          "is_coupons_disabled": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates if applying coupons should be disabled on the product."
          },
          "is_affiliate_links_disabled": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates if applying affiliate links should be disabled on the product."
          },
          "tier_group_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false
      },
      "UpsertProductTrialConfigurationDto": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates if trials should be enabled for the product."
          },
          "period_value": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The trial period value.",
            "format": "int32"
          },
          "period_scale": {
            "$ref": "#/components/schemas/ProductSubscriptionIntervalScale"
          },
          "revoke_immediately_when_canceled": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates if the trial should be revoked immediately when canceled or at the end of the trial."
          },
          "new_customers_only": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Restricts trials to customers who have no orders within the lookback period.\nWhen enabled, customers with recent orders will be ineligible for trials."
          },
          "new_customer_order_lookback_value": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The lookback period value for determining if a customer is \"new\".\nOnly used when new_customers_only is enabled.",
            "format": "int32"
          },
          "new_customer_order_lookback_scale": {
            "$ref": "#/components/schemas/ProductSubscriptionIntervalScale"
          },
          "allow_repeat_trials": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Allows customers to trial again after a cooldown period following their previous trial.\nWhen disabled, customers can only trial once and never become eligible again."
          },
          "repeat_trial_cooldown_value": {
            "type": [
              "null",
              "integer"
            ],
            "description": "The cooldown period value before a customer becomes eligible for another trial.\nOnly used when allow_repeat_trials is enabled.",
            "format": "int32"
          },
          "repeat_trial_cooldown_scale": {
            "$ref": "#/components/schemas/ProductSubscriptionIntervalScale"
          }
        },
        "additionalProperties": false,
        "description": "Represents the configuration for trials of a product"
      },
      "UpsertProductUpsellConfigurationDto": {
        "type": "object",
        "properties": {
          "enabled": {
            "type": [
              "null",
              "boolean"
            ]
          },
          "recommendations": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/UpsertProductUpsellRecommendationDto"
            }
          }
        },
        "additionalProperties": false
      },
      "UpsertProductUpsellRecommendationDto": {
        "required": [
          "discount_amount",
          "discount_type",
          "prefer_as_subscription",
          "recommended_product_id",
          "type"
        ],
        "type": "object",
        "properties": {
          "recommended_product_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "type": {
            "$ref": "#/components/schemas/UpsellTypeDto"
          },
          "discount_type": {
            "$ref": "#/components/schemas/UpsellDiscountTypeDto"
          },
          "discount_amount": {
            "type": "integer",
            "format": "int64"
          },
          "minimum_base_product_quantity": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int32"
          },
          "minimum_recommended_product_quantity": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int32"
          },
          "quantity_to_add": {
            "type": [
              "null",
              "integer"
            ],
            "format": "int32"
          },
          "prefer_as_subscription": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      },
      "UpsertTagRequestDto": {
        "type": "object",
        "properties": {
          "name": {
            "type": [
              "null",
              "string"
            ]
          },
          "slug": {
            "type": [
              "null",
              "string"
            ]
          },
          "description": {
            "type": [
              "null",
              "string"
            ]
          },
          "enabled": {
            "type": [
              "null",
              "boolean"
            ]
          },
          "media_asset_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false
      },
      "ValidationError": {
        "required": [
          "code",
          "message",
          "path",
          "validation"
        ],
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "description": "The parseable error code."
          },
          "message": {
            "type": "string",
            "description": "The human-readable error message."
          },
          "path": {
            "type": "string",
            "description": "The path leading to the validation error."
          },
          "validation": {
            "type": "string",
            "description": "Type of the validation that failed."
          }
        },
        "additionalProperties": false,
        "description": "A validation error."
      },
      "WebhookDeliveryResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "webhook_delivery": {
            "$ref": "#/components/schemas/QueuedWebhookDto"
          }
        },
        "additionalProperties": false
      },
      "WebhookDiscordFormatDto": {
        "enum": [
          "Invalid",
          "Embed",
          "Text"
        ],
        "type": "string",
        "description": "Specifies how a Discord webhook renders its message.",
        "x-enumDescriptions": {
          "Invalid": "No format specified. This value is typically used as a default or uninitialized state.",
          "Embed": "The message is sent as a rich embed with the configured title, colour and description.",
          "Text": "The message is sent as plain text rendered from the description template."
        },
        "x-paynow-docs-enum-descriptions": {
          "Invalid": "No format specified. This value is typically used as a default or uninitialized state.",
          "Embed": "The message is sent as a rich embed with the configured title, colour and description.",
          "Text": "The message is sent as plain text rendered from the description template."
        }
      },
      "WebhookEventType": {
        "enum": [
          "OnIgnore",
          "OnOrderCompleted",
          "OnRefund",
          "OnChargeback",
          "OnDeliveryItemAdded",
          "OnDeliveryItemActivated",
          "OnDeliveryItemUsed",
          "OnDeliveryItemRevoked",
          "OnSubscriptionActivated",
          "OnSubscriptionRenewed",
          "OnSubscriptionCanceled",
          "OnDiscordOrderActionsQueued",
          "OnConnectedUserRegistered",
          "OnConnectedUserBecamePayable",
          "OnConnectedUserPayoutCreated",
          "OnConnectedUserPayoutCompleted",
          "OnConnectedUserTransactionInserted",
          "OnConnectedUserBecameUnpayable",
          "OnTrialActivated",
          "OnTrialCompleted",
          "OnTrialCanceled",
          "OnPurchaseFollowUpAttemptEmailSent",
          "OnPurchaseFollowUpAttemptSucceeded",
          "OnAbandonedCheckoutRecoveryAttemptEmailSent",
          "OnAbandonedCheckoutRecoveryAttemptSucceeded",
          "OnChargebackClosed",
          "OnDeliveryItemExpired",
          "OnDeliveryItemRenewed",
          "OnConnectedUserTrustStatusChanged",
          "OnPaymentCompleted",
          "OnPaymentFailed",
          "OnChargebackLifecycle"
        ],
        "type": "string"
      },
      "WebhookHistoryDto": {
        "required": [
          "history",
          "page"
        ],
        "type": "object",
        "properties": {
          "page": {
            "type": "integer",
            "format": "int32"
          },
          "history": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/QueuedWebhookDto"
            }
          }
        },
        "additionalProperties": false
      },
      "WebhookResult": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "store_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "webhook": {
            "$ref": "#/components/schemas/WebhookSubscriptionDto"
          }
        },
        "additionalProperties": false
      },
      "WebhookStateDto": {
        "enum": [
          "success",
          "pending",
          "failed",
          "all"
        ],
        "type": "string"
      },
      "WebhookSubscriptionDto": {
        "required": [
          "discord_skip_zero_total_orders",
          "id",
          "secret",
          "subscribed_to",
          "type",
          "url"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "url": {
            "type": "string",
            "description": "The URL each event is delivered to. For the 'DiscordV1' type this is the Discord webhook URL."
          },
          "secret": {
            "type": "string",
            "description": "The secret used to sign each delivery. Receivers use it to verify the request's signature\nheader and confirm it came from PayNow."
          },
          "subscribed_to": {
            "$ref": "#/components/schemas/WebhookEventType"
          },
          "type": {
            "$ref": "#/components/schemas/WebhookTypeDto"
          },
          "discord_description_template": {
            "type": [
              "null",
              "string"
            ],
            "description": "The template rendered into the body of the Discord message, with webhook variables substituted.\nOnly used by the 'DiscordV1' type."
          },
          "discord_title": {
            "type": [
              "null",
              "string"
            ],
            "description": "The title of the Discord embed. Only used by the 'DiscordV1' type with the 'Embed' format."
          },
          "discord_color": {
            "type": [
              "null",
              "string"
            ],
            "description": "The accent colour of the Discord embed, as a hex colour. Only used by the 'DiscordV1' type\nwith the 'Embed' format."
          },
          "discord_format": {
            "$ref": "#/components/schemas/WebhookDiscordFormatDto"
          },
          "discord_skip_zero_total_orders": {
            "type": "boolean",
            "description": "Whether orders with a total of zero are left out of the 'OnOrderCompleted' deliveries. Only used\nby the 'DiscordV1' type."
          }
        },
        "additionalProperties": false,
        "description": "Represents a webhook subscription: an endpoint that receives a request whenever one of the\nsubscribed events happens in the store."
      },
      "WebhookTypeDto": {
        "enum": [
          "JsonV1",
          "DiscordV1"
        ],
        "type": "string",
        "description": "Specifies the payload format a webhook delivers.",
        "x-enumDescriptions": {
          "JsonV1": "The event is posted as JSON. This is the default.",
          "DiscordV1": "The event is posted as a Discord message."
        },
        "x-paynow-docs-enum-descriptions": {
          "JsonV1": "The event is posted as JSON. This is the default.",
          "DiscordV1": "The event is posted as a Discord message."
        }
      },
      "WebhookVariablesDto": {
        "required": [
          "event_type",
          "variables"
        ],
        "type": "object",
        "properties": {
          "event_type": {
            "$ref": "#/components/schemas/WebhookEventType"
          },
          "variables": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "additionalProperties": false
      },
      "WebstoreCustomDomainDto": {
        "required": [
          "hostname",
          "id",
          "status",
          "verification_errors"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The identifier the domain was registered under with the hosting provider."
          },
          "hostname": {
            "type": "string",
            "description": "The domain the webstore is served from, without a scheme (e.g., store.example.com)."
          },
          "status": {
            "type": "string",
            "description": "The verification state of the domain as reported by the hosting provider.\nThe domain only serves the webstore once it is active."
          },
          "ssl": {
            "$ref": "#/components/schemas/WebstoreCustomDomainSslDto"
          },
          "ownership_verification": {
            "$ref": "#/components/schemas/WebstoreCustomDomainOwnershipVerificationDto"
          },
          "ownership_verification_http": {
            "$ref": "#/components/schemas/WebstoreCustomDomainOwnershipVerificationHttpDto"
          },
          "verification_errors": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The errors raised by the last ownership verification attempt. Empty when the last attempt\nraised none."
          },
          "created_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time the domain was attached to the webstore.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents a custom domain attached to a webstore, together with the state of its ownership and\nSSL verification."
      },
      "WebstoreCustomDomainOwnershipVerificationDto": {
        "required": [
          "name",
          "type",
          "value"
        ],
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "The kind of DNS record to publish (e.g., txt)."
          },
          "name": {
            "type": "string",
            "description": "The name to publish the record under."
          },
          "value": {
            "type": "string",
            "description": "The value the record has to hold."
          }
        },
        "additionalProperties": false,
        "description": "Represents the DNS record that has to be published to prove ownership of a webstore's custom domain."
      },
      "WebstoreCustomDomainOwnershipVerificationHttpDto": {
        "required": [
          "http_body",
          "http_url"
        ],
        "type": "object",
        "properties": {
          "http_url": {
            "type": "string",
            "description": "The URL on the domain the token file has to be served from."
          },
          "http_body": {
            "type": "string",
            "description": "The body that URL has to return."
          }
        },
        "additionalProperties": false,
        "description": "Represents the token file that has to be served over HTTP to prove ownership of a webstore's\ncustom domain."
      },
      "WebstoreCustomDomainSslDto": {
        "required": [
          "id",
          "method",
          "status",
          "validation_errors",
          "validation_records"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The identifier the certificate was issued under."
          },
          "method": {
            "type": "string",
            "description": "How control of the domain is validated for the certificate (e.g., txt, http, email)."
          },
          "status": {
            "type": "string",
            "description": "The state of the certificate (e.g., pending_validation, active). The domain only serves\ntraffic over HTTPS once it is active."
          },
          "certificate_authority": {
            "type": [
              "null",
              "string"
            ],
            "description": "The authority issuing the certificate, or null while one has not been chosen."
          },
          "validation_records": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WebstoreCustomDomainSslValidationRecordDto"
            },
            "description": "The records that have to be published to validate the certificate. Empty once validation no\nlonger needs them."
          },
          "validation_errors": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The errors raised by the last certificate validation attempt. Empty when the last attempt\nraised none."
          }
        },
        "additionalProperties": false,
        "description": "Represents the SSL certificate issued for a webstore's custom domain."
      },
      "WebstoreCustomDomainSslValidationRecordDto": {
        "required": [
          "emails"
        ],
        "type": "object",
        "properties": {
          "txt_name": {
            "type": [
              "null",
              "string"
            ],
            "description": "The name to publish the DNS TXT record under, or null when validation is not by TXT record."
          },
          "txt_value": {
            "type": [
              "null",
              "string"
            ],
            "description": "The value that TXT record has to hold, or null when validation is not by TXT record."
          },
          "http_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "The URL on the domain the token file has to be served from, or null when validation is not\nover HTTP."
          },
          "http_body": {
            "type": [
              "null",
              "string"
            ],
            "description": "The body that URL has to return, or null when validation is not over HTTP."
          },
          "emails": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The addresses a validation link can be sent to. Empty when validation is not by email."
          }
        },
        "additionalProperties": false,
        "description": "Represents one record that has to be published to validate a custom domain's SSL certificate.\nWhich fields are populated depends on the 'ssl' block's 'method'."
      },
      "WebstoreCustomDomainVerificationTypeDto": {
        "enum": [
          "invalid",
          "http",
          "txt",
          "email",
          "cname"
        ],
        "type": "string",
        "description": "Specifies how ownership of a webstore's custom domain is proven.\nThe only officially supported method is the 'http' method.",
        "x-enumDescriptions": {
          "invalid": "No verification type specified. This value is typically used as a default or uninitialized state.",
          "http": "Ownership is proven by serving a token file over HTTP from the domain.\n            This is the RECOMMENDED way to prove ownership, and is used by the dashboard.",
          "txt": "Ownership is proven by publishing a DNS TXT record on the domain.",
          "email": "Ownership is proven by following a link sent to an administrative address on the domain.",
          "cname": "Ownership is proven by publishing a DNS CNAME record on the domain."
        },
        "x-paynow-docs-enum-descriptions": {
          "invalid": "No verification type specified. This value is typically used as a default or uninitialized state.",
          "http": "Ownership is proven by serving a token file over HTTP from the domain.\n            This is the RECOMMENDED way to prove ownership, and is used by the dashboard.",
          "txt": "Ownership is proven by publishing a DNS TXT record on the domain.",
          "email": "Ownership is proven by following a link sent to an administrative address on the domain.",
          "cname": "Ownership is proven by publishing a DNS CNAME record on the domain."
        }
      },
      "WebstoreDto": {
        "required": [
          "custom_domain_verified",
          "id",
          "is_active",
          "slug"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "slug": {
            "type": "string",
            "description": "The slug the webstore is served from, unique across all webstores."
          },
          "is_active": {
            "type": "boolean",
            "description": "Indicates whether the webstore is being served to customers."
          },
          "custom_domain": {
            "type": [
              "null",
              "string"
            ],
            "description": "The custom domain the webstore is served from, or null when it is only reachable at its slug."
          },
          "custom_domain_verified": {
            "type": "boolean",
            "description": "Indicates whether ownership of 'custom_domain' has been verified. Until it is, the webstore is\nonly served from its slug."
          },
          "current_template_id": {
            "$ref": "#/components/schemas/FlakeId"
          }
        },
        "additionalProperties": false,
        "description": "Represents a store's webstore, the hosted storefront customers browse and buy from."
      },
      "WebstoreModuleDto": {
        "required": [
          "created_at",
          "enabled",
          "id",
          "sort_order",
          "type",
          "updated_at",
          "webstore_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "webstore_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "enabled": {
            "type": "boolean",
            "description": "Indicates whether the module is rendered. A disabled module keeps its settings but is not\nshown to customers."
          },
          "type": {
            "type": "string",
            "description": "The kind of module. Decides which 'settings' it accepts and how the template renders it."
          },
          "sort_order": {
            "type": "integer",
            "description": "The position of the module among the webstore's modules, lowest first.",
            "format": "int32"
          },
          "settings": {
            "type": "null",
            "description": "The module's type-specific configuration as a JSON object, or null when it has none."
          },
          "starts_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time the module starts being shown, or null to show it as soon as it is enabled.",
            "format": "date-time"
          },
          "ends_at": {
            "type": [
              "null",
              "string"
            ],
            "description": "The date and time the module stops being shown, or null to show it indefinitely.",
            "format": "date-time"
          },
          "created_at": {
            "type": "string",
            "description": "The date and time the module was created.",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "description": "The date and time the module was last updated.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents a module on a webstore: a self-contained block of content or functionality the\ntemplate renders."
      },
      "WebstoreTemplateCompatibilityModeDto": {
        "enum": [
          "invalid",
          "paynow",
          "tebex"
        ],
        "type": "string",
        "description": "Specifies the dialect a webstore template is written in.",
        "x-enumDescriptions": {
          "invalid": "No compatibility mode specified. This value is typically used as a default or uninitialized state.",
          "paynow": "A native PayNow template.",
          "tebex": "A template written for Tebex, rendered through a compatibility layer so it works without changes."
        },
        "x-paynow-docs-enum-descriptions": {
          "invalid": "No compatibility mode specified. This value is typically used as a default or uninitialized state.",
          "paynow": "A native PayNow template.",
          "tebex": "A template written for Tebex, rendered through a compatibility layer so it works without changes."
        }
      },
      "WebstoreTemplateCompiledFileDto": {
        "required": [
          "content_type",
          "file_name"
        ],
        "type": "object",
        "properties": {
          "file_name": {
            "type": "string",
            "description": "The name of the file within the template."
          },
          "content_type": {
            "type": "string",
            "description": "The MIME type of the file."
          },
          "compiled": {
            "type": [
              "null",
              "string"
            ],
            "description": "The compiled output of the file, or null when compilation failed."
          },
          "error": {
            "type": [
              "null",
              "string"
            ],
            "description": "The error compilation raised, or null when the file compiled successfully."
          }
        },
        "additionalProperties": false,
        "description": "Represents one file of a template after compilation."
      },
      "WebstoreTemplateDto": {
        "required": [
          "compatibility_mode",
          "created_at",
          "id",
          "is_public",
          "name",
          "updated_at",
          "webstore_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "webstore_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "name": {
            "type": "string",
            "description": "The display name of the template."
          },
          "is_public": {
            "type": "boolean",
            "description": "Indicates whether the template is shared with every store, as PayNow's built-in templates are,\nrather than private to this webstore."
          },
          "compatibility_mode": {
            "$ref": "#/components/schemas/WebstoreTemplateCompatibilityModeDto"
          },
          "created_at": {
            "type": "string",
            "description": "The date and time the template was created.",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "description": "The date and time the template was last updated.",
            "format": "date-time"
          },
          "template_files": {
            "type": [
              "null",
              "array"
            ],
            "items": {
              "$ref": "#/components/schemas/WebstoreTemplateFileDto"
            },
            "description": "The template's files, content included. Only returned when a single template is fetched with\n'include' set to 'files'; null otherwise."
          }
        },
        "additionalProperties": false,
        "description": "Represents a template a webstore can render: a named set of pages, styles, scripts and assets\nserved to customers while it is the webstore's current template."
      },
      "WebstoreTemplateFileDto": {
        "required": [
          "content_type",
          "created_at",
          "file_name",
          "id",
          "is_deletable",
          "is_public",
          "template_id",
          "updated_at"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "template_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "file_name": {
            "type": "string",
            "description": "The name of the file within the template, without an extension. The extension follows from\n'content_type'."
          },
          "content_type": {
            "type": "string",
            "description": "The MIME type of the file (e.g., text/html, text/css, application/json). Decides how the file\nis served and whether it is public."
          },
          "is_public": {
            "type": "boolean",
            "description": "Indicates whether the file is served directly to browsers as a static asset. Pages and the\nschema file are private and rendered on the server; styles, scripts and images are public."
          },
          "is_deletable": {
            "type": "boolean",
            "description": "Indicates whether the file can be deleted. Files the template cannot render without are not\ndeletable."
          },
          "content": {
            "type": [
              "null",
              "string"
            ],
            "description": "The text content of the file. Null when files are listed; content is only returned when a\nsingle file is fetched or the template is fetched with 'include' set to 'files'."
          },
          "created_at": {
            "type": "string",
            "description": "The date and time the file was created.",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "description": "The date and time the file was last updated.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents one file within a webstore template, such as a page, stylesheet, script or image."
      },
      "WebstoreTemplateLatestVersionDto": {
        "type": "object",
        "properties": {
          "version": {
            "type": [
              "null",
              "string"
            ],
            "description": "The newest published version of the template, or null when no update is available or the\ntemplate was not installed from the marketplace."
          }
        },
        "additionalProperties": false,
        "description": "Represents the newest version available for a template installed from the marketplace."
      },
      "WebstoreTemplatePreviewDto": {
        "required": [
          "compatibilityMode",
          "compiled",
          "compiled_at"
        ],
        "type": "object",
        "properties": {
          "compiled": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WebstoreTemplateCompiledFileDto"
            },
            "description": "The template's files after compilation, including any that failed to compile."
          },
          "schema": {
            "$ref": "#/components/schemas/WebstoreTemplateSchemaDto"
          },
          "compatibilityMode": {
            "$ref": "#/components/schemas/WebstoreTemplateCompatibilityModeDto"
          },
          "compiled_at": {
            "type": "string",
            "description": "The date and time the template was compiled.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents a template compiled and ready to render."
      },
      "WebstoreTemplatePreviewResponseDto": {
        "required": [
          "template",
          "variables"
        ],
        "type": "object",
        "properties": {
          "template": {
            "$ref": "#/components/schemas/WebstoreTemplatePreviewDto"
          },
          "variables": {
            "$ref": "#/components/schemas/WebstoreTemplatePreviewVariablesDto"
          }
        },
        "additionalProperties": false,
        "description": "Represents the data the editor uses to preview a template."
      },
      "WebstoreTemplatePreviewVariablesDto": {
        "required": [
          "saved_at",
          "variables"
        ],
        "type": "object",
        "properties": {
          "variables": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WebstoreTemplateVariableDto"
            },
            "description": "The template's variables and their current values."
          },
          "saved_at": {
            "type": "string",
            "description": "The date and time the variable values were last saved.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents the variable values a template preview renders with."
      },
      "WebstoreTemplateSchemaDto": {
        "required": [
          "author",
          "config"
        ],
        "type": "object",
        "properties": {
          "author": {
            "type": "string",
            "description": "The name of the template's author."
          },
          "support_email": {
            "type": [
              "null",
              "string"
            ],
            "description": "The email address to contact for support with the template, or null when none is given."
          },
          "support_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "The URL to visit for support with the template, or null when none is given."
          },
          "updates": {
            "$ref": "#/components/schemas/WebstoreTemplateSchemaUpdatesDto"
          },
          "config": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WebstoreTemplateSchemaSectionDto"
            },
            "description": "The sections of settings the template exposes, in display order."
          }
        },
        "additionalProperties": false,
        "description": "Represents a template's schema, declared by its author: who maintains it, how it receives updates\nand the settings a store can configure without editing the template's files."
      },
      "WebstoreTemplateSchemaOptionDto": {
        "required": [
          "id",
          "name",
          "nested_options",
          "type",
          "values"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The key the setting's value is stored under. Use it as the variable name when setting values\nthrough the schema variables endpoint."
          },
          "name": {
            "type": "string",
            "description": "The label shown for the setting."
          },
          "description": {
            "type": [
              "null",
              "string"
            ],
            "description": "A longer explanation of the setting, or null when the template gives none."
          },
          "type": {
            "type": "string",
            "description": "The kind of control used to edit the setting (e.g., text, toggle, select, color)."
          },
          "default": {
            "type": "null",
            "description": "The value used while the store has not set one, or null when there is no default."
          },
          "values": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "The choices a select-style setting offers. Empty for other kinds of setting."
          },
          "numeric": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether a text setting only accepts numbers, or null when it does not apply."
          },
          "multiline": {
            "type": [
              "null",
              "boolean"
            ],
            "description": "Indicates whether a text setting accepts multiple lines, or null when it does not apply."
          },
          "min": {
            "type": [
              "null",
              "number"
            ],
            "description": "The lowest value a numeric setting accepts, or null when it is unbounded.",
            "format": "double"
          },
          "max": {
            "type": [
              "null",
              "number"
            ],
            "description": "The highest value a numeric setting accepts, or null when it is unbounded.",
            "format": "double"
          },
          "nested_options": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WebstoreTemplateSchemaOptionDto"
            },
            "description": "The settings nested under this one. Empty when it has none."
          }
        },
        "additionalProperties": false,
        "description": "Represents one configurable setting in a template's schema."
      },
      "WebstoreTemplateSchemaSectionDto": {
        "required": [
          "header",
          "options"
        ],
        "type": "object",
        "properties": {
          "header": {
            "type": "string",
            "description": "The heading shown above the section."
          },
          "description": {
            "type": [
              "null",
              "string"
            ],
            "description": "The explanation shown under the section's heading, or null when the template gives none."
          },
          "options": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WebstoreTemplateSchemaOptionDto"
            },
            "description": "The settings in the section, in display order."
          }
        },
        "additionalProperties": false,
        "description": "Represents a group of related settings in a template's schema."
      },
      "WebstoreTemplateSchemaUpdatesDto": {
        "required": [
          "github_branch",
          "supported",
          "version_check_supported"
        ],
        "type": "object",
        "properties": {
          "supported": {
            "type": "boolean",
            "description": "Indicates whether the template can be updated in place."
          },
          "version_check_supported": {
            "type": "boolean",
            "description": "Indicates whether the newest available version can be looked up before updating."
          },
          "version": {
            "type": [
              "null",
              "string"
            ],
            "description": "The version of the template currently installed, or null when the template does not declare\none."
          },
          "github_url": {
            "type": [
              "null",
              "string"
            ],
            "description": "The URL of the GitHub repository updates are pulled from, or null when updates do not come from\nGitHub."
          },
          "github_branch": {
            "type": "string",
            "description": "The branch of the repository updates are pulled from."
          },
          "github_token": {
            "type": [
              "null",
              "string"
            ],
            "description": "The token used to read a private repository, or null when the repository is public."
          }
        },
        "additionalProperties": false,
        "description": "Represents how a template receives updates from its author."
      },
      "WebstoreTemplateVariableDto": {
        "required": [
          "created_at",
          "id",
          "name",
          "template_id",
          "type",
          "updated_at",
          "value",
          "variable",
          "webstore_id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "template_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "webstore_id": {
            "$ref": "#/components/schemas/FlakeId"
          },
          "name": {
            "type": "string",
            "description": "The label shown for the variable in the editor."
          },
          "variable": {
            "type": "string",
            "description": "The name the template's files reference the value by."
          },
          "type": {
            "$ref": "#/components/schemas/WebstoreTemplateVariableTypeDto"
          },
          "value": {
            "type": "string",
            "description": "The value of the variable, always stored as a string and parsed according to 'type' when the\ntemplate renders."
          },
          "created_at": {
            "type": "string",
            "description": "The date and time the variable was created.",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "description": "The date and time the variable was last updated.",
            "format": "date-time"
          }
        },
        "additionalProperties": false,
        "description": "Represents a value a template's files can reference, letting a store customise a template without\nediting its files."
      },
      "WebstoreTemplateVariableTypeDto": {
        "enum": [
          "invalid",
          "string",
          "html",
          "number",
          "boolean",
          "json"
        ],
        "type": "string",
        "description": "Specifies how a template variable's 'value' is interpreted when the template renders.",
        "x-enumDescriptions": {
          "invalid": "No type specified. This value is typically used as a default or uninitialized state.",
          "string": "The value is used as plain text.",
          "html": "The value is inserted as raw HTML without escaping.",
          "number": "The value is parsed as a number.",
          "boolean": "The value is parsed as a boolean; 'true' is true, anything else is false.",
          "json": "The value is parsed as a JSON document."
        },
        "x-paynow-docs-enum-descriptions": {
          "invalid": "No type specified. This value is typically used as a default or uninitialized state.",
          "string": "The value is used as plain text.",
          "html": "The value is inserted as raw HTML without escaping.",
          "number": "The value is parsed as a number.",
          "boolean": "The value is parsed as a boolean; 'true' is true, anything else is false.",
          "json": "The value is parsed as a JSON document."
        }
      }
    },
    "securitySchemes": {
      "APIKey": {
        "type": "apiKey",
        "description": "An API Key token generated in the Dashboard in the format 'APIKey TOKEN_HERE'.",
        "name": "Authorization",
        "in": "header",
        "x-gitbook-prefix": "APIKey",
        "x-gitbook-token-placeholder": "TOKEN_HERE"
      },
      "Customer": {
        "type": "apiKey",
        "description": "A Customer token generated using an API Key in the format 'Customer TOKEN_HERE'.",
        "name": "Authorization",
        "in": "header",
        "x-gitbook-prefix": "Customer",
        "x-gitbook-token-placeholder": "TOKEN_HERE"
      }
    }
  },
  "tags": [
    {
      "name": "affiliate-links"
    },
    {
      "name": "bans"
    },
    {
      "name": "billing"
    },
    {
      "name": "chargebacks"
    },
    {
      "name": "checkout"
    },
    {
      "name": "checkout-style"
    },
    {
      "name": "coupons"
    },
    {
      "name": "custom-variables"
    },
    {
      "name": "customer-portal-sessions"
    },
    {
      "name": "customers"
    },
    {
      "name": "dashboard"
    },
    {
      "name": "data-migrations"
    },
    {
      "name": "delivery"
    },
    {
      "name": "discord"
    },
    {
      "name": "downloadable-files"
    },
    {
      "name": "game-servers"
    },
    {
      "name": "giftcards"
    },
    {
      "name": "global-commands"
    },
    {
      "name": "invites"
    },
    {
      "name": "invoices"
    },
    {
      "name": "marketing"
    },
    {
      "name": "media"
    },
    {
      "name": "navlinks"
    },
    {
      "name": "orders"
    },
    {
      "name": "payment-method-types"
    },
    {
      "name": "payment-settings"
    },
    {
      "name": "payments"
    },
    {
      "name": "product-dependent-migrations"
    },
    {
      "name": "products"
    },
    {
      "name": "regional-pricing"
    },
    {
      "name": "roles"
    },
    {
      "name": "sales"
    },
    {
      "name": "search"
    },
    {
      "name": "stats"
    },
    {
      "name": "store"
    },
    {
      "name": "subscriptions"
    },
    {
      "name": "tags"
    },
    {
      "name": "tier-groups"
    },
    {
      "name": "trials"
    },
    {
      "name": "trust"
    },
    {
      "name": "upsell-settings"
    },
    {
      "name": "webhooks"
    },
    {
      "name": "webstore"
    }
  ]
}