Stripe integration

Documentation Index

Fetch the complete documentation index at: https://docs.partnero.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

​

Features

• Automatic transaction tracking - All Stripe payments create transactions
• Subscription support - Track recurring payments for ongoing commissions
• Refund handling - Commissions are reversed on refunds
• Customer syncing - Stripe customers are synced to Partnero

​

Setup

​

Step 1: Connect Stripe

1. Go to Program Settings → Integrations
2. Click Connect Stripe
3. Authorize Partnero to access your Stripe account

​

Step 2: Configure Webhook

1. In Stripe Dashboard, go to Developers → Webhooks
2. Verify a webhook exists for https://api.partnero.com/v1/integrations/stripe/{your_program_id}/webhook
3. Ensure these events are enabled:
   • checkout.session.completed
   • invoice.paid
   • charge.refunded
   • customer.subscription.created
   • customer.subscription.updated
   • customer.subscription.deleted

​

Step 3: Map Products (Optional)

1. Go to Program Settings → Commissions
2. Click Add Product Rule
3. Select Stripe products and set commission rates

​

How It Works

​

Payment Tracking

​

Customer Attribution

1. Referral Cookie - Customer clicked a partner’s referral link
2. Coupon Code - Customer used a partner’s coupon at checkout
3. Metadata - partner_key passed in Stripe metadata

​

Passing Partner Attribution

const session = await stripe.checkout.sessions.create({
  line_items: [{ price: 'price_xxx', quantity: 1 }],
  mode: 'subscription',
  success_url: 'https://yoursite.com/success',
  cancel_url: 'https://yoursite.com/cancel',
  metadata: {
    partnero_partner: 'PARTNER_CODE' // Pass the partner code
  }
});

// Get referral info from Partnero
const referralInfo = po('getReferralInfo');

// Include in checkout
const session = await stripe.checkout.sessions.create({
  // ... other options
  metadata: {
    partnero_partner: referralInfo.partner_key
  }
});

​

Subscription Handling

​

New Subscriptions

• Transaction created for initial payment
• Commission calculated and attributed
• Recurring flag set for future payments

​

Recurring Payments

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

​

Subscription Changes

• Upgrades - Additional commission on increased amount
• Downgrades - Commission adjusted accordingly
• Cancellations - Future commissions stop

​

Refunds & Disputes

​

Automatic Refund Handling

1. Partnero receives the refund webhook
2. Original transaction is marked as refunded
3. Commission is reversed/cancelled
4. Partner balance is adjusted

​

Partial Refunds

Original: $100 → $20 commission
Refund: $50 (50%)
Adjusted Commission: $10

​

Stripe Checkout Integration

​

Using Stripe Checkout

// Track the checkout initiation
po('trackCheckoutStarted', {
  customer_email: customerEmail
});

// Then redirect to Stripe Checkout
window.location.href = checkoutSessionUrl;

​

Passing Referral Data

async function createCheckout() {
  // Get referral info
  const ref = po('getReferralInfo');
  
  // Call your backend
  const response = await fetch('/create-checkout', {
    method: 'POST',
    body: JSON.stringify({
      priceId: 'price_xxx',
      partnerKey: ref?.partner_key,
      couponCode: ref?.coupon_code
    })
  });
  
  // Redirect to checkout
  const { url } = await response.json();
  window.location.href = url;
}

​

Testing

​

Test Mode

1. Toggle to Test Mode in Stripe Dashboard
2. Connect Stripe in test mode from Partnero
3. Use Stripe test cards to simulate payments

​

Test Cards

​

Troubleshooting

​

Next Steps