Revenue Share Monetization

Revenue sharing is a powerful monetization model where you charge customers a percentage of their revenue. Think of it as aligning your success with your customer’s success - you only make money when they do. In this guide, we’ll walk through setting up a revenue share model using a concrete example: an AI-powered prospect research agent called “ProspectAI Agent” that charges 5% of the revenue generated from prospects it helps find. Traditional revenue share models require complex integrations, manual calculations, and constant monitoring. Paygentic automates this entire process:

Automated Revenue Tracking: Securely connect to your customer’s Stripe account and automatically track their revenue
Percentage-Based Billing: Charge any percentage of revenue with automatic calculations
Manual Review Process: Review and approve revenue before billing to ensure accuracy

Create a Paygentic Merchant Account

Create Your Product

Navigate to your merchant dashboard and create a new product for your AI agent:

Product Name: ProspectAI Agent
Description: AI-powered prospect research that charges 5% of generated revenue

Set Up Your Billable Metric

Create a billable metric to track customer revenue:

Metric Name: revenue_usd
Unit: USD
Description: Total revenue in USD from Stripe

The unit must match the currency you’ll be tracking. For US dollars, use “USD”.

Configure Percentage Pricing

Create a postpaid plan with percentage-based pricing:

Create ProspectAI Revenue Share plan with 5% pricing

Plan Type: Select “Postpaid” (bills after usage occurs)
Plan Name: ProspectAI Revenue Share
Billing Period: Monthly
Price Type: Select “Percentage”
Percentage: 5%
Metric: Select your revenue_usd metric

Percentage pricing requires your billable metric unit to be a currency (USD, EUR, etc.). The system will automatically calculate the percentage of the revenue amount.

Connecting External Revenue Data with Sources

Sources are Paygentic’s way of automatically importing usage data from external systems. Instead of manually tracking and reporting every revenue event, sources connect directly to your customer’s platforms and pull in the data automatically.

What is a Source?

A source is an automated data pipeline that:

Connects to external platforms (like Stripe, AWS, or custom APIs)
Monitors for relevant events (invoices paid, resources consumed, API calls made)
Imports this data as “source events” for your review
Converts approved events into billable usage

For revenue sharing, the Stripe Revenue source is perfect because it:

Automatically detects when your customer’s Stripe invoices are paid
Captures the exact revenue amount in real-time
Allows you to review and approve which revenue to include
Calculates your percentage share automatically

Adding the Stripe Revenue Source

Configure Stripe Revenue Source

Navigate to the Sources tab in your plan and add a new Stripe Revenue source:

Configure with these settings:

Source Type: Stripe Revenue
Processing Mode: Manual (recommended for revenue share)
Name: Customer Stripe Revenue

Processing Modes Explained:

Manual Mode: Each invoice appears as a “pending” event that you review and approve. This gives you full control over what revenue is included in your percentage calculation.
Automatic Mode: All invoices are automatically processed without review. Best for trusted, long-term customers where you want fully hands-off billing.

The source will be available for customers to connect when they sign up through your authorization link.

Sources handle all the complex integration work for you. Paygentic manages webhook configuration, data synchronization, and error handling through our integration partner Ampersand, so you can focus on growing your business.

Generate Customer Authorization Links

Now that your product and source are configured, create unique signup links for your customers:

Generate Authorization Links

Navigate to your plan and generate unique signup links for customers:

Generate customer authorization link for ProspectAI

Each link is unique and allows a customer to:

Sign up with their payment information
Subscribe to your revenue share plan
Connect their Stripe account

You can share these links via:

Direct email to prospects
Embedded buttons in your application
Links on your landing page

Generate links programmatically

const response = await fetch('https://api.paygentic.io/v0/customers/authorization', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.PAYGENTIC_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    email: 'customer@example.com',
    redirectUrl: 'https://yourapp.com/welcome',
    planId: process.env.PAYGENTIC_PLAN_ID,
    merchantId: process.env.PAYGENTIC_MERCHANT_ID
  })
});

const { url } = await response.json();
// Send this URL to your customer

Find your Plan ID in the merchant dashboard under Product → Plans → Plan Details.

Always generate a unique authorization link for each individual customer. Reusing links can cause billing conflicts.

How the Stripe Revenue Integration Works

Understanding the data flow helps you explain the process to your customers and handle their questions:

View Integration Flow Diagram

The process works as follows:

Customer Authorization: Your customer signs up through the authorization link and provides their Stripe API key
Invoice Detection: When a Stripe invoice is paid, Paygentic receives the invoice data through Ampersand’s integration
Manual Review: You review pending invoice events in your merchant dashboard
Approval Process: You approve events that should be billed
Usage Creation: Approved events become usage events with the revenue amount
Automatic Calculation: Paygentic calculates 5% of the revenue and charges the customer

Paygentic handles all Stripe webhook configuration automatically through our integration partner Ampersand. Your customers only need to provide their Stripe API key.

Customer Onboarding: Getting Customers Connected

Your customers need to complete a simple setup process:

Customer Setup Process

Send your customer the authorization link. They’ll complete the signup and connect their Stripe account:

The customer will:

Enter their payment information
Subscribe to your revenue share plan
Access their customer dashboard
Navigate to Sources
Find the Stripe Revenue source
Enter their Stripe API key
Activate the source

Recommend customers use Stripe test mode first to verify the integration works correctly before using live API keys.

Monitor Customer Onboarding with Webhooks

Use webhooks to automatically track when customers successfully connect their Stripe accounts or encounter issues:Source Lifecycle Events:

source.activated.v0 - Customer successfully connected their Stripe account
source.activation_failed.v0 - Customer’s Stripe connection failed (invalid API key, etc.)
source.disconnected.v0 - Customer disconnected their Stripe account

// Monitor customer onboarding status
switch (payload.eventType) {
  case 'source.activated.v0':
    console.log(`✅ Customer ${payload.data.customerId} connected Stripe successfully`);
    // TODO: Send welcome email, enable features, update customer status
    break;
    
  case 'source.activation_failed.v0':
    console.log(`❌ Customer ${payload.data.customerId} failed to connect Stripe`);
    console.log(`Error: ${payload.data.error.message}`);
    // TODO: Send help documentation, trigger support outreach
    break;
    
  case 'source.disconnected.v0':
    console.log(`⚠️ Customer ${payload.data.customerId} disconnected Stripe`);
    // TODO: Pause billing, send re-connection reminder
    break;
}

These events help you automate customer success workflows and proactively address connection issues.

Processing Revenue Events

Once customers are connected, you’ll start receiving their Stripe invoice data. Here’s how to process it:

Dashboard Method

Review and Approve Revenue Events

Navigate to Sources → Stripe Revenue → Events in your merchant dashboard to process pending events:

The process includes:

Viewing pending invoice events with details (amount, customer, date)
Reviewing individual events for relevance
Approving events that should be billed
Checking Usage Events to confirm 5% revenue share calculation
Seeing the final billable usage created from approved events

Webhook Automation (Recommended)

For real-time processing and automation, use webhooks to get notified when revenue events need attention:

Set Up Webhooks

Enable webhooks in your Developer > Webhooks dashboard and subscribe to source event notifications:

source_event.pending.v0 - When new invoice events need review
source_event.processed.v0 - When events are approved and billed
source_event.failed.v0 - When event processing fails
source_event.rejected.v0 - When events are manually rejected

Webhooks let you build automated workflows for revenue processing instead of manually checking the dashboard.

Handle Source Event Notifications

import express from 'express';
import { Webhook } from 'svix';

const app = express();
const webhookSecret = process.env.PAYGENTIC_WEBHOOK_SECRET;

app.post('/webhooks/paygentic', 
  express.raw({ type: 'application/json' }),
  async (req, res) => {
    const headers = {
      'svix-id': req.headers['svix-id'],
      'svix-timestamp': req.headers['svix-timestamp'],
      'svix-signature': req.headers['svix-signature']
    };

    try {
      // Verify webhook signature
      const wh = new Webhook(webhookSecret);
      const payload = wh.verify(req.body, headers);
      
      // Respond immediately
      res.status(200).send('OK');
      
      // Handle events asynchronously
      switch (payload.eventType) {
        case 'source_event.pending.v0':
          // New revenue event needs review
          console.log('New invoice pending:', payload.data.externalEventId);
          // TODO: Auto-approve, send to review queue, notify team, etc.
          break;
          
        case 'source_event.processed.v0':
          // Revenue successfully processed and customer charged
          console.log('Invoice processed:', payload.data.externalEventId);
          // TODO: Update internal systems, notify customer, etc.
          break;
          
        case 'source_event.failed.v0':
          // Revenue processing failed
          console.log('Invoice failed:', payload.data.externalEventId);
          // TODO: Alert support team, retry logic, etc.
          break;
      }
    } catch (err) {
      console.error('Webhook verification failed:', err);
      return res.status(400).send('Invalid webhook');
    }
  }
);

See our Webhooks Documentation for complete setup instructions.

API Method

For direct integration or high-volume processing, use the API:

List pending events

// List pending source events
const response = await fetch(`https://api.paygentic.io/v0/sources/${sourceId}/events?status=pending`, {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${process.env.PAYGENTIC_API_KEY}`
  }
});

const { events } = await response.json();

events.forEach(event => {
  console.log(`Invoice: ${event.data.invoiceId}`);
  console.log(`Amount: $${event.data.amount / 100}`);
  console.log(`Customer: ${event.data.customerEmail}`);
});

Approve individual events

// Approve a single event
const approveResponse = await fetch(
  `https://api.paygentic.io/v0/sources/${sourceId}/events/${eventId}/approve`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.PAYGENTIC_API_KEY}`,
      'Content-Type': 'application/json'
    }
  }
);

if (approveResponse.ok) {
  console.log('✅ Event approved - 5% revenue share charged');
}

Bulk approve events

// Bulk approve multiple events
const bulkResponse = await fetch(
  `https://api.paygentic.io/v0/sources/${sourceId}/events/bulk-approve`,
  {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.PAYGENTIC_API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      eventIds: ['evt_123', 'evt_456', 'evt_789']
    })
  }
);

const { approved, failed } = await bulkResponse.json();
console.log(`Approved: ${approved.length}, Failed: ${failed.length}`);

The sourceId can be found in your merchant dashboard under Product → Plan → Sources → Source Details.

Testing Your Integration

Before going live, test your revenue share setup:

Create a test customer account using your authorization link
Use a Stripe test API key (starts with sk_test_)
Create test invoices in Stripe
Verify events appear in your dashboard
Approve an event and confirm the 5% calculation
Check that test payments process correctly

Advanced Integration Management

For production deployments, you may want to programmatically monitor your customers’ integration health and automate support workflows:

Source Installation Management → - Monitor integration status, diagnose issues, and build automation
Integration Health APIs → - Check which customers need attention
Troubleshooting Guide → - Resolve “revenue not tracking” issues

Most merchants use the UI for day-to-day management, but the APIs are powerful for customer success automation and support workflows.

Congratulations!

You’ve successfully set up automated revenue share billing! Your customers’ Stripe revenue is now tracked automatically, and you’ll earn 5% of their success. Need help? Contact support@paygentic.com.

Getting Started

Authentication

Platform

Legal

Revenue Share Monetization

Connecting External Revenue Data with Sources

What is a Source?

Adding the Stripe Revenue Source

Generate Customer Authorization Links

How the Stripe Revenue Integration Works

Customer Onboarding: Getting Customers Connected

Processing Revenue Events

Dashboard Method

Webhook Automation (Recommended)

API Method

Testing Your Integration

Advanced Integration Management

Congratulations!

Getting Started

Authentication

Platform

Legal

​Why Revenue Share with Paygentic?

​Merchant Setup: Creating Your Revenue Share Product

​Connecting External Revenue Data with Sources

​What is a Source?

​Adding the Stripe Revenue Source

​Generate Customer Authorization Links

​How the Stripe Revenue Integration Works

​Customer Onboarding: Getting Customers Connected

​Processing Revenue Events

​Dashboard Method

​Webhook Automation (Recommended)

​API Method

​Testing Your Integration

​Advanced Integration Management

​Congratulations!

Why Revenue Share with Paygentic?

Merchant Setup: Creating Your Revenue Share Product

Connecting External Revenue Data with Sources

What is a Source?

Adding the Stripe Revenue Source

Generate Customer Authorization Links

How the Stripe Revenue Integration Works

Customer Onboarding: Getting Customers Connected

Processing Revenue Events

Dashboard Method

Webhook Automation (Recommended)

API Method

Testing Your Integration

Advanced Integration Management

Congratulations!