# ConnectMeGuru B2B Wholesale eSIM Platform
> Enterprise eSIM Infrastructure & Real-Time Provisioning Gateway for Travel Companies, OTAs, Fintechs, and Aggregators.

## Overview
ConnectMeGuru Wholesale Gateway (partner.connectmeguru.com) is a carrier-grade B2B connectivity infrastructure providing automated, programmatic provisioning of international eSIM profiles across 200+ countries and territories. Partners leverage wholesale pricing, prepaid balance wallets, instant QR code and LPA delivery, and automated data monitoring via a RESTful API.

## Core Capabilities
- **Global Coverage**: Over 200 destinations, country-specific plans, and regional bundles (Europe 33+, Asia 18+, North America, Latin America, Global 130+).
- **Instant Provisioning**: Sub-second eSIM profile creation returning QR code URL, SM-DP+ address, matching ID, and direct iOS/Android LPA strings.
- **Top-Up Support**: Zero-touch top-ups on existing ICCIDs without needing physical reinstallation by end travelers.
- **Data Usage Monitoring**: Live data consumption tracking and expiration status queries per ICCID.
- **Prepaid Wallet & Treasury**: Programmatic balance ledger supporting USD top-ups via PayPal and automated Crypto (USDT/USDC/BTC) settlement.
- **Webhook Subscriptions**: Instant real-time alerts for order lifecycle events and automated top-up completions.

## API Documentation & Machine Interfaces
- Interactive Developer Portal: https://partner.connectmeguru.com/docs
- AI Agent Discovery Manifest: https://partner.connectmeguru.com/agent.json
- Full Context LLM Knowledge Base: https://partner.connectmeguru.com/llms-full.txt

## Key Endpoints
- `GET /api/b2b/v1/plans`: Search and list wholesale eSIM catalog by ISO country code, region, data volume, and validity duration.
- `POST /api/b2b/v1/orders`: Order and instantly provision a new eSIM profile.
- `GET /api/b2b/v1/orders/{iccid}`: Retrieve order details, SM-DP+ credentials, and QR code.
- `GET /api/b2b/v1/orders/{iccid}/usage`: Real-time data consumption telemetry (total bytes, consumed bytes, remaining bytes).
- `GET /api/b2b/v1/orders/{iccid}/topup-plans`: Available data package expansions for an active eSIM.
- `POST /api/b2b/v1/orders/{iccid}/topup`: Execute immediate data top-up onto an active ICCID.
- `GET /api/b2b/v1/balance`: Query partner prepaid credit balance in USD.

## Authentication
All API requests require Bearer token authentication generated from the Partner Dashboard:
```http
Authorization: Bearer <keyId>:<secret>
Content-Type: application/json
```

## Portal & Partner Management
- Global Travel eSIM Retailers Directory: https://partner.connectmeguru.com/directory
- B2B Partner Contact & Partnerships Desk: https://partner.connectmeguru.com/contact
- Partner Registration: https://partner.connectmeguru.com/register
- Partner Sign In: https://partner.connectmeguru.com/login
- Partner Dashboard: https://partner.connectmeguru.com/dashboard
- Partner FAQ: https://partner.connectmeguru.com/faq
- Terms of Service: https://partner.connectmeguru.com/terms
- Privacy Policy: https://partner.connectmeguru.com/privacy
- Cancellation & Refund Policy: https://partner.connectmeguru.com/cancellation-policy