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

# Access

> Activate mainnet access and set environment preferences.

## Overview

Some merchants require explicit mainnet access activation.

## Authentication

Requires merchant auth (API key or bearer JWT).

## Request

### Activate mainnet access

```ts theme={null}
await pepay.access.activateMainnetAccess({ access_key: 'access_...' });
```

### Check mainnet access status

```ts theme={null}
const status = await pepay.access.getMainnetAccessStatus();
```

### Set default environment

```ts theme={null}
await pepay.access.setEnvironment({ environment: 'mainnet' });
```

## Response

Mainnet access status response:

```json theme={null}
{
  "has_mainnet_access": true,
  "current_environment": "mainnet"
}
```

## Errors

* `401` missing/invalid auth
* `400` invalid access key or environment value
* `403` mainnet access not enabled for the account/environment

## Examples

* Keep devnet and mainnet configs separated using environment variables (`PEPAY_API_KEY_DEVNET`, `PEPAY_API_KEY_MAINNET`) and set `environment` explicitly per request where possible.

Next: [Wallets](/sdk/merchants/wallets)