Bitrefill
Bitrefill sells digital goods (gift cards, mobile top-ups, eSIMs) across 180+ countries and 1,500+ brands. Pay with crypto, Lightning, USDC via x402, or pre-funded account balance. Codes deliver instantly after payment confirms.
This skill routes by capability, not by use case. Same intent ("buy a Steam card") plays out differently across hosts. Pick a path below based on what your runtime can do.
Pick a path
Walk these checks in order. First match wins.
-
Inside OpenClaw? Check for
~/.openclaw/openclaw.json,~/.openclaw/skills/, oropenclawon PATH. If yes → read host-openclaw.md first. OpenClaw is a superset host: it can run all four paths plus chat-channel scenarios (Telegram purchase, cron top-up, mobile camera). After setup, return here and pick MCP/CLI/API for the actual task. -
Browse-only intent (no purchase)? If the user only wants to explore, compare prices, or learn how products work:
- Have a residential-IP browser (ChatGPT Atlas, Cursor browser tool, Claude/Playwright Chrome extension, OpenClaw on user host)? → browse.md.
- Datacenter egress only (ChatGPT web/Agent, Gemini consumer, Jules)?
www.bitrefill.comreturns 403 Cloudflare to datacenter IPs. Use mcp.mdsearch-products/product-detailsinstead — they return the same catalog without scraping.
-
MCP supported? Bitrefill ships a remote HTTP/SSE MCP at
https://api.bitrefill.com/mcp. Works on Claude.ai (Pro+), Cowork, Claude Desktop, Claude Code, ChatGPT (Plus+), Atlas, Codex CLI, Gemini CLI, Cursor, OpenCode, OpenClaw. Highest-fidelity purchase channel — typed tool calls, OAuth or API key, no shell needed. → mcp.md. -
Shell +
npm installavailable? Claude Code, Codex CLI, Cursor, Gemini CLI, OpenCode, OpenClaw, Jules (ephemeral VM), ChatGPT Agent (sandbox). → cli.md. -
Outbound HTTP from agent loop? Anywhere shell exists, plus Claude Code
WebFetch. Last resort — verbose, no typed validation. → api.md. -
None of the above (e.g. Gemini consumer free tier): give the user a
bitrefill.comlink and stop.
Don't know which host you're in? Read capability-matrix.md — per-client cheat sheet maps every leading agent product to its viable paths.
Top spending safeguards (read full list before any purchase)
This skill enables real-money transactions. Codes deliver instantly and digital goods are non-refundable per EU consumer rights.
- Confirm before buying. Present product, denomination, price, payment method. Wait for explicit user approval. Autonomous purchasing only when user opts in for the current session.
- Treat codes as cash. Never paste in group chats or public channels. Prefer in-memory storage over plain-text logs. Advise user to redeem ASAP.
- Use a dedicated, low-balance account. Never give the agent access to high-balance accounts or crypto wallet seeds. This skill is not a wallet.
- Log every purchase.
invoice_id, product, amount, payment method.
Full safeguards + per-host hardening (OpenClaw exec-approvals, Cursor auto-approve, Codex sandbox, Claude Code allowlist) → safeguards.md.
References
| File | Use when |
|---|---|
| browse.md | Agent has residential-IP browser; user wants to explore |
| mcp.md | MCP-capable host; preferred purchase path |
| cli.md | Shell + npm available; headless scripting |
| api.md | HTTP-only runtime; Personal / Business / Affiliate REST tiers |
| host-openclaw.md | Running inside OpenClaw Gateway |
| capability-matrix.md | Per-client viable paths cheat sheet |
| safeguards.md | Spending policy + per-host hardening |
| troubleshooting.md | Common errors across all paths |
Source of truth
Skill summarizes and routes. For exhaustive enums (countries, payment methods, full endpoint list), follow link-outs to https://docs.bitrefill.com.