Payment method configurations allow you to configure which payment methods are available to your customers during checkout. Manage payment method availability across multiple Connect accounts.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/stripe-payment-method-configurations-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Stripe Accounts Account Payment Method Configurations API
description: This is an object representing a Stripe account. You can retrieve it to see properties on the account like its current requirements or if the account is enabled to make live charges or receive payouts.
contact:
email: dev-platform@stripe.com
name: Stripe Dev Platform Team
url: https://stripe.com
termsOfService: https://stripe.com/us/terms/
version: '2023-10-16'
x-stripeSpecFilename: spec3
servers:
- url: https://api.stripe.com/
security:
- basicAuth: []
- bearerAuth: []
tags:
- name: Payment Method Configurations
paths:
/v1/payment_method_configurations:
get:
description: <p>List payment method configurations</p>
operationId: GetPaymentMethodConfigurations
parameters:
- description: The Connect application to filter by.
explode: true
in: query
name: application
required: false
schema:
anyOf:
- maxLength: 100
type: string
- enum:
- ''
type: string
style: deepObject
- description: Specifies which fields in the response should be expanded.
explode: true
in: query
name: expand
required: false
schema:
items:
maxLength: 5000
type: string
type: array
style: deepObject
requestBody:
content:
application/x-www-form-urlencoded:
encoding: {}
schema:
additionalProperties: false
$ref: '#/components/schemas/GetPaymentMethodConfigurationsRequest'
required: false
responses:
'200':
content:
application/json:
schema:
description: ''
x-expandableFields:
- data
$ref: '#/components/schemas/PaymentMethodConfigResourcePaymentMethodConfigurationsList'
description: Successful response.
default:
content:
application/json:
schema:
$ref: '#/components/schemas/error'
description: Error response.
tags:
- Payment Method Configurations
post:
description: <p>Creates a payment method configuration</p>
operationId: PostPaymentMethodConfigurations
requestBody:
content:
application/x-www-form-urlencoded:
encoding:
acss_debit:
explode: true
style: deepObject
affirm:
explode: true
style: deepObject
afterpay_clearpay:
explode: true
style: deepObject
alipay:
explode: true
style: deepObject
apple_pay:
explode: true
style: deepObject
apple_pay_later:
explode: true
style: deepObject
au_becs_debit:
explode: true
style: deepObject
bacs_debit:
explode: true
style: deepObject
bancontact:
explode: true
style: deepObject
blik:
explode: true
style: deepObject
boleto:
explode: true
style: deepObject
card:
explode: true
style: deepObject
cartes_bancaires:
explode: true
style: deepObject
cashapp:
explode: true
style: deepObject
eps:
explode: true
style: deepObject
expand:
explode: true
style: deepObject
fpx:
explode: true
style: deepObject
giropay:
explode: true
style: deepObject
google_pay:
explode: true
style: deepObject
grabpay:
explode: true
style: deepObject
ideal:
explode: true
style: deepObject
jcb:
explode: true
style: deepObject
klarna:
explode: true
style: deepObject
konbini:
explode: true
style: deepObject
link:
explode: true
style: deepObject
oxxo:
explode: true
style: deepObject
p24:
explode: true
style: deepObject
paynow:
explode: true
style: deepObject
paypal:
explode: true
style: deepObject
promptpay:
explode: true
style: deepObject
revolut_pay:
explode: true
style: deepObject
sepa_debit:
explode: true
style: deepObject
sofort:
explode: true
style: deepObject
us_bank_account:
explode: true
style: deepObject
wechat_pay:
explode: true
style: deepObject
schema:
additionalProperties: false
$ref: '#/components/schemas/PostPaymentMethodConfigurationsRequest'
required: false
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/payment_method_configuration'
description: Successful response.
default:
content:
application/json:
schema:
$ref: '#/components/schemas/error'
description: Error response.
tags:
- Payment Method Configurations
/v1/payment_method_configurations/{configuration}:
get:
description: <p>Retrieve payment method configuration</p>
operationId: GetPaymentMethodConfigurationsConfiguration
parameters:
- in: path
name: configuration
required: true
schema:
maxLength: 5000
type: string
style: simple
- description: Specifies which fields in the response should be expanded.
explode: true
in: query
name: expand
required: false
schema:
items:
maxLength: 5000
type: string
type: array
style: deepObject
requestBody:
content:
application/x-www-form-urlencoded:
encoding: {}
schema:
additionalProperties: false
$ref: '#/components/schemas/GetPaymentMethodConfigurationsConfigurationRequest'
required: false
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/payment_method_configuration'
description: Successful response.
default:
content:
application/json:
schema:
$ref: '#/components/schemas/error'
description: Error response.
tags:
- Payment Method Configurations
post:
description: <p>Update payment method configuration</p>
operationId: PostPaymentMethodConfigurationsConfiguration
parameters:
- in: path
name: configuration
required: true
schema:
maxLength: 5000
type: string
style: simple
requestBody:
content:
application/x-www-form-urlencoded:
encoding:
acss_debit:
explode: true
style: deepObject
affirm:
explode: true
style: deepObject
afterpay_clearpay:
explode: true
style: deepObject
alipay:
explode: true
style: deepObject
apple_pay:
explode: true
style: deepObject
apple_pay_later:
explode: true
style: deepObject
au_becs_debit:
explode: true
style: deepObject
bacs_debit:
explode: true
style: deepObject
bancontact:
explode: true
style: deepObject
blik:
explode: true
style: deepObject
boleto:
explode: true
style: deepObject
card:
explode: true
style: deepObject
cartes_bancaires:
explode: true
style: deepObject
cashapp:
explode: true
style: deepObject
eps:
explode: true
style: deepObject
expand:
explode: true
style: deepObject
fpx:
explode: true
style: deepObject
giropay:
explode: true
style: deepObject
google_pay:
explode: true
style: deepObject
grabpay:
explode: true
style: deepObject
ideal:
explode: true
style: deepObject
jcb:
explode: true
style: deepObject
klarna:
explode: true
style: deepObject
konbini:
explode: true
style: deepObject
link:
explode: true
style: deepObject
oxxo:
explode: true
style: deepObject
p24:
explode: true
style: deepObject
paynow:
explode: true
style: deepObject
paypal:
explode: true
style: deepObject
promptpay:
explode: true
style: deepObject
revolut_pay:
explode: true
style: deepObject
sepa_debit:
explode: true
style: deepObject
sofort:
explode: true
style: deepObject
us_bank_account:
explode: true
style: deepObject
wechat_pay:
explode: true
style: deepObject
schema:
additionalProperties: false
$ref: '#/components/schemas/PostPaymentMethodConfigurationsConfigurationRequest'
required: false
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/payment_method_configuration'
description: Successful response.
default:
content:
application/json:
schema:
$ref: '#/components/schemas/error'
description: Error response.
tags:
- Payment Method Configurations
components:
schemas:
GetPaymentMethodConfigurationsConfigurationRequest:
type: object
properties: {}
error:
description: An error response from the Stripe API
properties:
error:
$ref: '#/components/schemas/api_errors'
required:
- error
type: object
GetPaymentMethodConfigurationsRequest:
type: object
properties: {}
PaymentMethodConfigResourcePaymentMethodConfigurationsList:
type: object
required:
- data
- has_more
- object
- url
properties:
data:
items:
$ref: '#/components/schemas/payment_method_configuration'
type: array
has_more:
description: True if this list has another page of items after this one that can be fetched.
type: boolean
object:
description: String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
enum:
- list
type: string
url:
description: The URL where this list can be accessed.
maxLength: 5000
type: string
PostPaymentMethodConfigurationsRequest:
type: object
properties:
acss_debit:
description: Canadian pre-authorized debit payments, check this [page](https://stripe.com/docs/payments/acss-debit) for more details like country availability.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
affirm:
description: '[Affirm](https://www.affirm.com/) gives your customers a way to split purchases over a series of payments. Depending on the purchase, they can pay with four interest-free payments (Split Pay) or pay over a longer term (Installments), which might include interest. Check this [page](https://stripe.com/docs/payments/affirm) for more details like country availability.'
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
afterpay_clearpay:
description: Afterpay gives your customers a way to pay for purchases in installments, check this [page](https://stripe.com/docs/payments/afterpay-clearpay) for more details like country availability. Afterpay is particularly popular among businesses selling fashion, beauty, and sports products.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
alipay:
description: Alipay is a digital wallet in China that has more than a billion active users worldwide. Alipay users can pay on the web or on a mobile device using login credentials or their Alipay app. Alipay has a low dispute rate and reduces fraud by authenticating payments using the customer's login credentials. Check this [page](https://stripe.com/docs/payments/alipay) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
apple_pay:
description: Stripe users can accept [Apple Pay](/payments/apple-pay) in iOS applications in iOS 9 and later, and on the web in Safari starting with iOS 10 or macOS Sierra. There are no additional fees to process Apple Pay payments, and the [pricing](/pricing) is the same as other card transactions. Check this [page](https://stripe.com/docs/apple-pay) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
apple_pay_later:
description: Apple Pay Later, a payment method for customers to buy now and pay later, gives your customers a way to split purchases into four installments across six weeks.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
au_becs_debit:
description: Stripe users in Australia can accept Bulk Electronic Clearing System (BECS) direct debit payments from customers with an Australian bank account. Check this [page](https://stripe.com/docs/payments/au-becs-debit) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
bacs_debit:
description: Stripe users in the UK can accept Bacs Direct Debit payments from customers with a UK bank account, check this [page](https://stripe.com/docs/payments/payment-methods/bacs-debit) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
bancontact:
description: Bancontact is the most popular online payment method in Belgium, with over 15 million cards in circulation. [Customers](https://stripe.com/docs/api/customers) use a Bancontact card or mobile app linked to a Belgian bank account to make online payments that are secure, guaranteed, and confirmed immediately. Check this [page](https://stripe.com/docs/payments/bancontact) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
blik:
description: BLIK is a [single use](https://stripe.com/docs/payments/payment-methods#usage) payment method that requires customers to authenticate their payments. When customers want to pay online using BLIK, they request a six-digit code from their banking application and enter it into the payment collection form. Check this [page](https://stripe.com/docs/payments/blik) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
boleto:
description: Boleto is an official (regulated by the Central Bank of Brazil) payment method in Brazil. Check this [page](https://stripe.com/docs/payments/boleto) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
card:
description: Cards are a popular way for consumers and businesses to pay online or in person. Stripe supports global and local card networks.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
cartes_bancaires:
description: Cartes Bancaires is France's local card network. More than 95% of these cards are co-branded with either Visa or Mastercard, meaning you can process these cards over either Cartes Bancaires or the Visa or Mastercard networks. Check this [page](https://stripe.com/docs/payments/cartes-bancaires) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
cashapp:
description: Cash App is a popular consumer app in the US that allows customers to bank, invest, send, and receive money using their digital wallet. Check this [page](https://stripe.com/docs/payments/cash-app-pay) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
eps:
description: EPS is an Austria-based payment method that allows customers to complete transactions online using their bank credentials. EPS is supported by all Austrian banks and is accepted by over 80% of Austrian online retailers. Check this [page](https://stripe.com/docs/payments/eps) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
expand:
description: Specifies which fields in the response should be expanded.
items:
maxLength: 5000
type: string
type: array
fpx:
description: Financial Process Exchange (FPX) is a Malaysia-based payment method that allows customers to complete transactions online using their bank credentials. Bank Negara Malaysia (BNM), the Central Bank of Malaysia, and eleven other major Malaysian financial institutions are members of the PayNet Group, which owns and operates FPX. It is one of the most popular online payment methods in Malaysia, with nearly 90 million transactions in 2018 according to BNM. Check this [page](https://stripe.com/docs/payments/fpx) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
giropay:
description: giropay is a German payment method based on online banking, introduced in 2006. It allows customers to complete transactions online using their online banking environment, with funds debited from their bank account. Depending on their bank, customers confirm payments on giropay using a second factor of authentication or a PIN. giropay accounts for 10% of online checkouts in Germany. Check this [page](https://stripe.com/docs/payments/giropay) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
google_pay:
description: Google Pay allows customers to make payments in your app or website using any credit or debit card saved to their Google Account, including those from Google Play, YouTube, Chrome, or an Android device. Use the Google Pay API to request any credit or debit card stored in your customer's Google account. Check this [page](https://stripe.com/docs/google-pay) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
grabpay:
description: GrabPay is a payment method developed by [Grab](https://www.grab.com/sg/consumer/finance/pay/). GrabPay is a digital wallet - customers maintain a balance in their wallets that they pay out with. Check this [page](https://stripe.com/docs/payments/grabpay) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
ideal:
description: iDEAL is a Netherlands-based payment method that allows customers to complete transactions online using their bank credentials. All major Dutch banks are members of Currence, the scheme that operates iDEAL, making it the most popular online payment method in the Netherlands with a share of online transactions close to 55%. Check this [page](https://stripe.com/docs/payments/ideal) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
jcb:
description: JCB is a credit card company based in Japan. JCB is currently available in Japan to businesses approved by JCB, and available to all businesses in Australia, Canada, Hong Kong, Japan, New Zealand, Singapore, Switzerland, United Kingdom, United States, and all countries in the European Economic Area except Iceland. Check this [page](https://support.stripe.com/questions/accepting-japan-credit-bureau-%28jcb%29-payments) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
klarna:
description: Klarna gives customers a range of [payment options](https://stripe.com/docs/payments/klarna#payment-options) during checkout. Available payment options vary depending on the customer's billing address and the transaction amount. These payment options make it convenient for customers to purchase items in all price ranges. Check this [page](https://stripe.com/docs/payments/klarna) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
konbini:
description: Konbini allows customers in Japan to pay for bills and online purchases at convenience stores with cash. Check this [page](https://stripe.com/docs/payments/konbini) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
link:
description: '[Link](https://stripe.com/docs/payments/link) is a payment method network. With Link, users save their payment details once, then reuse that information to pay with one click for any business on the network.'
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
name:
description: Configuration name.
maxLength: 100
type: string
oxxo:
description: OXXO is a Mexican chain of convenience stores with thousands of locations across Latin America and represents nearly 20% of online transactions in Mexico. OXXO allows customers to pay bills and online purchases in-store with cash. Check this [page](https://stripe.com/docs/payments/oxxo) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
p24:
description: Przelewy24 is a Poland-based payment method aggregator that allows customers to complete transactions online using bank transfers and other methods. Bank transfers account for 30% of online payments in Poland and Przelewy24 provides a way for customers to pay with over 165 banks. Check this [page](https://stripe.com/docs/payments/p24) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
title: payment_method_param
type: object
parent:
description: Configuration's parent configuration. Specify to create a child configuration.
maxLength: 100
type: string
paynow:
description: PayNow is a Singapore-based payment method that allows customers to make a payment using their preferred app from participating banks and participating non-bank financial institutions. Check this [page](https://stripe.com/docs/payments/paynow) for more details.
properties:
display_preference:
properties:
preference:
enum:
- none
- 'off'
- 'on'
type: string
title: display_preference_param
type: object
# --- truncated at 32 KB (68 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/openapi/stripe-payment-method-configurations-api-openapi.yml