Stripe: Create a Configuration

← Terminal operations · Get started

Operation stripe.postterminalconfigurations

Provider route: POST /v1/terminal/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["terminal"]["postTerminalConfigurations"]>[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.terminal.postTerminalConfigurations(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.terminal.post_terminal_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.bbpos_wisepad3	object	Optional	An object containing device type specific settings for BBPOS WisePad 3 readers.
body.bbpos_wisepad3.splashscreen	JSON	Optional
body.bbpos_wisepad3.splashscreen (anyOf 1)	string	Alternative
body.bbpos_wisepad3.splashscreen (anyOf 2)	string	Alternative	One of:
body.bbpos_wisepos_e	object	Optional	An object containing device type specific settings for BBPOS WisePOS E readers.
body.bbpos_wisepos_e.splashscreen	JSON	Optional
body.bbpos_wisepos_e.splashscreen (anyOf 1)	string	Alternative
body.bbpos_wisepos_e.splashscreen (anyOf 2)	string	Alternative	One of:
body.cellular	JSON	Optional	Configuration for cellular connectivity.
body.cellular (anyOf 1)	object	Alternative
body.cellular (anyOf 1).enabled	boolean	Required within parent
body.cellular (anyOf 2)	string	Alternative	One of:
body.expand	array	Optional	Specifies which fields in the response should be expanded.
body.expand[]	string	Each item	Maximum length: 5000
body.name	string	Optional	Name of the configuration Maximum length: 100
body.offline	JSON	Optional	Configurations for collecting transactions offline.
body.offline (anyOf 1)	object	Alternative
body.offline (anyOf 1).enabled	boolean	Required within parent
body.offline (anyOf 2)	string	Alternative	One of:
body.reboot_window	object	Optional	Reboot time settings for readers. that support customized reboot time configuration.
body.reboot_window.end_hour	integer	Required within parent
body.reboot_window.start_hour	integer	Required within parent
body.stripe_s700	object	Optional	An object containing device type specific settings for Stripe S700 readers.
body.stripe_s700.splashscreen	JSON	Optional
body.stripe_s700.splashscreen (anyOf 1)	string	Alternative
body.stripe_s700.splashscreen (anyOf 2)	string	Alternative	One of:
body.stripe_s710	object	Optional	An object containing device type specific settings for Stripe S710 readers.
body.stripe_s710.splashscreen	JSON	Optional
body.stripe_s710.splashscreen (anyOf 1)	string	Alternative
body.stripe_s710.splashscreen (anyOf 2)	string	Alternative	One of:
body.tipping	JSON	Optional	Tipping configurations for readers that support on-reader tips.
body.tipping (anyOf 1)	Model	Alternative	Expand Create a Configuration — request body — body tipping aed, aud, cad, chf, czk, dkk, eur, gbp, gip, hkd, huf, jpy, mxn, myr, nok, nzd, pln, ron, sek, sgd, usd
body.tipping (anyOf 2)	string	Alternative	One of:
body.verifone_m425	object	Optional	An object containing device type specific settings for Verifone M425 readers.
body.verifone_m425.splashscreen	JSON	Optional
body.verifone_m425.splashscreen (anyOf 1)	string	Alternative
body.verifone_m425.splashscreen (anyOf 2)	string	Alternative	One of:
body.verifone_p400	object	Optional	An object containing device type specific settings for Verifone P400 readers.
body.verifone_p400.splashscreen	JSON	Optional
body.verifone_p400.splashscreen (anyOf 1)	string	Alternative
body.verifone_p400.splashscreen (anyOf 2)	string	Alternative	One of:
body.verifone_p630	object	Optional	An object containing device type specific settings for Verifone P630 readers.
body.verifone_p630.splashscreen	JSON	Optional
body.verifone_p630.splashscreen (anyOf 1)	string	Alternative
body.verifone_p630.splashscreen (anyOf 2)	string	Alternative	One of:
body.verifone_ux700	object	Optional	An object containing device type specific settings for Verifone UX700 readers.
body.verifone_ux700.splashscreen	JSON	Optional
body.verifone_ux700.splashscreen (anyOf 1)	string	Alternative
body.verifone_ux700.splashscreen (anyOf 2)	string	Alternative	One of:
body.verifone_v660p	object	Optional	An object containing device type specific settings for Verifone V660p readers.
body.verifone_v660p.splashscreen	JSON	Optional
body.verifone_v660p.splashscreen (anyOf 1)	string	Alternative
body.verifone_v660p.splashscreen (anyOf 2)	string	Alternative	One of:
body.wifi	JSON	Optional	Configurations for connecting to a WiFi network.
body.wifi (anyOf 1)	Model	Alternative	Expand Create a Configuration — request body — body / wifi / type: enterprise eap peap, enterprise eap tls, personal psk
body.wifi (anyOf 2)	string	Alternative	One of:

Referenced models: Create a Configuration — request body — body tipping aed, aud, cad, chf, czk, dkk, eur, gbp, gip, hkd, huf, jpy, mxn, myr, nok, nzd, pln, ron, sek, sgd, usd, Create a Configuration — request body — body / wifi / type: enterprise eap peap, enterprise eap tls, personal psk

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 Create a Configuration — response body

Referenced models: Create a Configuration — response body

Schemas

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

Create a Configuration — response body

Field	Type	Presence	Description and constraints
$	object	Root	A Configurations object represents how features should be configured for terminal readers. For information about how to use it, see the [Terminal configurations documentation](https://docs.stripe.com/terminal/fleet/configurations-overview).
bbpos_wisepad3	Model	Optional	Expand Create a Configuration — response body — stripe s700
bbpos_wisepos_e	Model	Optional	Expand Create a Configuration — response body — stripe s700
cellular	Model	Optional	Expand Create a Configuration — response body — cellular
id	string	Required within parent	Unique identifier for the object. Maximum length: 5000
is_account_default	JSON	Optional
is_account_default (anyOf 1)	boolean	Alternative	Whether this Configuration is the default for your account
is_account_default (anyOf 2)	null	Alternative
livemode	boolean	Required within parent	If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
name	JSON	Optional
name (anyOf 1)	string	Alternative	String indicating the name of the Configuration object, set by the user Maximum length: 5000
name (anyOf 2)	null	Alternative
object	string	Required within parent	String representing the object's type. Objects of the same type share the same value. Known values: terminal.configuration
offline	Model	Optional	Expand Create a Configuration — response body — offline
reboot_window	Model	Optional	Expand Create a Configuration — response body — reboot window
stripe_s700	Model	Optional	Expand Create a Configuration — response body — stripe s700
stripe_s710	Model	Optional	Expand Create a Configuration — response body — stripe s700
tipping	Model	Optional	Expand Create a Configuration — response body — tipping
verifone_m425	Model	Optional	Expand Create a Configuration — response body — stripe s700
verifone_p400	Model	Optional	Expand Create a Configuration — response body — stripe s700
verifone_p630	Model	Optional	Expand Create a Configuration — response body — stripe s700
verifone_ux700	Model	Optional	Expand Create a Configuration — response body — stripe s700
verifone_v660p	Model	Optional	Expand Create a Configuration — response body — stripe s700
wifi	Model	Optional	Expand Create a Configuration — response body — wifi

Referenced models: Create a Configuration — response body — cellular, Create a Configuration — response body — stripe s700, Create a Configuration — response body — offline, Create a Configuration — response body — reboot window, Create a Configuration — response body — tipping, Create a Configuration — response body — wifi

Create a Configuration — request body — body / wifi / type: enterprise eap peap, enterprise eap tls, personal psk

Field	Type	Presence	Description and constraints
$	object	Root
enterprise_eap_peap	object	Optional
enterprise_eap_peap.ca_certificate_file	string	Optional
enterprise_eap_peap.password	string	Required within parent	Maximum length: 5000
enterprise_eap_peap.ssid	string	Required within parent	Maximum length: 5000
enterprise_eap_peap.username	string	Required within parent	Maximum length: 5000
enterprise_eap_tls	object	Optional
enterprise_eap_tls.ca_certificate_file	string	Optional
enterprise_eap_tls.client_certificate_file	string	Required within parent
enterprise_eap_tls.private_key_file	string	Required within parent
enterprise_eap_tls.private_key_file_password	string	Optional	Maximum length: 5000
enterprise_eap_tls.ssid	string	Required within parent	Maximum length: 5000
personal_psk	object	Optional
personal_psk.password	string	Required within parent	Maximum length: 63
personal_psk.ssid	string	Required within parent	Maximum length: 5000
type	string	Required within parent	One of: enterprise_eap_peap, enterprise_eap_tls, personal_psk

Create a Configuration — response body — cellular

Field	Type	Presence	Description and constraints
$	object	Root
enabled	boolean	Required within parent	Whether a cellular-capable reader can connect to the internet over cellular.

Create a Configuration — response body — stripe s700

Field	Type	Presence	Description and constraints
$	object	Root
splashscreen	JSON	Optional	A File ID representing an image to display on the reader
splashscreen (anyOf 1)	string	Alternative	Maximum length: 5000
splashscreen (anyOf 2)	Model	Alternative	Expand Create a file — response body

Referenced models: Create a file — response body

Create a Configuration — response body — offline

Field	Type	Presence	Description and constraints
$	object	Root
enabled	JSON	Optional
enabled (anyOf 1)	boolean	Alternative	Determines whether to allow transactions to be collected while reader is offline. Defaults to false.
enabled (anyOf 2)	null	Alternative

Create a Configuration — response body — reboot window

Field	Type	Presence	Description and constraints
$	object	Root
end_hour	JSON	Required within parent
end_hour (anyOf 1)	integer	Alternative	Integer between 0 to 23 that represents the end hour of the reboot time window. The value must be different than the start_hour.
end_hour (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
start_hour	JSON	Required within parent
start_hour (anyOf 1)	integer	Alternative	Integer between 0 to 23 that represents the start hour of the reboot time window.
start_hour (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Create a Configuration — response body — wifi

Field	Type	Presence	Description and constraints
$	object	Root
enterprise_eap_peap	Model	Optional	Expand Create a Configuration — response body — wifi enterprise eap peap
enterprise_eap_tls	Model	Optional	Expand Create a Configuration — response body — wifi enterprise eap tls
personal_psk	Model	Optional	Expand Create a Configuration — response body — wifi personal psk
type	string	Required within parent	Security type of the WiFi network. The hash with the corresponding name contains the credentials for this security type. Known values: enterprise_eap_peap, enterprise_eap_tls, personal_psk

Referenced models: Create a Configuration — response body — wifi enterprise eap peap, Create a Configuration — response body — wifi enterprise eap tls, Create a Configuration — response body — wifi personal psk

Create a Configuration — response body — wifi enterprise eap peap

Field	Type	Presence	Description and constraints
$	object	Root
ca_certificate_file	string	Optional	A File ID representing a PEM file containing the server certificate Maximum length: 5000
password	string	Required within parent	Password for connecting to the WiFi network Maximum length: 5000
ssid	string	Required within parent	Name of the WiFi network Maximum length: 5000
username	string	Required within parent	Username for connecting to the WiFi network Maximum length: 5000

Policy, approvals and errors

SDK function policy ID: stripe.postterminalconfigurations. Catalog operation: PostTerminalConfigurations. 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