Welcome to Reflio Docs

Step 1: Create Account

Sign up at reflio.app/signup and create your first project.

Step 2: Get Your API Keys

Go to Dashboard → Integration to find:

• Public Key (pk_...) - For widget and frontend
• Secret Key (sk_...) - For backend API calls

Step 3: Create a Campaign

In Dashboard → Campaigns, click "Create New Campaign" and configure:

• Who gets rewarded: Both, Referrer only, or Referred only
• Reward types: Cash, Credit, or Discount
• Trigger event: Signup, First Payment, or Subscription

Step 4: Connect Stripe (Optional)

Go to Dashboard → Integration → Connect Stripe to enable automatic reward payouts.

Step 1: Add Referral Code Field

Add an optional referral code input to your checkout/signup form:

<label for="referral-code">Have a referral code?</label>
<input 
  type="text" 
  id="referral-code" 
  placeholder="Enter code"
/>

Step 2: Validate Code (Frontend)

const validateCode = async (code, email) => {
  const res = await fetch('https://www.reflio.app/api/referrals/validate', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      api_secret: 'YOUR_SECRET_KEY', // Call from backend!
      referral_code: code,
      referred_email: email
    })
  });
  
  const data = await res.json();
  return data.valid; // true/false
};

Step 3: Track Referral (Backend)

After successful payment, call this from your backend:

const trackReferral = async () => {
  await fetch('https://www.reflio.app/api/referrals/track', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      api_secret: process.env.REFLIO_SECRET_KEY,
      referral_code: 'ABC12345',
      referred_email: 'newuser@example.com',
      referred_external_user_id: 'user_123',
      stripe_customer_id: 'cus_xxx', // Optional
      stripe_payment_intent_id: 'pi_xxx', // Optional
      purchase_amount: 99.99,
      currency: 'USD'
    })
  });
};

GET /api/widget/code

Get or create a referral code for a user.

POST /api/referrals/validate

Check if a referral code is valid.

POST /api/referrals/track

Record a new referral.

Events We Listen For:

• checkout.session.completed
• payment_intent.succeeded
• invoice.payment_succeeded
• customer.subscription.created
• charge.refunded (marks as cancelled)

Setup Instructions:

1. Go to Stripe Dashboard → Developers → Webhooks
2. Add endpoint: https://www.reflio.app/api/webhooks/stripe
3. Select the events listed above
4. Copy the signing secret (whsec_...)
5. Add to your environment variables: STRIPE_WEBHOOK_SECRET