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:

ItemSource
client_id and client_secretProvided by Wirex
partner_idProvided by Wirex
Webhook base URL (HTTPS)Configured during onboarding
ContractRegistry addressSee Credentials

Step 1: Environments

EnvironmentAPI Base URLChain
Sandboxhttps://api-baas.wirexapp.techBase Sepolia (84532)
Productionhttps://api-baas.wirexapp.comBase 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:

  1. Create kernel account with required modules
  2. Install FundsManagementExecutor module
  3. Install ExecutionDelayPolicy module
  4. 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:

FlowWhen to Use
Wirex HostedWirex handles verification
SumSub SharedShare existing SumSub verification
RelianceYou provide verified user data

Step 5: Operations

Once users are verified, they can access:

FeatureGuide
Payment cardsCards
Bank accountsBank Accounts
Crypto operationsCrypto Assets
Push to cardPush to Card
Transaction historyActivities

Next Steps

StepGuide
1Environments — API endpoints and chain configuration
2Partner Onboarding — Information exchange with Wirex
3Credentials — API keys and contract addresses
4Authentication — Token exchange implementation