# Bridge Payments Documentation

> Universal payment backend for Pubflow - Accept payments with Stripe, PayPal, Authorize.net, and more

## Quick Navigation

### Getting Started
- What is Bridge Payments?: ./introduction.html
- Getting Started Guide: ./getting-started.html
- Core Concepts: ./core-concepts.html
- Architecture Overview: ./architecture.html

### Configuration
- Environment Variables: ./configuration/environment.html
- Module Hub & extensions: ./configuration/module-hub.html
- Pubflow Integration: ./configuration/pubflow.html
- Payment Providers Setup: ./configuration/providers.html
- Database Configuration: ./configuration/database.html

### API Reference
- Authentication: ./api/authentication.html
- Memberships API: ./api/memberships.html
- Public products listing: ./api/products-listing.html
- Payments API: ./api/payments.html
- Payment Methods API: ./api/payment-methods.html
- Customers API: ./api/customers.html
- Addresses API: ./api/addresses.html
- Subscriptions API: ./api/subscriptions.html
- Organizations API: ./api/organizations.html
- Webhooks API: ./api/webhooks.html

### Payment Providers
- Stripe Integration: ./providers/stripe.html
- PayPal Integration: ./providers/paypal.html
- Authorize.net Integration: ./providers/authorize-net.html

### Integration Examples (Production-Ready)
- React Native Integration: ./clients/react-native.html
- Next.js Integration: ./clients/nextjs.html
- React Integration: ./clients/react.html
- Community Libraries: ./clients/community.html

### Guides
- Guest Checkout: ./guides/guest-checkout.html
- Saved Payment Methods: ./guides/saved-payment-methods.html
- Subscriptions: ./guides/subscriptions.html
- Organizations: ./guides/organizations.html
- External Webhooks: ./guides/external-webhooks.html
- Performance Optimization: ./guides/performance-optimization.html
- Testing: ./guides/testing.html

## Key Features

### Universal Payment System
Bridge Payments is an extensible, universal payment system with a unified API:

**Currently Supported:**
- Stripe (Credit cards, Apple Pay, Google Pay, 3D Secure)
- PayPal (PayPal accounts, Venmo, credit cards)
- Authorize.net (Credit cards, eChecks)

**Available on Request:**
- Square, Braintree, Adyen, Razorpay, Mercado Pago, 2Checkout, Klarna, Mollie, Checkout.com, Worldpay, and more

**Request a Provider:**
- Request Center: https://www.pubflow.com/requests
- Email: support@pubflow.com
- Learn more: /providers/request-new.html

### Multi-Provider Support
Unified API works across all payment providers:
- Stripe: Credit cards, Apple Pay, Google Pay, 3D Secure
- PayPal: PayPal accounts, Venmo, credit cards
- Authorize.net: Credit cards and bank accounts

### Security & Compliance
- PCI compliant with token-based payments
- Automatic session validation with Flowless
- Client secret auto-cleanup after 24 hours
- Rate limiting and request validation

### Flexible Customer Management
- Authenticated users (Flowless integration)
- Guest checkout (no account required)
- Organization/multi-tenant support with role-based access control

### Subscription Management
- Recurring billing with automatic retries
- Trial periods and flexible intervals
- Cancel at period end or immediately

### Webhook System
- Provider webhooks (Stripe, PayPal events)
- External webhooks (Discord, Slack, custom endpoints)
- Signature validation and retry logic

## Quick Start

1. Create instance at pubflow.com
2. Configure payment provider (Stripe, PayPal, or Authorize.net)
3. Connect to Flowless for authentication
4. Start accepting payments via REST API (no client libraries needed)

## Technology Stack

- Runtime: Bun (high-performance JavaScript runtime)
- Framework: Hono (lightweight web framework)
- Database: Kysely ORM (PostgreSQL, MySQL, SQLite, LibSQL, Neon, PlanetScale)
- Validation: Zod (TypeScript-first schema validation)
- Caching: optional Redis (`REDIS_URL`) with in-memory LRU fallback
- Payment SDKs: Stripe, PayPal, Authorize.net

## API Base URL

```
https://your-instance.pubflow.com/bridge-payment
```

## Authentication Methods

1. X-Session-ID header (recommended)
2. Authorization Bearer token
3. session_id query parameter
4. token query parameter (guest access, GET only)
5. guest_data in request body (guest checkout)

## Common Use Cases

- E-commerce: Product purchases with guest checkout
- SaaS: Subscription billing with automatic renewals
- Donations: One-time and recurring donations
- Memberships: Membership subscriptions with access control

## Support & Resources

- Full Documentation: /llms-full.txt
- Pubflow Platform: https://pubflow.com
- Pubflow org (GitHub): https://github.com/pubflow

## Note on File Extensions

This documentation is built with VitePress, which automatically converts .txt files to .html in the browser.
All links use .html extension for proper navigation.

---

For complete API reference, code examples, and detailed guides, see /llms-full.txt