Stripe API Migrate Subscriptions

Error Response Format

{
  "error": {
    "type": "invalid_request_error",
    "message": "Source account not found",
    "code": "account_not_found",
    "param": "source_account",
    "request_id": "req_1234567890"
  }
}

Common Error Codes

Idempotency

curl -X POST https://api.submigrations.com/v1/migrations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: unique-key-123" \
  -d source_account="acct_source" \
  -d destination_account="acct_destination"

Webhook Configuration

// Configure webhook endpoint
POST /v1/webhook_endpoints
{
  "url": "https://your-app.com/webhooks/submigrations",
  "enabled_events": [
    "migration.started",
    "migration.progress",
    "migration.completed",
    "migration.failed"
  ]
}

Event Types

Webhook Security

// Verify webhook signature
const crypto = require('crypto');

function verifyWebhookSignature(payload, signature, secret) {
  const expectedSignature = crypto
    .createHmac('sha256', secret)
    .update(payload, 'utf8')
    .digest('hex');
  
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expectedSignature)
  );
}

Node.js Full Migration Example

const Submigrations = require('@submigrations/node');
const client = new Submigrations(process.env.SUBMIGRATIONS_API_KEY);

async function migrateStripeAccounts() {
  try {
    // Create migration
    const migration = await client.migrations.create({
      source_account: 'acct_source',
      destination_account: 'acct_destination',
      resources: {
        products: true,
        prices: true,
        customers: true,
        subscriptions: true,
        coupons: true
      },
      options: {
        preserve_billing_cycles: true,
        test_mode: true // Run in test mode first
      }
    });
    
    console.log(`Migration started: ${migration.id}`);
    
    // Poll for status
    let status = migration.status;
    while (status === 'pending' || status === 'in_progress') {
      await new Promise(resolve => setTimeout(resolve, 5000));
      
      const update = await client.migrations.retrieve(migration.id);
      status = update.status;
      
      console.log(`Progress: ${update.progress.percentage}%`);
    }
    
    if (status === 'completed') {
      console.log('Migration completed successfully!');
      
      // Download detailed report
      const report = await client.migrations.downloadReport(migration.id);
      await fs.writeFileSync('migration-report.json', report);
    } else {
      console.error('Migration failed:', migration.error);
    }
    
  } catch (error) {
    console.error('Error:', error.message);
  }
}

migrateStripeAccounts();

Python Batched Migration

import submigrations
import time

client = submigrations.Client(api_key=os.environ['SUBMIGRATIONS_API_KEY'])

def migrate_in_batches(source, destination, batch_size=100):
    """Migrate subscriptions in batches for large accounts"""
    
    # Get total count
    subscriptions = client.analyze_account(source)
    total = subscriptions['counts']['subscriptions']
    
    # Process in batches
    for offset in range(0, total, batch_size):
        migration = client.migrations.create(
            source_account=source,
            destination_account=destination,
            resources={
                'subscriptions': {
                    'limit': batch_size,
                    'offset': offset
                }
            }
        )
        
        # Wait for batch completion
        while migration.status in ['pending', 'in_progress']:
            time.sleep(5)
            migration = client.migrations.retrieve(migration.id)
        
        if migration.status == 'failed':
            raise Exception(f"Batch failed: {migration.error}")
        
        print(f"Completed batch {offset}-{offset+batch_size}")
    
    print("All batches completed successfully")

# Run migration
migrate_in_batches('acct_source', 'acct_destination')

CLI Usage

# Install CLI
npm install -g @submigrations/cli

# Configure authentication
submigrations auth login

# Run migration with progress bar
submigrations migrate \
  --source acct_source \
  --destination acct_destination \
  --resources all \
  --preserve-billing-cycles \
  --output migration-report.json

# Check status of running migration
submigrations status mig_1234567890

# List recent migrations
submigrations list --limit 10