> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Wix Payments dashboard link

> <Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns a one-time link to the app's Wix Payments dashboard.

This endpoint depends on the app's [Wix site connection](/developers/references/apps-api/sections/payments-wix#wix-site-connection) rather than on Wix Payments being actively connected, so it can still return a working link after Wix Payments is disconnected.



## OpenAPI

````yaml /developers/references/app-management/app-management-openapi.json get /api/apps/{app_id}/payments/wix/dashboard-url
openapi: 3.1.0
info:
  title: Base44 App Management API
  version: 1.0.0
servers:
  - url: https://app.base44.com
security:
  - PersonalAccessTokenAuth: []
paths:
  /api/apps/{app_id}/payments/wix/dashboard-url:
    get:
      summary: Get Wix Payments dashboard link
      description: >-
        <Info>This API is in beta. Endpoints, fields, and behavior may still
        change, so avoid depending on it in production.</Info>


        Returns a one-time link to the app's Wix Payments dashboard.


        This endpoint depends on the app's [Wix site
        connection](/developers/references/apps-api/sections/payments-wix#wix-site-connection)
        rather than on Wix Payments being actively connected, so it can still
        return a working link after Wix Payments is disconnected.
      operationId: get_dashboard_url_api_apps__app_id__payments_wix_dashboard_url_get
      parameters:
        - name: app_id
          in: path
          required: true
          schema:
            type: string
            description: ID of the Base44 app.
            title: App Id
          description: ID of the Base44 app.
          example: 6820f3a4e7b91d003c45a1f2
        - name: redirect_url
          in: query
          required: false
          schema:
            type: string
            description: >-
              Optional redirect on the same origin as the request. Invalid
              destinations are ignored. Takes priority over `destination` and
              `open_assistant`.
            title: Redirect Url
          description: >-
            Optional redirect on the same origin as the request. Invalid
            destinations are ignored. Takes priority over `destination` and
            `open_assistant`.
          example: /apps
        - name: open_assistant
          in: query
          required: false
          schema:
            type: boolean
            description: >-
              Whether to open the payment methods assistant, when neither
              `redirect_url` nor a named `destination` applies. Defaults to
              `false`.
            default: false
            title: Open Assistant
          description: >-
            Whether to open the payment methods assistant, when neither
            `redirect_url` nor a named `destination` applies. Defaults to
            `false`.
          example: false
        - name: destination
          in: query
          required: false
          schema:
            $ref: '#/components/schemas/WixDashboardDestination'
            description: >-
              Which Wix Payments page to open: `dashboard`, `payment_settings`,
              or `payouts`. Defaults to `dashboard`. Takes priority over
              `open_assistant`, but `redirect_url` takes priority over both.
            default: dashboard
          description: >-
            Which Wix Payments page to open: `dashboard`, `payment_settings`, or
            `payouts`. Defaults to `dashboard`. Takes priority over
            `open_assistant`, but `redirect_url` takes priority over both.
          example: dashboard
        - name: prefetch
          in: query
          required: false
          schema:
            type: boolean
            description: >-
              Whether to only mint the link, for a caller that may never open
              it. A prefetching caller confirms an actual open through the
              commit route. Defaults to false.
            default: false
            title: Prefetch
          description: >-
            Whether to only mint the link, for a caller that may never open it.
            A prefetching caller confirms an actual open through the commit
            route. Defaults to false.
          example: false
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DashboardUrlResponse'
        '401':
          description: Missing or invalid credentials.
        '403':
          description: >-
            The credential lacks app write access, or the app's workspace
            restricts payment management (`app_payment_management_not_allowed`).
        '404':
          description: >-
            The app has no connected Wix site, or it is outside the credential's
            granted workspace.
        '409':
          description: The workspace requires an unlocked SSO session.
        '422':
          description: >-
            `open_assistant` isn't a valid boolean, or `destination` isn't a
            recognized value.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - PersonalAccessTokenAuth:
            - full_access
components:
  schemas:
    WixDashboardDestination:
      type: string
      enum:
        - dashboard
        - payment_settings
        - payouts
      title: WixDashboardDestination
      description: Where in the Wix dashboard a link should land.
    DashboardUrlResponse:
      properties:
        redirect_url:
          type: string
          title: Redirect Url
          description: >-
            One-time Wix dashboard link. Treat it as a credential and open it in
            a browser.
          example: https://manage.wix.com/example-dashboard-link
      type: object
      required:
        - redirect_url
      title: DashboardUrlResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    PersonalAccessTokenAuth:
      type: http
      scheme: bearer
      description: >-
        Personal access token, sent as `Authorization: Bearer <token>`. Each
        operation lists the permission it needs: `read_only` or `full_access`. A
        full-access token can call every operation. A read-only token can call
        only the operations that list `read_only`; anything else returns 403
        `read_only_credential_route_not_allowed`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.