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
    Overview
    Clover
    Basil
    Acacia
    Previous versions
Upgrade your API version
Upgrade your SDK version
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 States)
HomeDeveloper resourcesChangelogClover2025-10-29.clover

Adds support for custom payment methods

What’s new

You can now create custom Payment Methods and extend your payment integration to use payment methods that are processed outside of Stripe. For a list of payment method types that Stripe directly supports, see the payment method overview page.

Impact

You can now create custom Payment Methods in Stripe to represent payment methods processed by third-party payment processors. When you process custom payment method transactions outside of Stripe, you can record the transaction details to your Stripe account using a custom Payment Method and Payment Record.

To create a custom payment method type:

  1. Open the Custom payment methods page in your Dashboard.
  2. Click Create.
  3. Select an existing type to copy, or click Provide a custom name and icon.
  4. If you’re providing a custom name and icon, enter a display name and upload a logo icon.
  5. Read and agree to the terms, then click Create. In the list of types, note the ID of your custom payment method type, which starts with cpmt_. To create a payment method of your custom type, set its type to custom and its custom.type to the ID of your custom type.

Note

Custom payment methods are not compatible with Payment Intents or Setup Intents.

For more information about creating custom payment methods, see the Create Payment Methods API.

To use third-party payment processors with custom payment methods, see Integrate with third-party payment processors.

To use Payment Records with custom payment methods, report payment attempts with payment_method_details.

Changes

ParameterChangeResources or endpoints
customAdded
PaymentMethodPaymentMethod#create
ValuesChangeEnums
customAdded
ConfirmationToken.payment_method_previewPaymentMethod
customAdded
Customer#list_payment_methodsPaymentMethod#listPaymentMethod#create

Upgrade

  1. View your current API version in Workbench.
  2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
    • If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-10-29.clover
  3. Upgrade the API version used for webhook endpoints.
  4. Test your integration against the new version.
  5. If you use Connect, test your Connect integration.
  6. In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

Related changes

  • Adds MB WAY to payment method configurations
  • Adds TWINT payment method options to Checkout Sessions
  • Adds support for specifying payment method configurations to the customer portal
  • Adds MB WAY payment method to Payment Links and Checkout Sessions
  • Adds the ability to exclude payment methods when using Setup Intents
  • Adds Klarna reference parameters for line items in Payment Intents
  • Adds a subscription reference to Klarna line items in Payment Intents
Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc