---
title: "Integrations"
description: "Third-party and protocol integrations for Ring Platform clones — payments, Web3 wallets, OAuth, push, email, API, MCP, and RingFileBase CDN storage"
locale: "en"
---
# Integrations

**Connect a Ring clone to the services your community already uses** — Ukrainian and global payment rails, EVM wallets, OAuth identity, Firebase push, business mailboxes, self-hosted media storage, and automation clients — through config-driven adapters documented here.

Ring does not hard-code vendor lock-in. Operators enable integrations via **`ring-config.json`**, **`.env.local`**, and documented service modules: **PaymentConductor** (WayForPay / Stripe / credits), **Wagmi v3** (WalletConnect and injected wallets), **Auth.js v5** (OAuth + magic links), **FCM** (web push), **Email AI-CRM** (IMAP/SMTP), **RingFileBase + Ring CDN** (`file()` storage), and **REST / Tunnel / MCP** for external apps. Start with [Environment configuration](/docs/deployment/environment.md), then open the guide for your integration class below.

  
- **[Environment configuration](/docs/deployment/environment.md)** — `DB_BACKEND_MODE`, PaymentConductor, FCM, OAuth, WalletConnect, Email AI-CRM blocks.

  
- **[Project configuration](/docs/configuration.md)** — Order Lab public vars, secrets, WalletConnect, wiki, and playbook.

  
- **[API integration patterns](/docs/examples/api-integration.md)** — Server Actions, same-origin REST, Tunnel realtime, and MCP automation paths.

  
- **[Payment gateway setup](/docs/customization/payment-integration.md)** — PaymentConductor operator guide — WayForPay, Stripe, internal credit ledger.

  
- **[Ring MCP tools](/docs/mcp.md)** — Per-clone Model Context Protocol gateway for Cursor and automation hosts.

## What belongs in this section

| Plane | Primary integration | Canonical doc |
|-------|---------------------|---------------|
| **Object storage** | `file()` → RingBaseAdapter | [RingFileBase](/docs/integrations/ring-filebase.md) |
| **Media CDN** | NGINX edge `/files/...` | [Ring CDN](/docs/integrations/ring-cdn.md) |
| **EVM wallets** | Wagmi v3 + viem connectors | [Ethereum wallets](/docs/integrations/ethereum-wallets.md) |
| **Card & membership checkout** | PaymentConductor → PSP webhooks | [Payment integration](/docs/customization/payment-integration.md) |
| **Ukrainian PSP deep dive** | WayForPay HMAC webhooks | [WayForPay integration](/docs/features/wayforpay-integration.md) |
| **Sign-in** | Auth.js OAuth + magic links | [Authentication](/docs/features/authentication.md) |
| **Web push** | Firebase Cloud Messaging | [Push notifications (FCM)](/docs/features/push-notifications-fcm.md) |
| **Live UI** | Tunnel broker (SSE / WS) | [Tunnel protocol](/docs/features/tunnel-protocol.md) |
| **Public inbox CRM** | IMAP poll + SMTP + Claude drafts | [Email AI-CRM](/docs/features/email-ai-crm.md) |
| **Headless clients** | REST + session cookie or MCP bearer | [API integration examples](/docs/examples/api-integration.md) |

## Integration catalog

### Pages in this section

Each card links to a dedicated reference page under `/docs/integrations/`.

  
- **[Ethereum wallets (Wagmi v3)](/docs/integrations/ethereum-wallets.md)** — Injected, MetaMask, Coinbase Wallet, WalletConnect — env vars and white-label connector lineup.

  
- **[WalletConnect Project ID](/docs/configuration/walletconnect.md)** — Reown Cloud signup → paste NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID on Secrets.

  
- **[RingFileBase (object storage API)](/docs/integrations/ring-filebase.md)** — `file()` → RingBaseAdapter → MinIO/RGW — provider SSOT, tokens, k8s wiring.

  
- **[Ring CDN (edge delivery)](/docs/integrations/ring-cdn.md)** — Public `cdn./files/...`, host→bucket map, multi-zone edges.

Additional first-party integration pages (Stripe operator checklist, OAuth provider matrix, ConnectPlatform bridge) will appear here as they are authored. Deep dives that already live under **Features**, **Customization**, or **Examples** are linked below until migrated.

### Storage & CDN

  
- **[RingFileBase](/docs/integrations/ring-filebase.md)** — Authenticated uploads for product images, KYC, chat, and generative media.

  
- **[Ring CDN](/docs/integrations/ring-cdn.md)** — Cacheable public reads in front of MinIO — pair with RingFileBase writes.

  
- **[Environment — storage block](/docs/deployment/environment.md)** — `NEXT_PUBLIC_STORAGE_PROVIDER`, `RINGBASE_*`, local vs Blob vs filebase.

  
- **[Backup & recovery](/docs/deployment/backup.md)** — Object buckets are a separate backup asset from Postgres.

### Payments & commerce

  
- **[Payment integration (operator)](/docs/customization/payment-integration.md)** — PaymentConductor purposes, webhook dispatcher, ledger idempotency.

  
- **[WayForPay integration](/docs/features/wayforpay-integration.md)** — Membership upgrades, HMAC verification, sandbox cards, revenue flows.

  
- **[PaymentConductor feature](/docs/features/payment-conductor.md)** — Rails overview — store, membership, news promotion, top-up.

  
- **[Payments feature](/docs/features/payments.md)** — User-facing checkout surfaces and credit balance UX.

  
- **[Web3 wallet feature](/docs/features/wallet.md)** — On-platform RING credits, top-up, and membership spend paths.

### Identity & access

  
- **[Authentication feature](/docs/features/authentication.md)** — Auth.js v5 providers, magic links, wallet sign-in, role gates.

  
- **[Authentication architecture](/docs/architecture/authentication.md)** — Proxy vs layout protection, OAuth callbacks, KYC upload flow.

  
- **[Web3 integration (redirect)](/docs/examples/web3-integration.md)** — Legacy ethers examples retired — pointer to Wagmi v3 guide.

### Notifications & realtime

  
- **[Push notifications (FCM)](/docs/features/push-notifications-fcm.md)** — Token registry, Server Action upsert, service worker, stale-token cleanup.

  
- **[Tunnel protocol](/docs/features/tunnel-protocol.md)** — SSE, WebSocket, long-poll transports — pair with FCM when tabs are closed.

  
- **[Notifications API](/docs/api/notifications.md)** — REST contract for inbox and FCM register routes.

### Email & CRM

  
- **[Email AI-CRM](/docs/features/email-ai-crm.md)** — IMAP ingest, AI drafts, admin approve/send, JSONB persistence.

  
- **[Email AI-CRM API](/docs/api/email-ai-crm.md)** — Admin routes, cron poll, inbound webhook contract.

### Developer & automation

  
- **[API integration examples](/docs/examples/api-integration.md)** — `fetch('/api/...')`, Tunnel hooks, curl smoke tests, error handling.

  
- **[API reference index](/docs/api.md)** — Full route catalog — entities, opportunities, messaging, wallet, admin.

  
- **[Ring MCP section](/docs/mcp.md)** — `ring-mcp` stdio server → `/api/mcp/v1/*` service-token gateway.

## Prerequisites

| Requirement | Notes |
|-------------|--------|
| Running Ring clone | `npm run dev` locally or k8s deploy |
| `ring-config.json` | Branding, membership amounts, feature flags |
| `.env.local` from template | Copy `env.local.template`; never commit secrets |
| Migrations applied | Payment ledger, FCM, Email CRM as needed per integration |
| PSP / OAuth dashboards | Callback URLs must match your clone hostname |

{`# 1. Environment validates
cp env.local.template .env.local
npm run dev

# 2. Tunnel diagnostics (realtime)
curl -s http://localhost:3000/api/tunnel/test

# 3. Docs library (this section)
open http://localhost:3000/docs/integrations`}

## Choosing an integration path

| Your goal | Start here |
|-----------|------------|
| Accept UAH card payments for membership | [WayForPay integration](/docs/features/wayforpay-integration.md) → [Payment integration](/docs/customization/payment-integration.md) |
| Add MetaMask / WalletConnect | [Ethereum wallets](/docs/integrations/ethereum-wallets.md) |
| Self-host product images / leave Vercel Blob | [RingFileBase](/docs/integrations/ring-filebase.md) → [Ring CDN](/docs/integrations/ring-cdn.md) |
| Enable Google or Apple sign-in | [Authentication](/docs/features/authentication.md) + OAuth block in [Environment](/docs/deployment/environment.md) |
| Mobile-style web push | [Push notifications (FCM)](/docs/features/push-notifications-fcm.md) |
| Live chat / unread badges without refresh | [Tunnel protocol](/docs/features/tunnel-protocol.md) |
| Automate from Cursor or CI | [Ring MCP tools](/docs/mcp.md) |
| Build a mobile app on Ring APIs | [API integration examples](/docs/examples/api-integration.md) |

## Related

  
- **[Token economics](/docs/customization/token-economics.md)** — RING utility token, refcodes, and on-chain referral rails.

  
- **[Web3 documentation hub](/docs/web3.md)** — Jurisdiction awareness and launch operator patterns.

  
- **[Doc system (MDX components)](/docs/features/doc-system.md)** — `Cards`, `Callout`, `Mermaid`, and Ring doc widgets used on these pages.