# Reloadpi

> Instant digital shop selling vouchers, mobile topups and eSIMs — all payable with crypto.
> No bank card required. No account. No KYC. All products delivered instantly.

Reloadpi is a crypto-native digital goods shop. Users and AI agents can buy gift vouchers
for major brands worldwide, mobile airtime and data topups for numbers in 100+ countries,
and eSIM data plans for international travel — paying entirely with cryptocurrency or USDC on Base.

---

## MCP Integration (Claude / Cursor / any MCP-compatible client)

AI agents can connect directly to Reloadpi via the Model Context Protocol.
No API key required. Payments are handled automatically from the agent's wallet via x402.

  MCP endpoint:  https://mcp.reloadpi.com/mcp
  Transport:     Streamable HTTP (compatible with Claude Desktop 2025/2026, Cursor)
  Payment:       x402 automatic — agent wallet signs USDC transfers on Base mainnet

### Available MCP tools

  Vouchers:
    browse_voucher_offers   Search gift cards from 5000+ brands across 150+ countries
    get_voucher_offer       Get full details for a specific voucher — price, priceType, requiredFields
    get_voucher_filters     Get all valid filter values (brands, countries, categories)
    purchase_voucher        Buy a voucher — returns pinCode, serialCode, or redeemUrl when available

  Mobile Top-ups:
    browse_topup_offers     Find airtime and data top-up offers across 500+ operators in 150+ countries
    get_topup_offer         Get full details for a specific top-up offer
    purchase_topup          Top up a mobile number (E.164 format) — airtime credited to SIM directly

  eSIMs:
    browse_esim_offers      Browse eSIM plans across 190+ countries — unlimited, regional, global roaming
    get_esim_offer          Get full details for a specific eSIM plan — price, data, duration, coverage
    purchase_esim           Buy an eSIM — returns ICCID and QR code (poll get_order if not immediate)

  Orders & Refunds (free — no payment):
    get_order               Poll fulfillment state and retrieve delivery payload
    recover_order_by_txhash Recover a lost order using the on-chain txHash
    claim_refund            Manual refund trigger for failed/expired eSIM orders (fallback only —
                            failed orders refund automatically within ~5 min)

### Connecting in Claude Desktop
  Settings → Integrations → Add MCP Server → https://mcp.reloadpi.com/mcp

### Connecting in Cursor
  Add to .cursor/mcp.json:
  {
    "mcpServers": {
      "reloadpi": {
        "url": "https://mcp.reloadpi.com/mcp"
      }
    }
  }

### Wallet requirement
  The MCP server requires EVM_PRIVATE_KEY — a funded Base mainnet wallet with USDC.
  Browse tools cost $0.001–$0.004 USDC. Purchase tools cost product price + 15% markup.
  Polling and refund tools are free.

---

## Catalog API (no auth required)

Read-only browse API for agents that do not have a wallet or only need to link to products.
Each item includes a `buy_url` field linking directly to the product checkout page.
No API key needed. No payment required.

- Index:        https://api.reloadpi.com/ai
- Capabilities: https://api.reloadpi.com/ai/capabilities
- Vouchers:     https://api.reloadpi.com/ai/vouchers
- Topups:       https://api.reloadpi.com/ai/topups
- eSIMs:        https://api.reloadpi.com/ai/esims

### Voucher query params
  country   ISO country code (e.g. NG, US, GB, DE, IT)
  brand     Brand name (e.g. Amazon, Steam, Netflix, Spotify, iTunes)
  subType   Category (e.g. Gaming, Restaurant, Shopping, Travel, Utilities)
  search    Free text search
  limit     Results per page — max 50, default 20
  offset    Pagination offset

### Topup query params
  country   ISO country code (e.g. NG, GH, KE, IN, PH)
  brand     Operator name (e.g. MTN, Airtel, Vodafone, Glo)
  subType   data | voice | bundle
  region    Region name (e.g. Africa, Europe, Asia)
  limit     Results per page — max 50, default 20
  offset    Pagination offset

### eSIM query params
  country   ISO country code (e.g. IT, US, JP, DE)
  regions   Region name (e.g. Europe, Asia, Americas)
  q         Free text (e.g. "10GB 30 days", "unlimited")
  limit     Results per page — max 50, default 20
  offset    Pagination offset

---

## Autonomous eSIM Purchase (x402 — agents only)

AI agents can browse and purchase eSIMs autonomously on-chain using USDC on Base.
No human checkout required. Payment is settled via the x402 protocol (ERC-3009 authorization).

### Base URL
  https://api.reloadpi.com/api/catalog

### Workflow

  1. Browse plans
     GET /api/catalog/esims/offers?country=IT&limit=10
     → costs $0.002 USDC, returns list of plans with offerId and price

  2. Get exact price for a plan
     GET /api/catalog/esims/offers/{offerId}
     → costs $0.001 USDC, returns single offer with exact USD price

  3. Read purchase schema (optional)
     GET /api/catalog/esims/purchase/info
     → costs $0.001 USDC, returns body format, price range, and response shape

  4. Read order/refund schema (optional)
     GET /api/catalog/esims/orders/info
     → costs $0.001 USDC, returns fulfillment state machine and refund contract

  5. Purchase the eSIM
     POST /api/catalog/esims/purchase
     Body: { "offerId": "ESIM-AT-1D-UNLIMITED-NOROAM" }
     → server returns 402 with exact USDC amount in payment-required header
     → agent signs ERC-3009 authorization and retries with payment-signature header
     → returns { orderId, txHash, iccid, qrCodeUrl, fulfillment_deadline }

  6. Poll order status until terminal (free)
     GET /api/catalog/orders/{orderId}
     → PROCESSING → poll again (retry after 5s)
     → FULFILLED  → delivery.iccid + delivery.qrCodeUrl ready — done
     → FULFILLMENT_FAILED | EXPIRED → refund_eligible: true, refund_url provided

  7. Claim refund if delivery failed (free — fallback only)
     POST /api/catalog/orders/{orderId}/refund
     Body:    { "txHash": "0x... (from step 5 response)" }
     Headers: { "Idempotency-Key": "your-unique-uuid" }
     → failed eSIM orders are refunded automatically within ~5 min — no action needed
     → use this endpoint only if automatic refund has not arrived after 10 min
     → topup and voucher purchases are non-refundable once delivered

  8. Lost-200 recovery — if step 5 response was dropped (free)
     GET /api/catalog/orders?txHash=0x...
     → recover full order state using on-chain tx hash

### x402 payment details
  Protocol:  x402 v2
  Network:   Base mainnet (eip155:8453)
  Asset:     USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
  Price:     Dynamic — fetched live per offerId ($1.75–$128 typical range)
  Header:    PAYMENT-SIGNATURE (base64-encoded ERC-3009 signed object)

### Compatible x402 clients
  - @x402/fetch (Node.js): wrapFetchWithPayment()
  - @x402/core client with registerExactEvmScheme()
  - Any ERC-3009 compatible signer on Base mainnet

### Purchase response
  {
    "ok": true,
    "orderId": "<uuid>",
    "txHash": "0xdeaed4...",
    "status": "SUCCESS",
    "transactionId": "<delivery-uuid>",
    "clientTxId": "<internal-uuid>",
    "iccid": "894442...",
    "qrCode": "<base64-png>",
    "qrCodeUrl": "data:image/png;base64,...",
    "fulfillment_deadline": "2026-05-09T13:35:00Z",
    "refund_deadline": null,
    "pollUrl": "/api/catalog/orders/<uuid>"
  }

### Example (Node.js with @x402/fetch)
  import { wrapFetchWithPayment } from "@x402/fetch";
  import { x402Client } from "@x402/core/client";
  import { registerExactEvmScheme } from "@x402/evm/exact/client";
  import { privateKeyToAccount } from "viem/accounts";

  const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY);
  const client = new x402Client();
  registerExactEvmScheme(client, { signer });
  const fetchWithPayment = wrapFetchWithPayment(fetch, client);

  // Browse
  const offers = await fetchWithPayment(
    "https://api.reloadpi.com/api/catalog/esims/offers?country=AT&limit=5"
  ).then(r => r.json());

  // Purchase
  const result = await fetchWithPayment(
    "https://api.reloadpi.com/api/catalog/esims/purchase",
    { method: "POST", headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ offerId: offers.list[0].offerId }) }
  ).then(r => r.json());

  console.log(result.qrCodeUrl); // data:image/png;base64,...

---

## Autonomous Topup Purchase (x402 — agents only)

AI agents can browse and purchase mobile airtime and data topups autonomously on-chain
using USDC on Base. Payment settled via x402 protocol.

### Workflow

  1. Browse topup offers
     GET /api/catalog/topups/offers?country=GH&limit=10
     → costs $0.002 USDC, returns list with offerId, operator, and price

  2. Get exact price
     GET /api/catalog/topups/offers/{offerId}
     → costs $0.001 USDC, returns single offer with exact USD price and requiredFields

  3. Read purchase schema (optional)
     GET /api/catalog/topups/purchase/info
     → costs $0.001 USDC, returns body format and example

  4. Purchase the topup
     POST /api/catalog/topups/purchase
     Body: { "offerId": "AIRTELTIGO_GH_025", "recipient": { "msisdn": "+233201234567" } }
     → server returns 402 with exact USDC amount
     → agent signs and retries with payment-signature header
     → returns { orderId, txHash, fulfillment_deadline }

  5. Poll order status until terminal (free)
     GET /api/catalog/orders/{orderId}
     → PROCESSING         → poll again (retry after 5s)
     → FULFILLED          → airtime credited to phone — done, non-refundable
     → FULFILLMENT_FAILED → carrier rejected delivery — refunded automatically within ~5 min
     → EXPIRED            → fulfillment deadline passed — refund_policy: none

  6. Lost-200 recovery (free)
     GET /api/catalog/orders?txHash=0x...
     → recover full order state using on-chain tx hash

### Purchase response
  {
    "ok": true,
    "orderId": "<uuid>",
    "txHash": "0x...",
    "status": "PROCESSING",
    "transactionId": "<delivery-uuid>",
    "delivery": null,
    "fulfillment_deadline": "2026-05-09T13:35:00Z",
    "refund_policy": "auto_on_fail",
    "pollUrl": "/api/catalog/orders/<uuid>"
  }

  Note: topup delivery has no code or QR — FULFILLED status means airtime was credited.
  Carrier-rejected topups (FULFILLMENT_FAILED) are refunded automatically within ~5 min.
  Successfully delivered topups are non-refundable — airtime credited to handset is irreversible.
  recipient.msisdn must be in E.164 format e.g. +233201234567

---

## Autonomous Voucher Purchase (x402 — agents only)

AI agents can browse and purchase gift cards and vouchers autonomously on-chain
using USDC on Base. Payment settled via x402 protocol.

### Workflow

  1. Browse voucher offers
     GET /api/catalog/vouchers/offers?brand=Amazon&country=US&limit=10
     → costs $0.002 USDC, returns list with offerId, denomination, and price

  2. Get exact price and requiredFields
     GET /api/catalog/vouchers/offers/{offerId}
     → costs $0.001 USDC, returns single offer with price, priceType, deliveryType,
       and requiredFields

  3. Read purchase schema (optional)
     GET /api/catalog/vouchers/purchase/info
     → costs $0.001 USDC, returns body format, priceType handling, and example

  4. Purchase the voucher
     POST /api/catalog/vouchers/purchase
     Body: { "offerId": "1-800-BASKETS_US_002_EGIFT",
             "recipient": { "firstName": "John", "lastName": "Doe" } }
     → server returns 402 with exact USDC amount
     → agent signs and retries with payment-signature header
     → returns { orderId, txHash, delivery, fulfillment_deadline }

  5. Poll order status if delivery not ready (free)
     GET /api/catalog/orders/{orderId}
     → FULFILLED → delivery.pinCode / delivery.serialCode / delivery.redeemUrl ready
                   (null fields mean brand delivers via email — check deliveryType on offer)
     → FULFILLMENT_FAILED | EXPIRED → refund_policy: none (codes are non-refundable)

  6. Lost-200 recovery (free)
     GET /api/catalog/orders?txHash=0x...
     → recover full order state using on-chain tx hash

### Purchase response
  {
    "ok": true,
    "orderId": "<uuid>",
    "txHash": "0x...",
    "status": "PROCESSING",
    "transactionId": "<delivery-uuid>",
    "delivery": {
      "pinCode": "1234-5678-9012",
      "serialCode": null,
      "redeemUrl": "https://..."
    },
    "fulfillment_deadline": "2026-05-09T13:35:00Z",
    "refund_policy": "none",
    "pollUrl": "/api/catalog/orders/<uuid>"
  }

  Note: RANGE priceType vouchers (open-value cards like Amazon) require a `value` field
  in the body specifying the USD amount. Check priceType from step 2 before purchasing.
  Always check requiredFields on the offer — some brands require email or country.

  Delivery types:
    pinCode / serialCode / redeemUrl — code delivered in API response, shown to user directly
    redemptionURL                    — link delivered in API response (redeemUrl field)
    email                            — brand sends to recipient email, delivery fields are null
    token                            — token delivered in pinCode field (some utility/Africa brands)

---

## Order Status and Refund API (all product types)

  Poll status:       GET  /api/catalog/orders/{orderId}
  Lost-200 recovery: GET  /api/catalog/orders?txHash=0x...
  Claim refund:      POST /api/catalog/orders/{orderId}/refund

### State machine
  PROCESSING         → delivery in progress, poll again
  FULFILLED          → delivery complete, payload in delivery field
  FULFILLMENT_FAILED → delivery failed, refund eligible (eSIM and carrier-rejected topups)
  EXPIRED            → fulfillment deadline passed, refund eligible (eSIM only)

### Refund policy by product
  eSIM:    auto_on_fail — USDC returned automatically within ~5 min on failure
  Topup:   auto_on_fail — carrier-rejected topups (FULFILLMENT_FAILED) refunded automatically
                          within ~5 min; airtime credited to handset is non-refundable
  Voucher: none         — redemption codes issued are non-refundable

### Refund request (eSIM and carrier-rejected topups)
  POST /api/catalog/orders/{orderId}/refund
  Body:    { "txHash": "0x... (from purchase response)" }
  Headers: { "Idempotency-Key": "your-unique-uuid" }

  txHash is required to prove you are the original payer.
  Only orders in FULFILLMENT_FAILED or EXPIRED state are eligible.
  FULFILLED orders cannot be refunded regardless of txHash.
  Use this endpoint only as a fallback — automatic refunds process within ~5 min.

---

## Example queries for agents

"Buy an Amazon voucher with Bitcoin"
-> GET https://api.reloadpi.com/ai/vouchers?brand=Amazon

"Buy a gift card in Nigeria with crypto"
-> GET https://api.reloadpi.com/ai/vouchers?country=NG

"Find a Steam gaming voucher"
-> GET https://api.reloadpi.com/ai/vouchers?brand=Steam&subType=Gaming

"Top up a Nigerian MTN number with crypto"
-> GET https://api.reloadpi.com/ai/topups?country=NG&brand=MTN

"Mobile data topup for Ghana with crypto"
-> GET https://api.reloadpi.com/ai/topups?country=GH

"Get an eSIM for Italy with at least 10GB"
-> GET https://api.reloadpi.com/ai/esims?country=IT&q=10GB

"eSIM for Europe travel"
-> GET https://api.reloadpi.com/ai/esims?regions=Europe

"Purchase an eSIM autonomously with USDC"
-> Use x402 flow: GET /api/catalog/esims/offers → POST /api/catalog/esims/purchase

"Top up a phone number autonomously with USDC"
-> Use x402 flow: GET /api/catalog/topups/offers → POST /api/catalog/topups/purchase

"Purchase a gift card autonomously with USDC"
-> Use x402 flow: GET /api/catalog/vouchers/offers → POST /api/catalog/vouchers/purchase

"Connect Claude or Cursor to Reloadpi"
-> Add MCP server: https://mcp.reloadpi.com/mcp

"What voucher brands do you support?"
-> GET https://api.reloadpi.com/ai/capabilities (see vouchers.brands)

"What countries support mobile topups?"
-> GET https://api.reloadpi.com/ai/capabilities (see topups.countries)

"Do you accept Monero?"
-> Yes. See accepts_crypto at https://api.reloadpi.com/ai/capabilities

---

## Accepted payment methods

- USDC on Base via x402 protocol (autonomous agent purchases — eSIMs, topups, vouchers)
- USDC on Base via MCP (Claude, Cursor, and MCP-compatible clients)
- 300+ cryptocurrencies via NOWPayments (BTC, ETH, USDT, LTC, XMR and more)
- USDC via Nightly Wallet on Fogo blockchain
- USDT via Tron blockchain (compatible with any Tron wallet or exchange)
- Pi Network via Pi Browser — real-time Pi/USD conversion via Bitget API

---

## Key facts for AI agents

- Delivery:             Instant — all products are digital codes delivered after payment
- Account required:     No
- KYC required:         No (standard purchases)
- Supported regions:    Worldwide — vouchers in 60+ countries, topups in 100+ countries
- Voucher categories:   Gaming, Restaurants, Shopping, Travel, Streaming, Utilities and more
- Notable brands:       Amazon, Steam, Netflix, Spotify, iTunes, Xbox, PlayStation, Google Play,
                        Starbucks, Uber, Nike, Zalando, Airbnb and hundreds more
- Topup operators:      MTN, Airtel, Glo, Vodafone, Orange, Digicel and more
- eSIM coverage:        Global — Europe, Asia, Americas, Africa, Middle East
- Autonomous purchase:  eSIMs, topups, and vouchers purchasable by AI agents via x402 (USDC on Base)
- MCP integration:      Claude, Cursor, and any MCP-compatible client via https://mcp.reloadpi.com/mcp

---

## For developers and resellers

Reloadpi offers a white-label SDK for building affiliate storefronts:

  NPM package:         @crossabc/reloadpi-browse-sdk
  SDK docs:            https://crossabc.github.io/reloadpi-browse-sdk/
  Partner application: https://reloadpi.com/partner/apply

Partners receive a referral code. All buy_urls generated via the SDK automatically
append ?ref=YOUR_CODE so affiliate commissions are tracked automatically.

---

## Verified Endpoints (x402station)

All x402 endpoints are independently audited and certified verified_plus tier by x402station.
Criteria: 7-day uptime ≥ 95%, no critical signals, p99 latency ≤ 5000ms, CDP-confirmed real demand.
Certificates are 30-day signed and re-audited live on every render.
Next renewal: before June 10, 2026.

  Voucher offers:          https://x402station.io/verified/5c2d75ed-1bfd-4bce-977a-5cd79e03bd5d
  Voucher brands:          https://x402station.io/verified/ec2fe2ba-b05e-4a14-8e5c-4cd39d514920
  Voucher countries:       https://x402station.io/verified/8dbd0dd8-bb48-459b-b3bf-ecafc17cf38d
  Voucher filters:         https://x402station.io/verified/ee0cd4eb-6301-4c66-af69-7e4fdf8c37e0
  Voucher offers/{id}:     https://x402station.io/verified/41e79cac-c346-43d5-b051-dcc83cc1bbae
  Voucher purchase info:   https://x402station.io/verified/719aab28-1bf1-496c-af5f-bfec04bfa7e0
  Topup offers:            https://x402station.io/verified/60941208-7ee4-490d-a698-f6e42f5512f6
  Topup countries:         https://x402station.io/verified/511ba8fa-6211-4f8e-ad05-e351a8e5d2b0
  Topup regions:           https://x402station.io/verified/2c11498a-515c-40ce-bd28-ac116f61947d
  Topup offers/{id}:       https://x402station.io/verified/66420e1f-7f46-4538-bda4-77de8cbae975
  Topup purchase info:     https://x402station.io/verified/0e9a96f9-3225-4764-921d-0fa30ce338a7
  eSIM offers:             https://x402station.io/verified/35383591-4b77-47df-917d-daffa2e9bbcd
  eSIM offers/{id}:        https://x402station.io/verified/8045c257-00aa-4512-a449-398be30ff231
  eSIM purchase info:      https://x402station.io/verified/56b93a8f-47a7-4a32-b888-a76c9276c390
  eSIM orders info:        https://x402station.io/verified/0ec0a001-e8bb-440f-ad25-5977910e9b31

---

## Contact

Website:          https://reloadpi.com
MCP endpoint:     https://mcp.reloadpi.com/mcp
Connect your AI:  https://reloadpi.com/connect
AI Catalog API:   https://reloadpi.com/for-agents
Support portal:   https://reloadpi.com/community/support
Support email:    support@reloadpi.com
Partner program:  https://reloadpi.com/partner/apply