Payment Gateway Integration

Overview

Gauzy supports integrating payment gateways for:

• Online invoice payments
• Subscription billing
• Payment link generation

Supported Gateways

Stripe Setup

1. Create Stripe Account

1. Go to stripe.com
2. Get your API keys from Dashboard → Developers

2. Configure

STRIPE_API_KEY=sk_live_...
STRIPE_SECRET_KEY=sk_live_...
STRIPE_WEBHOOK_SECRET=whsec_...

3. Webhook Events

Configure Stripe webhooks to receive payment notifications:

https://api.example.com/api/payment/webhook/stripe

Events to subscribe:

• payment_intent.succeeded
• payment_intent.payment_failed
• invoice.paid

PayPal Setup

PAYPAL_CLIENT_ID=your-client-id
PAYPAL_CLIENT_SECRET=your-secret
PAYPAL_MODE=sandbox  # or 'live'

Payment Flow

Diagram source

sequenceDiagram
    Client->>Gauzy API: Request payment link
    Gauzy API->>Stripe: Create PaymentIntent
    Stripe-->>Gauzy API: Client secret
    Gauzy API-->>Client: Payment page URL
    Client->>Stripe: Enter card details
    Stripe->>Gauzy API: Webhook: payment_succeeded
    Gauzy API->>Database: Update invoice status

Related Pages

• Invoice Endpoints — invoice API
• Payment Endpoints — payment API
• Invoicing Feature — invoicing