POST /v1/payment_method_configurations/{configuration}

Update payment method configuration

Servers

Path parameters

Name Type Required Description
configuration String Yes

Request headers

Name Type Required Description
Content-Type String Yes The media type of the request body.

Default value: "application/x-www-form-urlencoded"

Request body fields

Name Type Required Description
swish Object No

Swish is a real-time payment method popular in Sweden. It allows customers to authenticate and approve payments using the Swish mobile app and the Swedish BankID mobile app. Check this page for more details.

swish.display_preference Object No
swish.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
multibanco Object No

Stripe users in Europe and the United States can accept Multibanco payments from customers in Portugal using Sources—a single integration path for creating payments using any supported method.

multibanco.display_preference Object No
multibanco.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
affirm Object No

Affirm 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 for more details like country availability.

affirm.display_preference Object No
affirm.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
apple_pay Object No

Stripe users can accept 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 is the same as other card transactions. Check this page for more details.

apple_pay.display_preference Object No
apple_pay.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
mobilepay Object No

MobilePay is a single-use card wallet payment method used in Denmark and Finland. It allows customers to authenticate and approve payments using the MobilePay app. Check this page for more details.

mobilepay.display_preference Object No
mobilepay.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
paynow Object No

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 for more details.

paynow.display_preference Object No
paynow.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
customer_balance Object No

Uses a customer’s cash balance for the payment. The cash balance can be funded via a bank transfer. Check this page for more details.

customer_balance.display_preference Object No
customer_balance.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
google_pay Object No

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 for more details.

google_pay.display_preference Object No
google_pay.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
pix Object No

Pix is a payment method popular in Brazil. When paying with Pix, customers authenticate and approve payments by scanning a QR code in their preferred banking app. Check this page for more details.

pix.display_preference Object No
pix.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
sofort Object No

Stripe users in Europe and the United States can use the Payment Intents API—a single integration path for creating payments using any supported method—to accept Sofort payments from customers. Check this page for more details.

sofort.display_preference Object No
sofort.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
alipay Object No

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 for more details.

alipay.display_preference Object No
alipay.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
cashapp Object No

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 for more details.

cashapp.display_preference Object No
cashapp.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
zip Object No

Zip gives your customers a way to split purchases over a series of payments. Check this page for more details like country availability.

zip.display_preference Object No
zip.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
afterpay_clearpay Object No

Afterpay gives your customers a way to pay for purchases in installments, check this page for more details like country availability. Afterpay is particularly popular among businesses selling fashion, beauty, and sports products.

afterpay_clearpay.display_preference Object No
afterpay_clearpay.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
twint Object No

Twint is a payment method popular in Switzerland. It allows customers to pay using their mobile phone. Check this page for more details.

twint.display_preference Object No
twint.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
eps Object No

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 for more details.

eps.display_preference Object No
eps.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
us_bank_account Object No

Stripe users in the United States can accept ACH direct debit payments from customers with a US bank account using the Automated Clearing House (ACH) payments system operated by Nacha. Check this page for more details.

us_bank_account.display_preference Object No
us_bank_account.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
au_becs_debit Object No

Stripe users in Australia can accept Bulk Electronic Clearing System (BECS) direct debit payments from customers with an Australian bank account. Check this page for more details.

au_becs_debit.display_preference Object No
au_becs_debit.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
konbini Object No

Konbini allows customers in Japan to pay for bills and online purchases at convenience stores with cash. Check this page for more details.

konbini.display_preference Object No
konbini.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
oxxo Object No

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 for more details.

oxxo.display_preference Object No
oxxo.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
cartes_bancaires Object No

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 for more details.

cartes_bancaires.display_preference Object No
cartes_bancaires.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
bancontact Object No

Bancontact is the most popular online payment method in Belgium, with over 15 million cards in circulation. 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 for more details.

bancontact.display_preference Object No
bancontact.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
p24 Object No

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 for more details.

p24.display_preference Object No
p24.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
expand[] Array No

Specifies which fields in the response should be expanded.

card Object No

Cards are a popular way for consumers and businesses to pay online or in person. Stripe supports global and local card networks.

card.display_preference Object No
card.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
name String No

Configuration name.

apple_pay_later Object No

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.

apple_pay_later.display_preference Object No
apple_pay_later.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
ideal Object No

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 for more details.

ideal.display_preference Object No
ideal.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
jcb Object No

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 for more details.

jcb.display_preference Object No
jcb.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
amazon_pay Object No

Amazon Pay is a wallet payment method that lets your customers check out the same way as on Amazon.

amazon_pay.display_preference Object No
amazon_pay.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
paypal Object No

PayPal, a digital wallet popular with customers in Europe, allows your customers worldwide to pay using their PayPal account. Check this page for more details.

paypal.display_preference Object No
paypal.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
bacs_debit Object No

Stripe users in the UK can accept Bacs Direct Debit payments from customers with a UK bank account, check this page for more details.

bacs_debit.display_preference Object No
bacs_debit.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
naver_pay Object No

Naver Pay is a popular local wallet available in South Korea.

naver_pay.display_preference Object No
naver_pay.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
klarna Object No

Klarna gives customers a range of 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 for more details.

klarna.display_preference Object No
klarna.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
acss_debit Object No

Canadian pre-authorized debit payments, check this page for more details like country availability.

acss_debit.display_preference Object No
acss_debit.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
blik Object No

BLIK is a single use 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 for more details.

blik.display_preference Object No
blik.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
payco Object No

PAYCO is a [single-use](https://docs.stripe.com/payments/payment-methods#usage local wallet available in South Korea.

payco.display_preference Object No
payco.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
wechat_pay Object No

WeChat, owned by Tencent, is China's leading mobile app with over 1 billion monthly active users. Chinese consumers can use WeChat Pay to pay for goods and services inside of businesses' apps and websites. WeChat Pay users buy most frequently in gaming, e-commerce, travel, online education, and food/nutrition. Check this page for more details.

wechat_pay.display_preference Object No
wechat_pay.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
pay_by_bank Object No

Pay by bank is a redirect payment method backed by bank transfers. A customer is redirected to their bank to authorize a bank transfer for a given amount. This removes a lot of the error risks inherent in waiting for the customer to initiate a transfer themselves, and is less expensive than card payments.

pay_by_bank.display_preference Object No
pay_by_bank.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
promptpay Object No

PromptPay is a Thailand-based payment method that allows customers to make a payment using their preferred app from participating banks. Check this page for more details.

promptpay.display_preference Object No
promptpay.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
active Boolean No

Whether the configuration can be used for new payments.

giropay Object No

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 for more details.

giropay.display_preference Object No
giropay.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
kakao_pay Object No

Kakao Pay is a popular local wallet available in South Korea.

kakao_pay.display_preference Object No
kakao_pay.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
alma Object No

Alma is a Buy Now, Pay Later payment method that offers customers the ability to pay in 2, 3, or 4 installments.

alma.display_preference Object No
alma.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
link Object No

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.

link.display_preference Object No
link.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
satispay Object No

Satispay is a single-use payment method where customers are required to authenticate their payment. Customers pay by being redirected from your website or app, authorizing the payment with Satispay, then returning to your website or app. You get immediate notification of whether the payment succeeded or failed.

satispay.display_preference Object No
satispay.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
fpx Object No

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 for more details.

fpx.display_preference Object No
fpx.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
revolut_pay Object No

Revolut Pay, developed by Revolut, a global finance app, is a digital wallet payment method. Revolut Pay uses the customer’s stored balance or cards to fund the payment, and offers the option for non-Revolut customers to save their details after their first purchase.

revolut_pay.display_preference Object No
revolut_pay.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
billie Object No

Billie is a single-use payment method that offers businesses Pay by Invoice where they offer payment terms ranging from 7-120 days. Customers are redirected from your website or app, authorize the payment with Billie, then return to your website or app. You get immediate notification of whether the payment succeeded or failed.

billie.display_preference Object No
billie.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
sepa_debit Object No

The Single Euro Payments Area (SEPA) is an initiative of the European Union to simplify payments within and across member countries. SEPA established and enforced banking standards to allow for the direct debiting of every EUR-denominated bank account within the SEPA region, check this page for more details.

sepa_debit.display_preference Object No
sepa_debit.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
kr_card Object No

Korean cards let users pay using locally issued cards from South Korea.

kr_card.display_preference Object No
kr_card.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
samsung_pay Object No

Samsung Pay is a [single-use](https://docs.stripe.com/payments/payment-methods#usage local wallet available in South Korea.

samsung_pay.display_preference Object No
samsung_pay.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
nz_bank_account Object No

Stripe users in New Zealand can accept Bulk Electronic Clearing System (BECS) direct debit payments from customers with a New Zeland bank account. Check this page for more details.

nz_bank_account.display_preference Object No
nz_bank_account.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
grabpay Object No

GrabPay is a payment method developed by Grab. GrabPay is a digital wallet - customers maintain a balance in their wallets that they pay out with. Check this page for more details.

grabpay.display_preference Object No
grabpay.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"
boleto Object No

Boleto is an official (regulated by the Central Bank of Brazil) payment method in Brazil. Check this page for more details.

boleto.display_preference Object No
boleto.display_preference.preference String No

Possible values:

  • "on"
  • "off"
  • "none"

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.