Integrations

Raterunner syncs your billing configuration to payment providers, creating and managing products, prices, and promotions.

Payment Providers

Note: Currently only Stripe is supported. Contact raterunner@akorchak.software for other provider needs.

How Syncing Works

1. Read — Raterunner reads your billing.yaml configuration
2. Diff — Compares with the current state in your payment provider
3. Plan — Generates a list of changes to apply
4. Apply — Creates, updates, or archives resources

# Preview changes (dry run)
raterunner apply --env sandbox --dry-run raterunner/billing.yaml

# Apply changes
raterunner apply --env sandbox raterunner/billing.yaml

Provider ID Files

After syncing, Raterunner creates provider ID files that map your configuration to provider-specific IDs:

# stripe_sandbox.yaml (auto-generated)
provider: stripe
environment: sandbox
synced_at: "2026-01-28T10:30:00Z"

plans:
  pro:
    product_id: prod_ABC123
    prices:
      monthly: price_XYZ789
      yearly: price_UVW012

These files are:

• Auto-generated — don't edit manually
• Environment-specific — separate files for sandbox/production
• Committed to Git — for tracking and debugging

Environment Management

Sync to different environments using separate API keys:

# Sandbox (test mode)
export STRIPE_SANDBOX_KEY=sk_test_...
raterunner apply --env sandbox raterunner/billing.yaml

# Production (live mode)
export STRIPE_PRODUCTION_KEY=sk_live_...
raterunner apply --env production raterunner/billing.yaml

Authentication

Each provider requires API credentials:

Store these securely and never commit them to version control.

What Gets Synced

Next Steps

• Stripe Integration — Detailed Stripe setup guide