Unique identifier for the object.
String representing the object's type. Objects of the same type share the same value.
Optionalacss_Whether the configuration can be used for new payments.
OptionalaffirmOptionalafterpay_OptionalalipayOptionalalmaOptionalamazon_Optionalapple_For child configs, the Connect application associated with the configuration.
Optionalau_Optionalbacs_OptionalbancontactOptionalbillieOptionalblikOptionalboletoOptionalcardOptionalcartes_OptionalcashappOptionalcryptoOptionalcustomer_OptionalepsOptionalfpxOptionalgiropayOptionalgoogle_OptionalgrabpayOptionalidealThe default configuration is used whenever a payment method configuration is not specified.
OptionaljcbOptionalkakao_OptionalklarnaOptionalkonbiniOptionalkr_OptionallinkHas the value true if the object exists in live mode or the value false if the object exists in test mode.
Optionalmb_OptionalmobilepayOptionalmultibancoThe configuration's name.
Optionalnaver_Optionalnz_OptionaloxxoOptionalp24For child configs, the configuration's parent configuration.
Optionalpay_OptionalpaycoOptionalpaynowOptionalpaypalOptionalpaytoOptionalpixOptionalpromptpayOptionalrevolut_Optionalsamsung_OptionalsatispayOptionalsepa_OptionalsofortOptionalswishOptionaltwintOptionalus_Optionalwechat_Optionalzip
PaymentMethodConfigurations control which payment methods are displayed to your customers when you don't explicitly specify payment method types. You can have multiple configurations with different sets of payment methods for different scenarios.
There are two types of PaymentMethodConfigurations. Which is used depends on the charge type:
Direct configurations apply to payments created on your account, including Connect destination charges, Connect separate charges and transfers, and payments not involving Connect.
Child configurations apply to payments created on your connected accounts using direct charges, and charges with the on_behalf_of parameter.
Child configurations have a
parentthat sets default values and controls which settings connected accounts may override. You can specify a parent ID at payment time, and Stripe will automatically resolve the connected account's associated child configuration. Parent configurations are managed in the dashboard and are not available in this API.Related guides: