---
updatedAt: 2026-08-16T03:25:05.000Z
agentTools:
  projectIndex: https://docs.wirexapp.com/llms.txt
---

# Getting Started

Set up the Corporate API — environments, credentials, and the two-token authentication model.

## Integration Overview

```
1. Partner Setup            Obtain credentials, configure webhooks
        ↓
2. Partner Token            POST /api/v1/token
        ↓
3. Wallet Deployment        Deploy the corporation AA wallet
        ↓
4. On-Chain Registration    Register in the CorporateAccounts contract
        ↓
5. Corporation Registration POST /api/v1/corporations/register
        ↓
6. Corporation Token        POST /api/v1/corporations/login
        ↓
7. KYB Verification         POST /api/v1/corporations/level-token
        ↓
8. Operations               Employees, cards, transfers, activities
```

***

## Retail or Corporate

Wirex BaaS exposes two separate APIs. The credentials you hold determine which one you call — a
corporate `client_id` is rejected by the retail API and vice versa.

|                                       | Retail API                                          | Corporate API                        |
| ------------------------------------- | --------------------------------------------------- | ------------------------------------ |
| **Entity**                            | An individual user                                  | A corporation with employees         |
| **Guides**                            | [For Retail Developers](https://docs.wirexapp.com/docs/retail-getting-started) | This section                         |
| **Identity carried by the API token** | User                                                | Corporation + employee + permissions |
| **Access control**                    | None beyond the token                               | Role-based, per endpoint             |
| **Verification**                      | KYC on the user                                     | KYB on the corporation               |
| **On-chain contract**                 | `Accounts`                                          | `CorporateAccounts`                  |

***

## Prerequisites

| Item                            | Source                                                            |
| ------------------------------- | ----------------------------------------------------------------- |
| `client_id` and `client_secret` | Provided by Wirex — must be registered as a **corporate** company |
| `partner_id`                    | Provided by Wirex                                                 |
| Webhook base URL (HTTPS)        | Configured during onboarding                                      |
| ContractRegistry address        | See [Credentials](https://docs.wirexapp.com/docs/corporate-credentials)                      |

***

## Step 1: Environments

| Environment | API Base URL                         | Chain                |
| ----------- | ------------------------------------ | -------------------- |
| Sandbox     | `https://api-business.wirexapp.tech` | Base Sepolia (84532) |
| Production  | `https://api-business.wirexapp.com`  | Base Mainnet (8453)  |

The Corporate API is served on its own hosts. `api-baas.wirexapp.*` serves the retail API and does not
route corporate endpoints.

See [Environments](https://docs.wirexapp.com/docs/corporate-environments) for chain IDs and sandbox credentials.

***

## Step 2: Partner Token

Exchange client credentials for a partner token:

```
POST /api/v1/token
```

The partner token reaches four endpoints only. Everything else needs a corporation token.

See [Authentication](https://docs.wirexapp.com/docs/corporate-authentication).

***

## Step 3: Wallet Deployment and On-Chain Registration

The corporation is identified on-chain by its own Account Abstraction wallet. Deploy the wallet, install
the executor, the corporate policy and `CorporateValidator`, then call
`createCorporationForCorporateWallet(partnerId, wallet)` on the `CorporateAccounts` contract. The
address recorded as the wallet's creator becomes the corporation owner.

> `CorporateValidator` is what lets employees sign for the corporation. The older `createCorporation`
> path produces a single-key corporation and is obsolete — see
> [Wallet Deployment](https://docs.wirexapp.com/docs/corporate-onchain-registration).

See [Wallet Deployment](https://docs.wirexapp.com/docs/corporate-onchain-registration).

***

## Step 4: Register the Corporation

```
POST /api/v1/corporations/register
```

Only the on-chain owner can register the corporation. Registration links the on-chain corporation to a
Wirex corporation record and completes the owner's employee record.

See [Registering a Corporation](https://docs.wirexapp.com/docs/corporate-registration).

***

## Step 5: Corporation Token

```
POST /api/v1/corporations/login
```

Returns a corporation token carrying the corporation address, the employee id, the role and the resolved
permission set. Every corporation-scoped endpoint requires it.

***

## Step 6: KYB Verification

Capabilities stay locked until the corporation passes the verification level each capability requires.
Verification runs in the SumSub SDK, initialised with a token from the API.

See [Verification (KYB)](https://docs.wirexapp.com/docs/corporate-verification).

***

## Step 7: Operations

| Feature                     | Guide                                        |
| --------------------------- | -------------------------------------------- |
| Employees and roles         | [Team Management](https://docs.wirexapp.com/docs/corporate-team)        |
| Wallets, balances, FX       | [Wallets](https://docs.wirexapp.com/docs/corporate-wallets)             |
| Payment cards               | [Cards](https://docs.wirexapp.com/docs/corporate-cards)                 |
| Bank accounts and transfers | [Bank Accounts](https://docs.wirexapp.com/docs/corporate-bank-accounts) |
| Recipients                  | [Recipients](https://docs.wirexapp.com/docs/corporate-recipients)       |
| Transaction history         | [Activities](https://docs.wirexapp.com/docs/corporate-activities)       |

***

## Next Steps

| Step | Guide                                                                              |
| ---- | ---------------------------------------------------------------------------------- |
| 1    | [Environments](https://docs.wirexapp.com/docs/corporate-environments) — base URLs and chain configuration     |
| 2    | [Credentials](https://docs.wirexapp.com/docs/corporate-credentials) — credentials and contract addresses      |
| 3    | [Authentication](https://docs.wirexapp.com/docs/corporate-authentication) — the two-token model               |
| 4    | [Permissions](https://docs.wirexapp.com/docs/corporate-permissions) — which permission each endpoint requires |