sale-tracking

name	sale-tracking
description	Track sales and revenue for affiliate commission attribution via Sale API or Stripe metadata. Triggers on "track sales", "payment tracking", "commission tracking".
license	MIT
metadata	{"author":"affitor","version":"1.0.0","organization":"Affitor"}

Sale Tracking

Record revenue after a customer pays so commissions are attributed to the correct affiliate partner.

Option A: Sale API (any payment provider)

POST https://api.affitor.com/api/v1/track/sale
Authorization: Bearer YOUR_PROGRAM_API_KEY
Content-Type: application/json

{
  "transaction_id": "txn_unique_id",
  "customer_key": "user_123",
  "amount_cents": 4900,
  "currency": "USD"
}

Required fields

Field	Type	Description
transaction_id	string	Unique per sale (duplicate = 409)
amount_cents	number	Positive integer in cents
customer_key or click_id	string	At least one required for attribution

Node.js example

await fetch('https://api.affitor.com/api/v1/track/sale', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.AFFITOR_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    transaction_id: order.id,
    customer_key: currentUser.id,
    click_id: req.cookies.affitor_click_id,
    amount_cents: order.totalCents,
    currency: 'USD',
  }),
});

Option B: Stripe Metadata

Add these fields to Stripe Checkout session metadata:

const session = await stripe.checkout.sessions.create({
  line_items: [{ price: 'price_xxx', quantity: 1 }],
  mode: 'payment',
  success_url: 'https://yoursite.com/success',
  cancel_url: 'https://yoursite.com/cancel',
  metadata: {
    affitor_click_id: clickId,
    affitor_customer_key: currentUser.id,
    program_id: 'YOUR_PROGRAM_ID',
  },
});

For subscriptions

Duplicate metadata in both locations:

const session = await stripe.checkout.sessions.create({
  mode: 'subscription',
  metadata: {
    affitor_click_id: clickId,
    affitor_customer_key: currentUser.id,
    program_id: 'YOUR_PROGRAM_ID',
  },
  subscription_data: {
    metadata: {
      affitor_click_id: clickId,
      affitor_customer_key: currentUser.id,
      program_id: 'YOUR_PROGRAM_ID',
    },
  },
});

Without subscription_data.metadata, renewal attribution will fail.

Option C: Stripe Auto-Setup via CLI

npx affitor setup stripe

This auto-configures all Stripe webhooks via OAuth. No manual metadata needed for payment events.

Test

npx affitor test sale