# OpenReceive

> Open-source libraries for accepting inbound Bitcoin Lightning payments
> directly into a wallet the application owner controls, plus plugins that do
> the same for WooCommerce and Easy Digital Downloads (one WordPress plugin),
> Paymenter, FOSSBilling, PrestaShop, Odoo, Medusa, Vendure and BTCPay Server.
> Optional swaps let payers use USDT, USDC, SOL or ETH, which a configured swap
> provider converts to BTC over Lightning in the same wallet. OpenReceive never
> holds funds, has no accounts or API keys, and connects through a
> receive-only Nostr Wallet Connect (NWC) code. This index describes
> OpenReceive 0.4.31.

Every documentation link below is raw markdown — fetch it directly, no browser
needed. Appending `.md` to any guide page URL returns the same document as
markdown.

## Start here

- [Express Quickstart (Node)](https://openreceive.org/guides/quickstart-node.md)
- [Fastify Quickstart](https://openreceive.org/guides/quickstart-fastify.md)
- [NestJS Quickstart](https://openreceive.org/guides/quickstart-nestjs.md)
- [FastAPI Quickstart](https://openreceive.org/guides/quickstart-fastapi.md)
- [Django Quickstart](https://openreceive.org/guides/quickstart-django.md)
- [Flask Quickstart](https://openreceive.org/guides/quickstart-flask.md)
- [Next.js Quickstart](https://openreceive.org/guides/quickstart-next.md)
- [Rails Quickstart](https://openreceive.org/guides/quickstart-rails.md)
- [PHP Quickstart (plain PHP)](https://openreceive.org/guides/quickstart-php.md)
- [Laravel Quickstart](https://openreceive.org/guides/quickstart-laravel.md)
- [BTCPay Server Quickstart](https://openreceive.org/guides/quickstart-btcpay.md)
- [WordPress + WooCommerce Quickstart](https://openreceive.org/guides/quickstart-woocommerce.md)
- [Easy Digital Downloads Quickstart](https://openreceive.org/guides/quickstart-edd.md)
- [Paymenter Quickstart](https://openreceive.org/guides/quickstart-paymenter.md)
- [Medusa Quickstart](https://openreceive.org/guides/quickstart-medusa.md)
- [Vendure Quickstart](https://openreceive.org/guides/quickstart-vendure.md)
- [FOSSBilling Quickstart](https://openreceive.org/guides/quickstart-fossbilling.md)
- [PrestaShop Quickstart](https://openreceive.org/guides/quickstart-prestashop.md)
- [Odoo Quickstart](https://openreceive.org/guides/quickstart-odoo.md)
- [Agent Directions: Node.js](https://openreceive.org/agent-directions/node/full.md): self-contained agent directions, quickstart included
- [Agent Directions: Fastify](https://openreceive.org/agent-directions/fastify/full.md): self-contained agent directions, quickstart included
- [Agent Directions: Next.js](https://openreceive.org/agent-directions/next/full.md): self-contained agent directions, quickstart included
- [Agent Directions: NestJS](https://openreceive.org/agent-directions/nestjs/full.md): self-contained agent directions, quickstart included
- [Agent Directions: FastAPI](https://openreceive.org/agent-directions/fastapi/full.md): self-contained agent directions, quickstart included
- [Agent Directions: Django](https://openreceive.org/agent-directions/django/full.md): self-contained agent directions, quickstart included
- [Agent Directions: Flask](https://openreceive.org/agent-directions/flask/full.md): self-contained agent directions, quickstart included
- [Agent Directions: Rails](https://openreceive.org/agent-directions/rails/full.md): self-contained agent directions, quickstart included
- [Agent Directions: PHP](https://openreceive.org/agent-directions/php/full.md): self-contained agent directions, quickstart included
- [Agent Directions: Laravel](https://openreceive.org/agent-directions/laravel/full.md): self-contained agent directions, quickstart included
- [Agent Directions: BTCPay Server](https://openreceive.org/agent-directions/btcpay/full.md): self-contained agent directions, quickstart included
- [Agent directions (WordPress + WooCommerce)](https://openreceive.org/agent-directions/woocommerce/full.md): self-contained agent directions, quickstart included
- [Agent directions (Easy Digital Downloads)](https://openreceive.org/agent-directions/edd/full.md): self-contained agent directions, quickstart included
- [Agent Directions: Lovable](https://openreceive.org/agent-directions/lovable/full.md): self-contained agent directions, quickstart included
- [Agent Directions: SvelteKit](https://openreceive.org/agent-directions/sveltekit/full.md): self-contained agent directions, quickstart included
- [Agent Directions: Nuxt](https://openreceive.org/agent-directions/nuxt/full.md): self-contained agent directions, quickstart included
- [Agent Directions: Astro](https://openreceive.org/agent-directions/astro/full.md): self-contained agent directions, quickstart included
- [Agent Directions: React Router](https://openreceive.org/agent-directions/react-router/full.md): self-contained agent directions, quickstart included
- [Agent Directions: TanStack Start](https://openreceive.org/agent-directions/tanstack-start/full.md): self-contained agent directions, quickstart included
- [Agent Directions: Mobile Apps](https://openreceive.org/agent-directions/mobile/full.md): self-contained agent directions, quickstart included
- [Agent Directions: Bolt](https://openreceive.org/agent-directions/bolt/full.md): self-contained agent directions, quickstart included
- [Agent directions (Paymenter)](https://openreceive.org/agent-directions/paymenter/full.md): self-contained agent directions, quickstart included
- [Agent directions (FOSSBilling)](https://openreceive.org/agent-directions/fossbilling/full.md): self-contained agent directions, quickstart included
- [Agent directions (PrestaShop)](https://openreceive.org/agent-directions/prestashop/full.md): self-contained agent directions, quickstart included
- [Agent directions (Odoo)](https://openreceive.org/agent-directions/odoo/full.md): self-contained agent directions, quickstart included
- [Agent directions (Medusa)](https://openreceive.org/agent-directions/medusa/full.md): self-contained agent directions, quickstart included
- [Agent directions (Vendure)](https://openreceive.org/agent-directions/vendure/full.md): self-contained agent directions, quickstart included

## Guides

The index is [/guides.md](https://openreceive.org/guides.md).

- [Bitcoin Checkout on Vercel and v0](https://openreceive.org/guides/vercel.md)
- [Bitcoin Checkout on Replit](https://openreceive.org/guides/replit.md)
- [Bitcoin Checkout on Lovable](https://openreceive.org/guides/lovable.md)
- [Bitcoin Checkout on Bolt](https://openreceive.org/guides/bolt.md)
- [Bitcoin Checkout with Supabase](https://openreceive.org/guides/supabase.md)
- [Supabase Migration](https://openreceive.org/guides/supabase-migration.md)
- [Bitcoin Checkout on Serverless Hosts](https://openreceive.org/guides/serverless.md)
- [Bitcoin Checkout in Mobile Apps](https://openreceive.org/guides/mobile-apps.md)
- [How We Test Platforms](https://openreceive.org/guides/how-we-test-platforms.md)
- [Odoo via BTCPay Server](https://openreceive.org/guides/odoo.md)
- [Magento via BTCPay Server](https://openreceive.org/guides/magento.md)
- [PrestaShop via BTCPay Server](https://openreceive.org/guides/prestashop.md)
- [BTCPay Plugin Reference](https://openreceive.org/guides/btcpay-reference.md)
- [Node ORM Recipes](https://openreceive.org/guides/node-orms.md)
- [Authorization](https://openreceive.org/guides/authorization.md)
- [Rate Limiting](https://openreceive.org/guides/rate-limiting.md)
- [Frontend Checkout](https://openreceive.org/guides/frontend-checkout.md)
- [Checkout UX](https://openreceive.org/guides/checkout-ux.md)
- [Headless Checkout](https://openreceive.org/guides/headless-checkout.md)
- [Automated Swaps](https://openreceive.org/guides/automated-swaps.md)
- [Swap Refunds](https://openreceive.org/guides/swap-refunds.md)
- [Lightning Swap Connect URI](https://openreceive.org/guides/lightning-swap-connect.md)
- [Environment Variables](https://openreceive.org/guides/environment-variables.md)
- [Payment Storage](https://openreceive.org/guides/storage.md)
- [Payment Safety Upgrade and Repair](https://openreceive.org/guides/payment-safety-upgrade.md)
- [Deploying OpenReceive](https://openreceive.org/guides/deploying.md)
- [Testing Your OpenReceive Integration](https://openreceive.org/guides/host-testing.md)
- [API Reference](https://openreceive.org/guides/api-reference.md)
- [Security](https://openreceive.org/guides/security.md)
- [Provider Registry](https://openreceive.org/guides/provider-registry.md)
- [Price Feeds](https://openreceive.org/guides/price-feeds.md)
- [React Material UI Recipe](https://openreceive.org/guides/react-material-ui-recipe.md)
- [TanStack Start Recipe](https://openreceive.org/guides/tanstack-start-recipe.md)
- [Supabase Edge Functions Recipe](https://openreceive.org/guides/supabase-edge-functions-recipe.md)
- [SvelteKit Recipe](https://openreceive.org/guides/sveltekit-recipe.md)
- [Nuxt Recipe](https://openreceive.org/guides/nuxt-recipe.md)
- [Astro Recipe](https://openreceive.org/guides/astro-recipe.md)
- [React Router Recipe](https://openreceive.org/guides/react-router-recipe.md)
- [Writing Your Own Checkout Route](https://openreceive.org/guides/custom-checkout-route.md)
- [WordPress Hosting Requirements](https://openreceive.org/guides/wordpress-hosting.md)

## Machine-readable specifications

- [OpenReceive HTTP OpenAPI](https://openreceive.org/openapi.yaml): the normative contract for every mounted route

## Agent resources

- [Using OpenReceive with coding agents](https://openreceive.org/agents.md): skills, install commands, and which artifact answers which question
- [Agent skills](https://github.com/OpenReceive/openreceive/tree/master/skills): integrate-openreceive and debug-openreceive-payment — `npx skills add OpenReceive/openreceive`, or Claude Code `/plugin marketplace add OpenReceive/openreceive`
- [Contributor rules](https://github.com/OpenReceive/openreceive/blob/master/AGENTS.md): the invariants for changes to OpenReceive itself
- [GitHub repository](https://github.com/OpenReceive/openreceive)