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:
- Open the Custom payment methods page in your Dashboard.
- Click Create .
- Select an existing type to copy, or click Provide a custom name and icon .
- If you’re providing a custom name and icon, enter a display name and upload a logo icon.
- 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
| Parameter | Change | Resources or endpoints |
|---|---|---|
| custom | Added | PaymentMethod PaymentMethod#create |
| Values | Change | Enums |
| custom | Added | ConfirmationToken. payment_method_preview PaymentMethod |
| custom | Added | Customer#list_payment_methods PaymentMethod#list PaymentMethod#create |
Upgrade
- View your current API version in Workbench.
- 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
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- 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 the related setting 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