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

# Mode

> Switch your business between test (testnet) and live (mainnet) mode.

## Toggle business mode

<div className="api-method-box">
  <span className="api-method post">POST</span> `/business/mode`
</div>

Switches the authenticated business between **test** and **live** mode. Live mode requires completed onboarding.

| Mode   | Network | Real funds |
| ------ | ------- | ---------- |
| `test` | Testnet | No         |
| `live` | Mainnet | Yes        |

<Warning>
  You must complete the onboarding process before switching to live mode. If onboarding is incomplete, the API returns an error.
</Warning>

<ResponseExample>
  ```bash cURL theme={null}
  curl -X POST https://api.orafi.app/v1/business/mode \
    -H "Content-Type: application/json" \
    -H "x-api-key: ora_test_your_api_key"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch("https://api.orafi.app/v1/business/mode", {
    method: "POST",
    headers: { "x-api-key": "ora_test_your_api_key" }
  });
  ```

  ```json 200 — Success theme={null}
  {
    "success": true,
    "message": "Mode switched to live successfully"
  }
  ```

  ```json 400 — Onboarding incomplete theme={null}
  {
    "status": "Error",
    "message": "Complete onboarding process to switch to live mode"
  }
  ```
</ResponseExample>