Back to skills
extension
Category: Development & EngineeringNo API key required

stripe-api-versioning-and-upgrades

Upgrading Stripe API versions, SDKs, Stripe.js, and mobile SDKs. Covers versioning rules and upgrade checklist.

personAuthor: jakexiaohubgithub

Stripe API Versioning & Upgrades

Latest API version: 2026-01-28.clover. Default to latest unless user specifies otherwise.

API Versioning Basics

  • Date-based versions (e.g., 2026-01-28.clover, 2025-08-27.basil).
  • Backward-compatible: New resources/params, webhook types (no code changes).
  • Breaking: Field renames/removals, behavior changes (review changelog).

Server-Side SDKs

  • Dynamic languages (Node.js/Python/Ruby/PHP): Set apiVersion globally or per-request.
    const stripe = require('stripe')(key, { apiVersion: '2026-01-28.clover' });