Skip to content
Create account or Sign in
The Stripe Docs logo
/
Ask AI
Create accountSign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
APIs & SDKsHelp
Overview
Versioning
Changelog
Upgrade your API version
Upgrade your SDK version
    Versioning and support policy
    Set an API version
    Stripe.js versioning
    Mobile SDK versioning
Essentials
SDKs
API
Testing
Stripe CLI
Sample projects
Tools
Stripe Dashboard
Workbench
Developers Dashboard
Stripe Shell
Stripe for Visual Studio Code
Features
Workflows
Event Destinations
Stripe health alertsFile uploads
AI solutions
Agent toolkit
Model Context ProtocolBuild agentic AI SaaS Billing workflows
Security and privacy
Security
Stripebot web crawler
Privacy
Extend Stripe
Build Stripe apps
Use apps from Stripe
Partners
Partner ecosystem
Partner certification
United States
English (United Kingdom)
HomeDeveloper resourcesUpgrade your SDK version

Mobile SDK versioning and support policy

Learn about the Mobile SDK versioning and support policy.

This page describes Stripe’s mobile SDK versioning policy, compatibility with Stripe API versions, and how to update to newer SDK versions.

The iOS SDK is open source and fully documented.

Stripe’s iOS SDK follows semantic versioning (semver). This means that version numbers are structured as MAJOR.MINOR.PATCH, where:

  • MAJOR version increments indicate incompatible API changes
  • MINOR version increments add functionality in a backwards-compatible manner
  • PATCH version increments include backwards-compatible bug fixes

We recommend staying up to date with the latest SDK versions to take advantage of new features, improvements, and bug fixes.

Migration guides and changelog

  • Migration guides - Detailed guides for upgrading between major versions
  • Changelog: Complete history of changes across all versions

Support policy

New features and bug fixes are released on the latest major version of the SDK. If you’re on an older major version, we recommend upgrading to the latest major version to take advantage of these features and bug fixes. Older major versions of the SDK continue to be available for use, but won’t receive any additional updates.

Compatibility with Stripe API versions on your backend

Unless specifically noted in an SDK API, the mobile SDKs is compatible with any Stripe API version you use on your backend.

See also

  • Stripe versioning and support policy
  • Stripe.js versioning and support policy
Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc