Bitrefill primary sources — 2026-05-01

Project status in this pass

• No canonical standalone whitepaper or litepaper surfaced.
• The clearest current source of truth is Bitrefill’s official API/docs surface, help-center integration guidance, Thor API docs, and first-party GitHub repos.

Primary-source snapshots

1) API overview

• URL: https://docs.bitrefill.com/docs/api-overview
• Key excerpt:
  • Bitrefill says its API lets developers programmatically purchase gift cards, mobile top-ups, and eSIMs.
  • The docs highlight browsing products across 170+ countries, creating invoices, paying with Bitcoin, Lightning, Ethereum, USDC, USDT, or account balance, tracking orders, and managing eSIMs.
  • The access model is split across Personal, Business, and Affiliate APIs, which is a useful clue that Bitrefill treats commerce access as a programmable platform rather than just a storefront.

2) Hosted eCommerce MCP

• URL: https://docs.bitrefill.com/docs/ecommerce-mcp
• Key excerpt:
  • Bitrefill says the hosted MCP lets AI assistants search products, inspect denominations, create invoices, track invoices and orders, and retrieve delivered redemption info.
  • The official hosted endpoint is https://api.bitrefill.com/mcp, with OAuth or API-key access.
  • The published hosted tool set is deliberately curated to 7 tools, which suggests Bitrefill is designing a specific AI-commerce operating surface rather than exposing a raw API wrapper.

3) Partner integration guidance

• URL: https://help.bitrefill.com/hc/en-us/articles/8576552808722-Can-I-integrate-Bitrefill-and-sell-gift-cards-directly-from-my-website-or-app
• Key excerpt:
  • The help-center article says Bitrefill’s integration widget lets partners offer thousands of gift cards and mobile refills directly inside a website or app.
  • It also frames the widget as a revenue-sharing surface by saying partners can earn passive income from each sale.
  • That is a strong signal that Bitrefill operates a partner-distribution layer, not only a direct-consumer shop.

4) Thor Lightning API docs

• URL: https://github.com/bitrefill/thor-api-doc
• Key excerpt:
  • The Thor docs define inventory and order flows for lightning-recharge, lightning-channel, and turbo-lightning-channel.
  • Orders can be paid with Lightning, Bitcoin, and some altcoin methods, then tracked by polling or webhook.
  • The success responses include Thor-specific redemption info such as links and LNURL material for opening Lightning channels, which shows Bitrefill is packaging Lightning utility infrastructure alongside commerce.

5) GitHub org and AI-facing repos

• URLs:
  • https://github.com/bitrefill
  • https://github.com/bitrefill/bitrefill-mcp-server
  • https://github.com/bitrefill/cli
• Key excerpt:
  • GitHub marks the Bitrefill org as verified for bitrefill.com and www.bitrefill.com.
  • The org publicly exposes bitrefill-mcp-server, cli, agents, awesome-agentic-payments, and x402, which is unusually explicit AI- and machine-payment positioning.
  • The MCP repo says the hosted remote MCP is the recommended production path, while the CLI repo says the CLI discovers MCP tools dynamically and can generate agent-facing LLM context.

Working conclusion

Bitrefill is best cataloged as crypto spending and agentic-commerce infrastructure with a partner-distribution layer and a sidecar Lightning-utility business. The strongest evidence is the combination of product-catalog APIs, hosted MCP tooling, partner widget guidance, Thor channel/recharge APIs, and first-party repos centered on agent workflows and machine-payment interfaces.