# ConnectMeGuru B2B Wholesale eSIM Platform - Full Technical Knowledge Base
Version: 1.0.0
Base URL: https://partner.connectmeguru.com
Developer Docs: https://partner.connectmeguru.com/docs

## 1. System Architecture & Capabilities
ConnectMeGuru Wholesale Gateway is designed for automated business-to-business consumption:
- Sub-second eSIM profile allocation via direct carrier integrations (Tier-1 telco interconnects).
- Multi-carrier automatic network switching in key destinations (e.g. AT&T + T-Mobile in US, Vodafone + O2 in UK, NTT Docomo + SoftBank in Japan).
- Coverage across 200+ countries with 4G LTE and 5G high-speed local data breakout.
- No KYC required for standard data roaming packages.
- Zero-touch top-ups: End travelers keep their existing profile active without downloading another QR code.

## 2. Authentication Model
Partners authenticate requests using an API Key ID and Secret combination issued from the Partner Portal (https://partner.connectmeguru.com/api-keys).

Header format:
Authorization: Bearer <keyId>:<secret>

Example:
curl -X GET "https://partner.connectmeguru.com/api/b2b/v1/plans?countryCode=US" \
  -H "Authorization: Bearer cmg_key_live_abcdef123:sec_9876543210fedcba" \
  -H "Content-Type: application/json"

## 3. Endpoints Specification

### 3.1 Search Wholesale Plans
GET /api/b2b/v1/plans
Query Parameters:
- country (string, optional): ISO 3166-1 alpha-2 code (e.g. 'US', 'GB', 'FR', 'JP', 'TH').
- type (string, optional): 'BASE' (new eSIM) or 'TOPUP' (recharges).
- query (string, optional): Search across plan name, country, or carrier.
- cmgProductId (string, optional): Filter by exact CMG Product ID.
- page (integer, optional): Page number (default: 1).
- limit (integer, optional): Items per page (default: 100).

Response 200 OK:
{
  "success": true,
  "currency": "USD",
  "total": 4,
  "plans": [
    {
      "cmgProductId": "AA-US-7D-1GB",
      "name": "United States 1GB 7 Days",
      "locationCodes": ["US"],
      "locationNames": ["United States"],
      "dataAmountGb": 1.0,
      "durationDays": 7,
      "priceUsd": 2.25,
      "speed": "5G / 4G LTE",
      "topUpAllowed": true
    }
  ]
}

### 3.2 Place New eSIM Order
POST /api/b2b/v1/orders
Request Body:
{
  "cmgProductId": "AA-US-7D-1GB",
  "partnerRefId": "ORDER_CLIENT_100234",
  "expectedPriceUsd": 2.25
}

Response 200 OK:
{
  "success": true,
  "order": {
    "orderNo": "ORD-20261010-8841",
    "iccid": "8985234100000000001",
    "cmgProductId": "AA-US-7D-1GB",
    "planName": "United States 1GB 7 Days",
    "chargedUsd": 2.25,
    "status": "COMPLETED",
    "qrCodeUrl": "https://partner.connectmeguru.com/api/qr/8985234100000000001.png",
    "smdpAddress": "rsp.connectmeguru.com",
    "matchingId": "CMG-ACT-XXXX-YYYY",
    "lpaString": "LPA:1$rsp.connectmeguru.com$CMG-ACT-XXXX-YYYY"
  }
}

### 3.3 Check Real-Time Data Usage
GET /api/b2b/v1/orders/{iccid}/usage

Response 200 OK:
{
  "success": true,
  "iccid": "8985234100000000001",
  "totalDataBytes": 1073741824,
  "consumedBytes": 429496729,
  "remainingBytes": 644245095,
  "percentageUsed": 40.0,
  "status": "ACTIVE",
  "expiresAt": "2026-10-17T12:00:00Z"
}

### 3.4 Execute Immediate Top-Up
POST /api/b2b/v1/orders/{iccid}/topup
Request Body:
{
  "packageCode": "CMG-US-TOPUP-3GB",
  "partnerRefId": "TOPUP_CLIENT_5521"
}

Response 200 OK:
{
  "success": true,
  "message": "Top-up provisioned successfully onto ICCID.",
  "chargedUsd": 4.50,
  "newExpiration": "2026-10-24T12:00:00Z"
}

### 3.5 Check Prepaid Wallet Balance
GET /api/b2b/v1/balance

Response 200 OK:
{
  "success": true,
  "balanceUsd": 845.50,
  "currency": "USD",
  "tier": "Tier-1",
  "lowBalanceThreshold": 100.0
}

## 4. Device Compatibility Standards
ConnectMeGuru eSIM profiles are compatible with all GSMA-compliant unlocked eSIM devices:
- Apple: iPhone XS, XR, 11, 12, 13, 14, 15, 16 series, iPad Pro/Air with cellular.
- Samsung: Galaxy S20, S21, S22, S23, S24 series, Galaxy Z Flip/Fold series.
- Google: Pixel 3, 3a, 4, 5, 6, 7, 8, 9 series.
- Android: Devices running Android 10+ with eUICC chip hardware enabled.

## 5. Settlement & Deposit Methods
Partners maintain a prepaid balance pool:
- PayPal Direct Settlement: Instant auto-credited via PayPal checkout.
- Automated Crypto Gateway: USDT (TRC-20, ERC-20), USDC, BTC with instant on-chain TX confirmation.
- Minimum deposit: $50.00 USD.
- Anti-Chargeback Policy: All wholesale balance top-ups represent irrevocable digital eSIM inventory.

## 6. Support & Developer Resources
- Technical Documentation: https://partner.connectmeguru.com/docs
- Global Travel eSIM Directory: https://partner.connectmeguru.com/directory
- B2B Partner Contact & Inquiries Desk: https://partner.connectmeguru.com/contact
- Partner Support Email: partnerships@connectmeguru.com
- Partner FAQ: https://partner.connectmeguru.com/faq
- Terms of Service: https://partner.connectmeguru.com/terms
- Privacy Policy: https://partner.connectmeguru.com/privacy