Payment Method Configurations
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 parent
that 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.
Note: The ability to turn off cards is in limited preview. Please contact us if you require this functionality.
Related guides:
The Payment Method Configuration object
Attributes
- idstringretrievable with publishable key
Unique identifier for the object.
- objectstring
String representing the object’s type. Objects of the same type share the same value.
- activeboolean
Whether the configuration can be used for new payments.
- applicationnullable string
For child configs, the Connect application associated with the configuration.
- is_
defaultboolean The default configuration is used whenever a payment method configuration is not specified.
- namestring
The configuration’s name.
- parentnullable string
For child configs, the configuration’s parent configuration.
More attributes
- acss_
debitnullable object - affirmnullable object
- afterpay_
clearpaynullable object - alipaynullable object
- amazon_
paynullable object - apple_
paynullable object - au_
becs_ debitnullable object - bacs_
debitnullable object - bancontactnullable object
- bliknullable object
- boletonullable object
- cardnullable object
- cartes_
bancairesnullable object - cashappnullable object
- customer_
balancenullable object - epsnullable object
- fpxnullable object
- giropaynullable object
- google_
paynullable object - grabpaynullable object
- idealnullable object
- jcbnullable object
- klarnanullable object
- konbininullable object
- linknullable object
- livemodeboolean
- mobilepaynullable objectPreview feature
- oxxonullable object
- p24nullable object
- paynownullable object
- paypalnullable object
- promptpaynullable object
- revolut_
paynullable object - sepa_
debitnullable object - sofortnullable object
- swishnullable object
- us_
bank_ accountnullable object - wechat_
paynullable object - zipnullable object
Create a payment method configuration
Creates a payment method configuration
Parameters
- namestring
Configuration name.
- parentstring
Configuration’s parent configuration. Specify to create a child configuration.
More parameters
- acss_
debitobject - affirmobject
- afterpay_
clearpayobject - alipayobject
- amazon_
payobject - apple_
payobject - apple_
pay_ laterobject - au_
becs_ debitobject - bacs_
debitobject - bancontactobject
- blikobject
- boletoobject
- cardobject
- cartes_
bancairesobject - cashappobject
- customer_
balanceobject - epsobject
- fpxobject
- giropayobject
- google_
payobject - grabpayobject
- idealobject
- jcbobject
- klarnaobject
- konbiniobject
- linkobject
- mobilepayobjectPreview feature
- oxxoobject
- p24object
- paynowobject
- paypalobject
- promptpayobject
- revolut_
payobject - sepa_
debitobject - sofortobject
- swishobject
- us_
bank_ accountobject - wechat_
payobject - zipobject
Returns
Returns the payment method configuration object
Update payment method configuration
Update payment method configuration
Parameters
- activeboolean
Whether the configuration can be used for new payments.
- namestring
Configuration name.
More parameters
- acss_
debitobject - affirmobject
- afterpay_
clearpayobject - alipayobject
- amazon_
payobject - apple_
payobject - apple_
pay_ laterobject - au_
becs_ debitobject - bacs_
debitobject - bancontactobject
- blikobject
- boletoobject
- cardobject
- cartes_
bancairesobject - cashappobject
- customer_
balanceobject - epsobject
- fpxobject
- giropayobject
- google_
payobject - grabpayobject
- idealobject
- jcbobject
- klarnaobject
- konbiniobject
- linkobject
- mobilepayobjectPreview feature
- oxxoobject
- p24object
- paynowobject
- paypalobject
- promptpayobject
- revolut_
payobject - sepa_
debitobject - sofortobject
- swishobject
- us_
bank_ accountobject - wechat_
payobject - zipobject
Returns
An object with the updated account payment method configuration
Retrieve payment method configuration
Retrieve payment method configuration
Parameters
No parameters.
Returns
A payment method configuration object.