---
title: "Switch Wix Payments test mode"
method: PUT
path: "/api/apps/{app_id}/payments/wix/test-mode"
---

# Switch Wix Payments test mode

`PUT /api/apps/{app_id}/payments/wix/test-mode`

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

Switches the app's Wix Payments checkout between test mode and live.

While test mode is on, the checkout takes test payments and real cards aren't charged. Verify a test purchase, then send `test_mode: false` to start taking real payments. The mode is a Wix Payments setting, so the switch applies to the published app without a deploy.

<Warning>Turning test mode on stops real customers from paying until the app is switched back to live.</Warning>

The response carries the mode Wix reports after the call. Sending the mode the app is already in changes nothing and returns it. No other published endpoint returns the current mode.

Requires write access to the app and a connected Wix Payments account.

This is limited to 30 requests an hour per caller. Some workspaces have a different limit.

## Path parameters

- `app_id` string, required — ID of the Base44 app.

## Request body

- UpdateTestModeRequest
  - `test_mode` boolean, required — Whether to switch the checkout to test mode (`true`) or live (`false`).

## Response `200`

The app's Wix Payments mode after the call.

- TestModeResponse — The app's Wix Payments mode.
  - `test_mode` boolean, required — Whether the checkout is in test mode (`true`) or live (`false`).

## Other responses

- `400` — Wix Payments isn't connected for the app, or its credentials are missing. Reconnect Wix Payments.
- `401` — Missing or invalid credentials.
- `403` — The credential is not permitted or you don't have write access to the app. A missing app also fails the app access check.
- `404` — The app isn't found, or it's outside the credential's granted workspace.
- `409` — The workspace requires an unlocked SSO session.
- `422` — `test_mode` is missing or isn't a boolean, or the body has other fields.
- `429` — Rate limit reached. Retry later.

## Changes

- **2026-09-27** `5e69adeb8667` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/base44/apis/base44-app-management-api/changes/api/apps/:app_id/payments/wix/test-mode/put.md)

---

[API](https://skmtc.dev/base44/apis/base44-app-management-api.md) · [All operations](https://skmtc.dev/base44/apis/base44-app-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/base44/apis/base44-app-management-api/revisions/5e69adeb8667?raw)