Chargebee integration

​

Overview

​

Features

• Subscription tracking - Full subscription lifecycle support
• Recurring commissions - Automatic commission on renewals
• Invoice tracking - Track all invoice payments
• Refund handling - Automatic commission adjustments

​

Setup

​

Step 1: Get API Credentials

1. Log in to your Chargebee dashboard
2. Go to Settings → Configure Chargebee → API Keys
3. Create a Full Access API key (or Read Only for tracking only)

​

Step 2: Configure in Partnero

1. Go to Program Settings → Integrations
2. Select Chargebee
3. Enter your Site name and API key

​

Step 3: Set Up Webhook

1. Go to Settings → Configure Chargebee → Webhooks
2. Add webhook URL: https://api.partnero.com/v1/integrations/chargebee/{your_program_id}/webhook
3. Select events:
   • Invoice Created
   • Invoice Updated
   • Payment Succeeded
   • Payment Refunded
   • Subscription Created
   • Subscription Renewed
   • Subscription Cancelled

​

Step 4: Configure Webhook Security

1. Copy your webhook username and password from Chargebee
2. Enter credentials in Partnero integration settings

​

How It Works

​

Payment Flow

​

Customer Attribution

1. Customer ID matching - Chargebee customer ID synced to Partnero
2. Email matching - Customer email used for attribution
3. Metadata - Partner info in Chargebee metadata

​

Passing Partner Data

// When creating a subscription
chargebee.subscription.create({
  plan_id: "pro-plan",
  customer: {
    email: "[email protected]",
    cf_partnero_partner: "PARTNER_CODE" // Custom field
  }
});

chargebee.openCheckout({
  hostedPage: function() {
    return $.ajax({
      url: "/api/create-checkout",
      type: "POST",
      data: {
        plan_id: "pro-plan",
        partner_code: "PARTNER_CODE"
      }
    });
  }
});

​

Subscription Lifecycle

​

New Subscriptions

• First invoice payment creates transaction
• Commission calculated for partner
• Subscription linked for future tracking

​

Renewals

• New transaction created automatically
• Commission calculated (if recurring enabled)
• Partner continues earning

​

Upgrades/Downgrades

• Prorated amounts handled correctly
• Commission adjusted based on new amount

​

Cancellations

• Future renewals stop
• No new commissions generated
• Historical data preserved

​

Refund Handling

1. Credit note or refund issued in Chargebee
2. Webhook notification sent
3. Transaction marked as refunded
4. Commission reversed

​

Custom Fields

1. Go to Settings → Configure Chargebee → Custom Fields
2. Add field cf_partnero_partner to Customer
3. Pass partner code when creating customers

​

Testing

​

Test Site

1. Create test site in Chargebee
2. Configure webhook for test site
3. Use test card numbers

​

Test Cards

​

Troubleshooting

​

Next Steps