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 changesraterunner 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: stripeenvironment: sandboxsynced_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