# SatsRail Developers

> REST API reference and integration guides for SatsRail — non-custodial Bitcoin payment infrastructure, on-chain or Lightning.

- The API is served from `https://app.satsrail.com`. Merchant endpoints are under `/api/v1/m/` and take a secret key (`sk_live_…`, or `sk_test_…` in test mode); public endpoints are under `/api/v1/pub/` and take a publishable key.
- The hosted MCP server for AI agents is `https://app.satsrail.com/api/v1/mcp`.
- The OpenAPI spec is at https://www.satsrail.com/developers/data/satsrail-openapi.json.
- Every page is also Markdown: at the page's URL plus `index.md`, or at the page's own URL when the request says `Accept: text/markdown`.
- Every page in one file: https://www.satsrail.com/developers/llms-full.txt
- For the product itself, see https://www.satsrail.com/llms.txt.

## Docs

- [API Reference](https://www.satsrail.com/developers/index.md): SatsRail REST API documentation. Non-custodial Bitcoin payment infrastructure, on-chain or Lightning.
- [AI Agents](https://www.satsrail.com/developers/guides/ai-agents/index.md): Let AI agents accept Bitcoin payments programmatically. MCP server, zero-browser payment flow, and agent-friendly API for Claude, Cursor, and any LLM tool.
- [Checkout Experience](https://www.satsrail.com/developers/guides/checkout-experience/index.md): Visual guide to the SatsRail checkout flow. See what your customers experience in both embedded and new tab modes — from customer info collection through payment confirmation.
- [Checkout Flow](https://www.satsrail.com/developers/guides/checkout-flow/index.md): Understand the complete data flow from checkout session creation through payment confirmation. Table relationships, status transitions, and every database write explained.
- [Embed Button](https://www.satsrail.com/developers/guides/embed/index.md): Add a Bitcoin pay button to any website with one script tag. No backend needed. Works on WordPress, Shopify, and static sites.
- [AI Agent Payment Flow](https://www.satsrail.com/developers/guides/flows/ai-agent/index.md): Complete sequence diagram for AI agent payments via the SatsRail MCP server. Agent-initiated invoicing, programmatic payment creation, and agent-to-agent Bitcoin transactions.
- [API Checkout Flow](https://www.satsrail.com/developers/guides/flows/api-checkout/index.md): Complete sequence diagram for the SatsRail REST API checkout integration. Server-to-server checkout creation, hosted payment page, Lightning settlement, and webhook delivery.
- [Embed Widget Payment Flow](https://www.satsrail.com/developers/guides/flows/embed-widget/index.md): Complete sequence diagram showing how the SatsRail embed widget (pay.js) loads, renders, creates checkout sessions, and processes Lightning payments — from script tag to settlement.
- [Payment Link Flow](https://www.satsrail.com/developers/guides/flows/payment-link/index.md): Complete sequence diagram for the no-code Payment Link flow. Merchant creates a product, shares a link, and customers pay via Lightning — no coding required.
- [Integrate Your POS](https://www.satsrail.com/developers/guides/pos/index.md): Accept Lightning payments in your existing Android, desktop, or web POS. Request an invoice, display a QR code, and confirm payment while keeping orders in your own system.
- [Quickstart Guide](https://www.satsrail.com/developers/guides/quickstart/index.md): Go from zero to accepting Bitcoin payments in under 10 minutes. Step-by-step guide with code examples for Node.js, Python, and Ruby.
- [Testing](https://www.satsrail.com/developers/guides/testing/index.md): Learn how to use SatsRail's test mode to build and test your integration without real payments. Fully isolated test environment with simulated Lightning invoices.