Core Resources
Payment Methods
Products
Checkout
Payment Links
Billing
Capital
Connect
Fraud
Issuing
Terminal
Treasury
Entitlements
Sigma
Reporting
Financial Connections
Tax
Identity
Crypto
Climate
Forwarding
Privacy
Webhooks

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.

Related guides:

Endpoints

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 associative array

  • affirmnullable associative array

  • afterpay_clearpaynullable associative array

  • alipaynullable associative array

  • almanullable associative array

  • amazon_paynullable associative array

  • apple_paynullable associative array

  • au_becs_debitnullable associative array

  • bacs_debitnullable associative array

  • bancontactnullable associative array

  • billienullable associative array

  • bliknullable associative array

  • boletonullable associative array

  • cardnullable associative array

  • cartes_bancairesnullable associative array

  • cashappnullable associative array

  • customer_balancenullable associative array

  • epsnullable associative array

  • fpxnullable associative array

  • giropaynullable associative array

  • google_paynullable associative array

  • grabpaynullable associative array

  • idealnullable associative array

  • jcbnullable associative array

  • kakao_paynullable associative array

  • klarnanullable associative array

  • konbininullable associative array

  • kr_cardnullable associative array

  • linknullable associative array

  • livemodeboolean

  • mobilepaynullable associative array

  • multibanconullable associative array

  • naver_paynullable associative array

  • nz_bank_accountnullable associative array

  • oxxonullable associative array

  • p24nullable associative array

  • pay_by_banknullable associative array

  • payconullable associative array

  • paynownullable associative array

  • paypalnullable associative array

  • pixnullable associative array

  • promptpaynullable associative array

  • revolut_paynullable associative array

  • samsung_paynullable associative array

  • satispaynullable associative array

  • sepa_debitnullable associative array

  • sofortnullable associative array

  • swishnullable associative array

  • twintnullable associative array

  • us_bank_accountnullable associative array

  • wechat_paynullable associative array

  • zipnullable associative array

The Payment Method Configuration object
{
  "id": "pmc_abcdef",
  "object": "payment_method_configuration",
  "acss_debit": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "active": true,
  "affirm": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "afterpay_clearpay": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "alipay": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "apple_pay": {
    "available": true,
    "display_preference": {
      "overridable": null,
      "preference": "on",
      "value": "on"
    }
  },
  "bancontact": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "card": {
    "available": true,
    "display_preference": {
      "overridable": null,
      "preference": "on",
      "value": "on"
    }
  },
  "cartes_bancaires": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "eps": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "giropay": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "google_pay": {
    "available": true,
    "display_preference": {
      "overridable": null,
      "preference": "on",
      "value": "on"
    }
  },
  "ideal": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "is_default": true,
  "klarna": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "link": {
    "available": true,
    "display_preference": {
      "overridable": null,
      "preference": "on",
      "value": "on"
    }
  },
  "livemode": false,
  "name": "Default",
  "p24": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "sepa_debit": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "sofort": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "us_bank_account": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "wechat_pay": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  }
}

Create a payment method configuration 

Creates a payment method configuration

Parameters

  • namestringRequired unless parent is provided

    Configuration name.

  • parentstringRequired unless name is provided

    Configuration’s parent configuration. Specify to create a child configuration.

More parameters

  • acss_debitassociative array

  • affirmassociative array

  • afterpay_clearpayassociative array

  • alipayassociative array

  • almaassociative array

  • amazon_payassociative array

  • apple_payassociative array

  • apple_pay_laterassociative array

  • au_becs_debitassociative array

  • bacs_debitassociative array

  • bancontactassociative array

  • billieassociative array

  • blikassociative array

  • boletoassociative array

  • cardassociative array

  • cartes_bancairesassociative array

  • cashappassociative array

  • customer_balanceassociative array

  • epsassociative array

  • fpxassociative array

  • giropayassociative array

  • google_payassociative array

  • grabpayassociative array

  • idealassociative array

  • jcbassociative array

  • kakao_payassociative array

  • klarnaassociative array

  • konbiniassociative array

  • kr_cardassociative array

  • linkassociative array

  • mobilepayassociative array

  • multibancoassociative array

  • naver_payassociative array

  • nz_bank_accountassociative array

  • oxxoassociative array

  • p24associative array

  • pay_by_bankassociative array

  • paycoassociative array

  • paynowassociative array

  • paypalassociative array

  • pixassociative array

  • promptpayassociative array

  • revolut_payassociative array

  • samsung_payassociative array

  • satispayassociative array

  • sepa_debitassociative array

  • sofortassociative array

  • swishassociative array

  • twintassociative array

  • us_bank_accountassociative array

  • wechat_payassociative array

  • zipassociative array

Returns

Returns the payment method configuration object

POST /v1/payment_method_configurations
$stripe = new \Stripe\StripeClient('sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2');
$paymentMethodConfiguration = $stripe->paymentMethodConfigurations->create([
  'name' => 'Buy Now Pay Laters',
]);
Response
{
  "id": "pmc_abcdef",
  "object": "payment_method_configuration",
  "acss_debit": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "active": true,
  "affirm": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "afterpay_clearpay": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "alipay": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "apple_pay": {
    "available": true,
    "display_preference": {
      "overridable": null,
      "preference": "on",
      "value": "on"
    }
  },
  "bancontact": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "card": {
    "available": true,
    "display_preference": {
      "overridable": null,
      "preference": "on",
      "value": "on"
    }
  },
  "cartes_bancaires": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "eps": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "giropay": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "google_pay": {
    "available": true,
    "display_preference": {
      "overridable": null,
      "preference": "on",
      "value": "on"
    }
  },
  "ideal": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "is_default": true,
  "klarna": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "link": {
    "available": true,
    "display_preference": {
      "overridable": null,
      "preference": "on",
      "value": "on"
    }
  },
  "livemode": false,
  "name": "Default",
  "p24": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "sepa_debit": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "sofort": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "us_bank_account": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "wechat_pay": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  }
}

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_debitassociative array

  • affirmassociative array

  • afterpay_clearpayassociative array

  • alipayassociative array

  • almaassociative array

  • amazon_payassociative array

  • apple_payassociative array

  • apple_pay_laterassociative array

  • au_becs_debitassociative array

  • bacs_debitassociative array

  • bancontactassociative array

  • billieassociative array

  • blikassociative array

  • boletoassociative array

  • cardassociative array

  • cartes_bancairesassociative array

  • cashappassociative array

  • customer_balanceassociative array

  • epsassociative array

  • fpxassociative array

  • giropayassociative array

  • google_payassociative array

  • grabpayassociative array

  • idealassociative array

  • jcbassociative array

  • kakao_payassociative array

  • klarnaassociative array

  • konbiniassociative array

  • kr_cardassociative array

  • linkassociative array

  • mobilepayassociative array

  • multibancoassociative array

  • naver_payassociative array

  • nz_bank_accountassociative array

  • oxxoassociative array

  • p24associative array

  • pay_by_bankassociative array

  • paycoassociative array

  • paynowassociative array

  • paypalassociative array

  • pixassociative array

  • promptpayassociative array

  • revolut_payassociative array

  • samsung_payassociative array

  • satispayassociative array

  • sepa_debitassociative array

  • sofortassociative array

  • swishassociative array

  • twintassociative array

  • us_bank_accountassociative array

  • wechat_payassociative array

  • zipassociative array

Returns

An object with the updated account payment method configuration

POST /v1/payment_method_configurations/:id
$stripe = new \Stripe\StripeClient('sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2');
$paymentMethodConfiguration = $stripe->paymentMethodConfigurations->update(
  'pmc_abcdef',
  ['acss_debit' => ['display_preference' => ['preference' => 'on']]]
);
Response
{
  "id": "pmc_abcdef",
  "object": "payment_method_configuration",
  "acss_debit": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "active": true,
  "affirm": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "afterpay_clearpay": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "alipay": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "apple_pay": {
    "available": true,
    "display_preference": {
      "overridable": null,
      "preference": "on",
      "value": "on"
    }
  },
  "bancontact": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "card": {
    "available": true,
    "display_preference": {
      "overridable": null,
      "preference": "on",
      "value": "on"
    }
  },
  "cartes_bancaires": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "eps": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "giropay": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "google_pay": {
    "available": true,
    "display_preference": {
      "overridable": null,
      "preference": "on",
      "value": "on"
    }
  },
  "ideal": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "is_default": true,
  "klarna": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "link": {
    "available": true,
    "display_preference": {
      "overridable": null,
      "preference": "on",
      "value": "on"
    }
  },
  "livemode": false,
  "name": "Default",
  "p24": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "sepa_debit": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "sofort": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "us_bank_account": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "wechat_pay": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  }
}

Retrieve payment method configuration 

Retrieve payment method configuration

Parameters

No parameters.

Returns

A payment method configuration object.

GET /v1/payment_method_configurations/:id
$stripe = new \Stripe\StripeClient('sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2');
$paymentMethodConfiguration = $stripe->paymentMethodConfigurations->retrieve(
  'pmc_abcdef',
  []
);
Response
{
  "id": "pmc_abcdef",
  "object": "payment_method_configuration",
  "acss_debit": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "active": true,
  "affirm": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "afterpay_clearpay": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "alipay": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "apple_pay": {
    "available": true,
    "display_preference": {
      "overridable": null,
      "preference": "on",
      "value": "on"
    }
  },
  "bancontact": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "card": {
    "available": true,
    "display_preference": {
      "overridable": null,
      "preference": "on",
      "value": "on"
    }
  },
  "cartes_bancaires": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "eps": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "giropay": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "google_pay": {
    "available": true,
    "display_preference": {
      "overridable": null,
      "preference": "on",
      "value": "on"
    }
  },
  "ideal": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "is_default": true,
  "klarna": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "link": {
    "available": true,
    "display_preference": {
      "overridable": null,
      "preference": "on",
      "value": "on"
    }
  },
  "livemode": false,
  "name": "Default",
  "p24": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "sepa_debit": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "sofort": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "us_bank_account": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  },
  "wechat_pay": {
    "available": false,
    "display_preference": {
      "overridable": null,
      "preference": "off",
      "value": "off"
    }
  }
}
Was this page helpful?
YesNo