Get Wix Payments status

Changed on

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

Reports whether Wix Payments is connected to the app, and if it isn't, whether you can connect it now.

Use it to check a connection before taking payments. Wix reports account changes, such as a finished verification, in the background, so read the status again rather than relying on an earlier answer.

When Wix Payments can't be connected, connect_blocker names the first reason. Clear it and read the status again, since a second reason can show up once the first is gone.

<Note>This endpoint only reads, but it needs write access to the app and a personal access token set to Full access. A viewer is refused, and so is a read-only token. The app's workspace also has to allow payment management.</Note>

get/api/apps/{app_id}/payments/wix/status

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/apps/{app_id}/payments/wix/status
  • Auth: HTTP bearer

Path parameters

app_idstring required

ID of the Base44 app.

Response

The app's Wix Payments connection, and whether it can be connected when it isn't.

connectedboolean required

Whether Wix Payments is connected to the app (true) or not (false).

test_modeboolean nullable required

Whether the checkout takes test payments (true) or real ones (false), or null when Wix Payments isn't connected or the mode was never recorded.

can_connectboolean required

Whether you can connect Wix Payments now (true) or not (false). Only the app owner can connect, so anyone else gets false. It's also false once Wix Payments is connected.

Example response

{
  "account": {
    "can_receive_payouts": true,
    "status": "pending",
    "reason": "verification_not_started",
    "updated_at": "2026-01-15T09:23:41Z"
  },
  "connect_blocker": {
    "code": "checkout_already_owned",
    "message": "A payment integration is already set up for this app."
  }
}

Changes