Getting Started
Get started with Wirex BaaS platform setup, environments, and credentials.
Integration Overview
1. Partner Setup Obtain credentials, configure webhooks
↓
2. Authentication Implement S2S token exchange
↓
3. Wallet Deployment Deploy AA wallets using ZeroDev SDK
↓
4. On-Chain Registration Register wallets in Accounts contract
↓
5. User Registration POST /api/v2/user with KYC data
↓
6. Operations Cards, transfers, activities
Prerequisites
Before starting integration, you need:
| Item | Source |
|---|---|
client_id and client_secret | Provided by Wirex |
partner_id | Provided by Wirex |
| Webhook base URL (HTTPS) | Configured during onboarding |
| ContractRegistry address | See Credentials |
Step 1: Environments
| Environment | API Base URL | Chain |
|---|---|---|
| Sandbox | https://api-baas.wirexapp.tech | Base Sepolia (84532) |
| Production | https://api-baas.wirexapp.com | Base Mainnet (8453) |
See Environments for RPC endpoints and contract addresses.
Step 2: Authentication
Obtain an access token via S2S token exchange:
POST /api/v1/oauth2/token
Include the token in subsequent requests:
Authorization: Bearer <access_token>
X-Chain-Id: 8453
See Authentication for details.
Step 3: Wallet Deployment
Deploy Smart Wallets using ZeroDev SDK:
- Create kernel account with required modules
- Install FundsManagementExecutor module
- Install ExecutionDelayPolicy module
- Register in Accounts contract
See Wallet Deployment for implementation.
Step 4: User Registration
Register users via API after on-chain registration:
POST /api/v2/user
Choose a KYC flow based on your infrastructure:
| Flow | When to Use |
|---|---|
| Wirex Hosted | Wirex handles verification |
| SumSub Shared | Share existing SumSub verification |
| Reliance | You provide verified user data |
Step 5: Operations
Once users are verified, they can access:
| Feature | Guide |
|---|---|
| Payment cards | Cards |
| Bank accounts | Bank Accounts |
| Crypto operations | Crypto Assets |
| Push to card | Push to Card |
| Transaction history | Activities |
Next Steps
| Step | Guide |
|---|---|
| 1 | Environments — API endpoints and chain configuration |
| 2 | Partner Onboarding — Information exchange with Wirex |
| 3 | Credentials — API keys and contract addresses |
| 4 | Authentication — Token exchange implementation |
Updated 8 days ago
