Stripe: Create a payment method configuration

← Payment method configurations operations · Get started

Operation stripe.postpaymentmethodconfigurations

Provider route: POST /v1/payment_method_configurations. Alter supplies the connection’s credentials and routing.

Call through Alter

Install @alter-ai/sdk @alter-ai/stripe with npm, or alter-sdk-stripe with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { StripeIntegration } from "@alter-ai/stripe";

async function execute(input: Parameters<StripeIntegration["paymentMethodConfigurations"]["postPaymentMethodConfigurations"]>[0]) {
  const app = new App({ apiKey: process.env.ALTER_API_KEY! });
  try {
    const provider = new StripeIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
    const call = await provider.paymentMethodConfigurations.postPaymentMethodConfigurations(input);
    const result = await call.wait();
    return result.bodyJson();
  } finally {
    await app.close();
  }
}

import os
from alter_sdk import App
from alter_sdk_stripe import StripeIntegration

async def execute(arguments):
    async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
        provider = StripeIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
        call = await provider.payment_method_configurations.post_payment_method_configurations(arguments)
        result = await call.wait()
        return result.body_json()

Input

Field	Type	Presence	Description and constraints
$	object	Root	Additional keys: not allowed
headers	object	Optional	Additional keys: not allowed
headers.Idempotency-Key	string	Optional	Minimum length: 1 Maximum length: 255
body	object	Optional	Additional keys: not allowed
body.acss_debit	object	Optional	Canadian pre-authorized debit payments, check this [page](https://docs.stripe.com/payments/acss-debit) for more details like country availability.
body.acss_debit.display_preference	object	Optional
body.acss_debit.display_preference.preference	string	Optional	One of: none, off, on
body.affirm	Model	Optional	Expand Update payment method configuration — request body — body affirm
body.afterpay_clearpay	object	Optional	Afterpay gives your customers a way to pay for purchases in installments, check this [page](https://docs.stripe.com/payments/afterpay-clearpay) for more details like country availability. Afterpay is particularly popular among businesses selling fashion, beauty, and sports products.
body.afterpay_clearpay.display_preference	object	Optional
body.afterpay_clearpay.display_preference.preference	string	Optional	One of: none, off, on
body.alipay	Model	Optional	Expand Update payment method configuration — request body — body alipay
body.alma	object	Optional	Alma is a Buy Now, Pay Later payment method that offers customers the ability to pay in 2, 3, or 4 installments.
body.alma.display_preference	object	Optional
body.alma.display_preference.preference	string	Optional	One of: none, off, on
body.amazon_pay	object	Optional	Amazon Pay is a wallet payment method that lets your customers check out the same way as on Amazon.
body.amazon_pay.display_preference	object	Optional
body.amazon_pay.display_preference.preference	string	Optional	One of: none, off, on
body.apple_pay	Model	Optional	Expand Update payment method configuration — request body — body apple pay
body.apple_pay_later	object	Optional	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.
body.apple_pay_later.display_preference	object	Optional
body.apple_pay_later.display_preference.preference	string	Optional	One of: none, off, on
body.au_becs_debit	object	Optional	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://docs.stripe.com/payments/au-becs-debit) for more details.
body.au_becs_debit.display_preference	object	Optional
body.au_becs_debit.display_preference.preference	string	Optional	One of: none, off, on
body.bacs_debit	object	Optional	Stripe users in the UK can accept Bacs Direct Debit payments from customers with a UK bank account, check this [page](https://docs.stripe.com/payments/payment-methods/bacs-debit) for more details.
body.bacs_debit.display_preference	object	Optional
body.bacs_debit.display_preference.preference	string	Optional	One of: none, off, on
body.bancontact	Model	Optional	Expand Update payment method configuration — request body — body bancontact
body.billie	Model	Optional	Expand Update payment method configuration — request body — body billie
body.bizum	object	Optional	To enable Bizum, buyers need a Spanish IBAN from a bank connected to Bizum. Within their banking app, they can enable Bizum and link their mobile number to their IBAN.
body.bizum.display_preference	object	Optional
body.bizum.display_preference.preference	string	Optional	One of: none, off, on
body.blik	Model	Optional	Expand Update payment method configuration — request body — body blik
body.boleto	object	Optional	Boleto is an official (regulated by the Central Bank of Brazil) payment method in Brazil. Check this [page](https://docs.stripe.com/payments/boleto) for more details.
body.boleto.display_preference	object	Optional
body.boleto.display_preference.preference	string	Optional	One of: none, off, on
body.card	object	Optional	Cards are a popular way for consumers and businesses to pay online or in person. Stripe supports global and local card networks.
body.card.display_preference	object	Optional
body.card.display_preference.preference	string	Optional	One of: none, off, on
body.cartes_bancaires	object	Optional	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://docs.stripe.com/payments/cartes-bancaires) for more details.
body.cartes_bancaires.display_preference	object	Optional
body.cartes_bancaires.display_preference.preference	string	Optional	One of: none, off, on
body.cashapp	object	Optional	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://docs.stripe.com/payments/cash-app-pay) for more details.
body.cashapp.display_preference	object	Optional
body.cashapp.display_preference.preference	string	Optional	One of: none, off, on
body.crypto	object	Optional	[Stablecoin payments](https://docs.stripe.com/payments/stablecoin-payments) enable customers to pay in stablecoins like USDC from 100s of wallets including Phantom and Metamask.
body.crypto.display_preference	object	Optional
body.crypto.display_preference.preference	string	Optional	One of: none, off, on
body.customer_balance	object	Optional	Uses a customer’s [cash balance](https://docs.stripe.com/payments/customer-balance) for the payment. The cash balance can be funded via a bank transfer. Check this [page](https://docs.stripe.com/payments/bank-transfers) for more details.
body.customer_balance.display_preference	object	Optional
body.customer_balance.display_preference.preference	string	Optional	One of: none, off, on
body.eps	object	Optional	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://docs.stripe.com/payments/eps) for more details.
body.eps.display_preference	object	Optional
body.eps.display_preference.preference	string	Optional	One of: none, off, on
body.expand	array	Optional	Specifies which fields in the response should be expanded.
body.expand[]	string	Each item	Maximum length: 5000
body.fpx	Model	Optional	Expand Update payment method configuration — request body — body fpx
body.fr_meal_voucher_conecs	object	Optional	Meal vouchers in France, or “titres-restaurant”, is a local benefits program commonly offered by employers for their employees to purchase prepared food and beverages on working days. Check this [page](https://docs.stripe.com/payments/meal-vouchers/fr-meal-vouchers) for more details.
body.fr_meal_voucher_conecs.display_preference	object	Optional
body.fr_meal_voucher_conecs.display_preference.preference	string	Optional	One of: none, off, on
body.giropay	Model	Optional	Expand Update payment method configuration — request body — body giropay
body.google_pay	Model	Optional	Expand Update payment method configuration — request body — body google pay
body.grabpay	object	Optional	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://docs.stripe.com/payments/grabpay) for more details.
body.grabpay.display_preference	object	Optional
body.grabpay.display_preference.preference	string	Optional	One of: none, off, on
body.ideal	Model	Optional	Expand Update payment method configuration — request body — body ideal
body.jcb	Model	Optional	Expand Update payment method configuration — request body — body jcb
body.kakao_pay	object	Optional	Kakao Pay is a popular local wallet available in South Korea.
body.kakao_pay.display_preference	object	Optional
body.kakao_pay.display_preference.preference	string	Optional	One of: none, off, on
body.klarna	Model	Optional	Expand Update payment method configuration — request body — body klarna
body.konbini	object	Optional	Konbini allows customers in Japan to pay for bills and online purchases at convenience stores with cash. Check this [page](https://docs.stripe.com/payments/konbini) for more details.
body.konbini.display_preference	object	Optional
body.konbini.display_preference.preference	string	Optional	One of: none, off, on
body.kr_card	object	Optional	Korean cards let users pay using locally issued cards from South Korea.
body.kr_card.display_preference	object	Optional
body.kr_card.display_preference.preference	string	Optional	One of: none, off, on
body.link	object	Optional	[Link](https://docs.stripe.com/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.
body.link.display_preference	object	Optional
body.link.display_preference.preference	string	Optional	One of: none, off, on
body.mb_way	object	Optional	MB WAY is the most popular wallet in Portugal. After entering their phone number in your checkout, customers approve the payment directly in their MB WAY app. Check this [page](https://docs.stripe.com/payments/mb-way) for more details.
body.mb_way.display_preference	object	Optional
body.mb_way.display_preference.preference	string	Optional	One of: none, off, on
body.mobilepay	Model	Optional	Expand Update payment method configuration — request body — body mobilepay
body.multibanco	object	Optional	Stripe users in Europe and the United States can accept Multibanco payments from customers in Portugal using [Sources](https://stripe.com/docs/sources)—a single integration path for creating payments using any supported method.
body.multibanco.display_preference	object	Optional
body.multibanco.display_preference.preference	string	Optional	One of: none, off, on
body.name	string	Optional	Configuration name. Maximum length: 100
body.naver_pay	object	Optional	Naver Pay is a popular local wallet available in South Korea.
body.naver_pay.display_preference	object	Optional
body.naver_pay.display_preference.preference	string	Optional	One of: none, off, on
body.nz_bank_account	object	Optional	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](https://docs.stripe.com/payments/nz-bank-account) for more details.
body.nz_bank_account.display_preference	object	Optional
body.nz_bank_account.display_preference.preference	string	Optional	One of: none, off, on
body.oxxo	object	Optional	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://docs.stripe.com/payments/oxxo) for more details.
body.oxxo.display_preference	object	Optional
body.oxxo.display_preference.preference	string	Optional	One of: none, off, on
body.p24	Model	Optional	Expand Update payment method configuration — request body — body p24
body.parent	string	Optional	Configuration’s parent configuration. Specify to create a child configuration. Maximum length: 100
body.pay_by_bank	object	Optional	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.
body.pay_by_bank.display_preference	object	Optional
body.pay_by_bank.display_preference.preference	string	Optional	One of: none, off, on
body.payco	object	Optional	PAYCO is a [single-use](https://docs.stripe.com/payments/payment-methods#usage local wallet available in South Korea.
body.payco.display_preference	object	Optional
body.payco.display_preference.preference	string	Optional	One of: none, off, on
body.paynow	object	Optional	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://docs.stripe.com/payments/paynow) for more details.
body.paynow.display_preference	object	Optional
body.paynow.display_preference.preference	string	Optional	One of: none, off, on
body.paypal	object	Optional	PayPal, a digital wallet popular with customers in Europe, allows your customers worldwide to pay using their PayPal account. Check this [page](https://docs.stripe.com/payments/paypal) for more details.
body.paypal.display_preference	object	Optional
body.paypal.display_preference.preference	string	Optional	One of: none, off, on
body.paypay	object	Optional	Customers can pay with PayPay online or using the PayPay app.
body.paypay.display_preference	object	Optional
body.paypay.display_preference.preference	string	Optional	One of: none, off, on
body.payto	object	Optional	PayTo is a [real-time](https://docs.stripe.com/payments/real-time) payment method that enables customers in Australia to pay by providing their bank account details. Customers must accept a mandate authorizing you to debit their account. Check this [page](https://docs.stripe.com/payments/payto) for more details.
body.payto.display_preference	object	Optional
body.payto.display_preference.preference	string	Optional	One of: none, off, on
body.pix	object	Optional	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](https://docs.stripe.com/payments/pix) for more details.
body.pix.display_preference	object	Optional
body.pix.display_preference.preference	string	Optional	One of: none, off, on
body.promptpay	object	Optional	PromptPay is a Thailand-based payment method that allows customers to make a payment using their preferred app from participating banks. Check this [page](https://docs.stripe.com/payments/promptpay) for more details.
body.promptpay.display_preference	object	Optional
body.promptpay.display_preference.preference	string	Optional	One of: none, off, on
body.revolut_pay	object	Optional	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.
body.revolut_pay.display_preference	object	Optional
body.revolut_pay.display_preference.preference	string	Optional	One of: none, off, on
body.samsung_pay	object	Optional	Samsung Pay is a [single-use](https://docs.stripe.com/payments/payment-methods#usage local wallet available in South Korea.
body.samsung_pay.display_preference	object	Optional
body.samsung_pay.display_preference.preference	string	Optional	One of: none, off, on
body.satispay	Model	Optional	Expand Update payment method configuration — request body — body satispay
body.scalapay	Model	Optional	Expand Update payment method configuration — request body — body scalapay
body.sepa_debit	Model	Optional	Expand Update payment method configuration — request body — body sepa debit
body.sequra	Model	Optional	Expand Update payment method configuration — request body — body sequra
body.sofort	Model	Optional	Expand Update payment method configuration — request body — body sofort
body.sunbit	Model	Optional	Expand Update payment method configuration — request body — body sunbit
body.swish	Model	Optional	Expand Update payment method configuration — request body — body swish
body.twint	object	Optional	Twint is a payment method popular in Switzerland. It allows customers to pay using their mobile phone. Check this [page](https://docs.stripe.com/payments/twint) for more details.
body.twint.display_preference	object	Optional
body.twint.display_preference.preference	string	Optional	One of: none, off, on
body.upi	object	Optional	Unified Payment Interface (UPI) is India’s leading payment method with exponential growth since it launched in 2016.
body.upi.display_preference	object	Optional
body.upi.display_preference.preference	string	Optional	One of: none, off, on
body.us_bank_account	object	Optional	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](https://docs.stripe.com/payments/ach-direct-debit) for more details.
body.us_bank_account.display_preference	object	Optional
body.us_bank_account.display_preference.preference	string	Optional	One of: none, off, on
body.wechat_pay	Model	Optional	Expand Update payment method configuration — request body — body wechat pay
body.zip	object	Optional	Zip gives your customers a way to split purchases over a series of payments. Check this [page](https://docs.stripe.com/payments/zip) for more details like country availability.
body.zip.display_preference	object	Optional
body.zip.display_preference.preference	string	Optional	One of: none, off, on

Referenced models: Update payment method configuration — request body — body affirm, Update payment method configuration — request body — body alipay, Update payment method configuration — request body — body apple pay, Update payment method configuration — request body — body bancontact, Update payment method configuration — request body — body billie, Update payment method configuration — request body — body blik, Update payment method configuration — request body — body fpx, Update payment method configuration — request body — body giropay, Update payment method configuration — request body — body google pay, Update payment method configuration — request body — body ideal, Update payment method configuration — request body — body jcb, Update payment method configuration — request body — body klarna, Update payment method configuration — request body — body mobilepay, Update payment method configuration — request body — body p24, Update payment method configuration — request body — body satispay, Update payment method configuration — request body — body scalapay, Update payment method configuration — request body — body sepa debit, Update payment method configuration — request body — body sequra, Update payment method configuration — request body — body sofort, Update payment method configuration — request body — body sunbit, Update payment method configuration — request body — body swish, Update payment method configuration — request body — body wechat pay

Response

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

Field	Type	Presence	Description and constraints
$	Model	Root	Expand Update payment method configuration — response body

Referenced models: Update payment method configuration — response body

Schemas

9 more schemas are linked from the tables above, on the schema pages.

Update payment method configuration — request body — body affirm

Field	Type	Presence	Description and constraints
$	object	Root	[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://docs.stripe.com/payments/affirm) for more details like country availability.
display_preference	object	Optional
display_preference.preference	string	Optional	One of: none, off, on

Update payment method configuration — request body — body alipay

Field	Type	Presence	Description and constraints
$	object	Root	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://docs.stripe.com/payments/alipay) for more details.
display_preference	object	Optional
display_preference.preference	string	Optional	One of: none, off, on

Update payment method configuration — request body — body apple pay

Field	Type	Presence	Description and constraints
$	object	Root	Stripe users can accept [Apple Pay](https://stripe.com/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](https://stripe.com/pricing) is the same as other card transactions. Check this [page](https://docs.stripe.com/apple-pay) for more details.
display_preference	object	Optional
display_preference.preference	string	Optional	One of: none, off, on

Update payment method configuration — request body — body bancontact

Field	Type	Presence	Description and constraints
$	object	Root	Bancontact is the most popular online payment method in Belgium, with over 15 million cards in circulation. [Customers](https://docs.stripe.com/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://docs.stripe.com/payments/bancontact) for more details.
display_preference	object	Optional
display_preference.preference	string	Optional	One of: none, off, on

Update payment method configuration — request body — body billie

Field	Type	Presence	Description and constraints
$	object	Root	Billie is a [single-use](https://docs.stripe.com/payments/payment-methods#usage) 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](/payments/payment-methods#payment-notification) of whether the payment succeeded or failed.
display_preference	object	Optional
display_preference.preference	string	Optional	One of: none, off, on

Update payment method configuration — request body — body blik

Field	Type	Presence	Description and constraints
$	object	Root	BLIK is a [single use](https://docs.stripe.com/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://docs.stripe.com/payments/blik) for more details.
display_preference	object	Optional
display_preference.preference	string	Optional	One of: none, off, on

Update payment method configuration — request body — body fpx

Field	Type	Presence	Description and constraints
$	object	Root	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://docs.stripe.com/payments/fpx) for more details.
display_preference	object	Optional
display_preference.preference	string	Optional	One of: none, off, on

Update payment method configuration — request body — body giropay

Field	Type	Presence	Description and constraints
$	object	Root	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://docs.stripe.com/payments/giropay) for more details.
display_preference	object	Optional
display_preference.preference	string	Optional	One of: none, off, on

Update payment method configuration — request body — body google pay

Field	Type	Presence	Description and constraints
$	object	Root	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://docs.stripe.com/google-pay) for more details.
display_preference	object	Optional
display_preference.preference	string	Optional	One of: none, off, on

Update payment method configuration — request body — body ideal

Field	Type	Presence	Description and constraints
$	object	Root	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://docs.stripe.com/payments/ideal) for more details.
display_preference	object	Optional
display_preference.preference	string	Optional	One of: none, off, on

Update payment method configuration — request body — body jcb

Field	Type	Presence	Description and constraints
$	object	Root	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.
display_preference	object	Optional
display_preference.preference	string	Optional	One of: none, off, on

Update payment method configuration — request body — body klarna

Field	Type	Presence	Description and constraints
$	object	Root	Klarna gives customers a range of [payment options](https://docs.stripe.com/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://docs.stripe.com/payments/klarna) for more details.
display_preference	object	Optional
display_preference.preference	string	Optional	One of: none, off, on

Update payment method configuration — request body — body mobilepay

Field	Type	Presence	Description and constraints
$	object	Root	MobilePay is a [single-use](https://docs.stripe.com/payments/payment-methods#usage) card wallet payment method used in Denmark and Finland. It allows customers to [authenticate and approve](https://docs.stripe.com/payments/payment-methods#customer-actions) payments using the MobilePay app. Check this [page](https://docs.stripe.com/payments/mobilepay) for more details.
display_preference	object	Optional
display_preference.preference	string	Optional	One of: none, off, on

Update payment method configuration — request body — body p24

Field	Type	Presence	Description and constraints
$	object	Root	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://docs.stripe.com/payments/p24) for more details.
display_preference	object	Optional
display_preference.preference	string	Optional	One of: none, off, on

Update payment method configuration — request body — body satispay

Field	Type	Presence	Description and constraints
$	object	Root	Satispay is a [single-use](/payments/payment-methods#usage) payment method where customers are required to [authenticate](/payments/payment-methods#customer-actions) 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](/payments/payment-methods#payment-notification) of whether the payment succeeded or failed.
display_preference	object	Optional
display_preference.preference	string	Optional	One of: none, off, on

Update payment method configuration — request body — body scalapay

Field	Type	Presence	Description and constraints
$	object	Root	Scalapay is a [single-use](/payments/payment-methods#usage) payment method that lets customers pay in 3 or 4 installments. Customers are redirected from your website or app, authorize the payment with Scalapay, then return to your website or app. You get [immediate notification](/payments/payment-methods#payment-notification) of whether the payment succeeded or failed.
display_preference	object	Optional
display_preference.preference	string	Optional	One of: none, off, on

Policy, approvals and errors

SDK function policy ID: stripe.postpaymentmethodconfigurations. Catalog operation: PostPaymentMethodConfigurations. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Pinned headers: {"Stripe-Version": "2026-09-30.endive"}

Official provider source