Atmosphere Money SDKs
Official beta packages for app servers, test fixtures, and agent-assisted ATM integrations. Use this page as the package index; the implementation guides stay in the developer docs.
Keep ATM packages server-side. Browser checkout embeds will be a separate package when embedded ATM checkout is ready.
Official Packages
@atmosphere-money/app-node
Server-side SDK for ATM app integrations: checkout, payment status, webhook verification, XRPC receiver helpers, service-auth constants, and Tickets calls.
npm install @atmosphere-money/app-node@beta- Start ATM hosted checkout from a trusted backend.
- Verify signed ATM webhooks and XRPC receiver events.
- Create ticket holds, free ticket claims, and ticket app flows.
@atmosphere-money/testing
Test fixtures and assertions for local ATM integrations, including event payloads, webhook signatures, replay checks, and ticket events.
npm install -D @atmosphere-money/testing@beta- Generate payment, subscription, product, and ticket event fixtures.
- Sign local webhook payloads with the same header shape ATM sends.
- Test idempotency and replay handling before going live.
@atmosphere-money/mcp
Local, test-mode MCP tools for coding agents that are wiring an ATM app integration from docs, SDKs, and test fixtures.
npm install -D @atmosphere-money/mcp@beta- Inspect app developer config in test mode.
- Generate fixtures and test webhook deliveries.
- Review delivery logs and redrive test events.
Choose A Starting Point
Building an app integration
@atmosphere-money/app-node: Use this from your backend to create checkout, verify callbacks, and call ATM Tickets.
Testing local fulfillment
@atmosphere-money/testing: Use signed fixtures to test webhook handlers, XRPC receiver handlers, and idempotency.
Working with an agent
@atmosphere-money/mcp: Use local test-mode tools for config inspection, fixtures, test events, and delivery logs.
Recommended Path
- Register your app. Start in App onboarding and configure test-mode webhooks or an XRPC receiver.
- Install the server SDK. Use App Node SDK examples from your trusted backend.
- Create checkout. Redirect buyers to hosted ATM checkout and fulfill only after a verified event.
- Test locally. Use Testing package fixtures and the webhook test console.
- Go live. Review Launch checklist, environment config, idempotency, and delivery logs.