Skip to content
Sign in
An image of the Stripe logo
Create account
Sign in
Overview
Multiparty payments
Testing

Migrate to the Payment Method Configurations API
Beta

Learn how to migrate from the Payment Method Settings API to the newly named Payment Method Configuration API. The Configuration API has the same functionality as the Settings API with a new namespace and JSON response structure.

Note

This feature is in beta. For early access, contact us.

We have replaced the Payment Method Settings API with the Payment Method Configuration API. This change is mostly a change in naming and response structure, but the functionality remains the same. If your existing integration uses the Payment Method Settings API to manage the payment methods of your connected accounts, follow the steps below to maintain the same functionality with the Configuration API.

Change API Call Endpoint

The API endpoint has been updated (refer to the Integration Guide) and is now /v1/payment_method_configurations. When making a request for a specific account, instead of specifying the connected account’s ID in the endpoint, use the Stripe-Account header to specify it.

Changes to the response format

We have updated the display_preference field in the API. Now you should access the value with the same behavior as the original display_preference using display_preference.value. See payment method configurations for details.

Was this page helpful?
Need help? Contact Support.
Watch our developer tutorials.
Check out our product changelog.
Questions? Contact Sales.
Powered by Markdoc
On this page
Change API Call Endpoint
Changes to the response format
Stripe Shell
Test mode

Welcome to the Stripe Shell!

Stripe Shell is a browser-based shell with the Stripe CLI pre-installed. Login to your
Stripe account and press Control + Backtick on your keyboard to start managing your Stripe
resources in test mode.

- View supported Stripe commands: 
- Find webhook events: 
- Listen for webhook events: 
- Call Stripe APIs: stripe [api resource] [operation] (e.g. )
The Stripe Shell is best experienced on desktop.
$