Sample - Stripe API
POST/v1/terminal/configurations/{configuration}

Update a Terminal configuration

Updates an existing Terminal configuration for readers. Supply only the configuration properties you want to change, including device-specific settings, connectivity, offline collection, reboot windows, tipping, or the configuration name. The response returns the updated configuration or a deleted configuration representation.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.
  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 16 body fields
configurationstringrequired
The unique identifier of the Terminal configuration to update. Must not exceed 5000 characters.

Optional Terminal configuration properties to update using form-encoded data.

bbpos_wisepad3objectoptional
An object containing device type specific settings for BBPOS WisePad 3 readers.
bbpos_wisepos_eobjectoptional
An object containing device type specific settings for BBPOS WisePOS E readers.
cellularobjectoptional
Configuration for cellular connectivity.
expandarray<string>optional
Specifies which fields in the response should be expanded.
namestringoptional
Name of the configuration
offlineobjectoptional
Configurations for collecting transactions offline.
reboot_windowobjectoptional
Reboot time settings for readers. that support customized reboot time configuration.
stripe_s700objectoptional
An object containing device type specific settings for Stripe S700 readers.
stripe_s710objectoptional
An object containing device type specific settings for Stripe S710 readers.
tippingobjectoptional
Tipping configurations for readers that support on-reader tips.
verifone_m425objectoptional
An object containing device type specific settings for Verifone M425 readers.
verifone_p400objectoptional
An object containing device type specific settings for Verifone P400 readers.
verifone_p630objectoptional
An object containing device type specific settings for Verifone P630 readers.
verifone_ux700objectoptional
An object containing device type specific settings for Verifone UX700 readers.
verifone_v660pobjectoptional
An object containing device type specific settings for Verifone V660p readers.
wifiobjectoptional
Configurations for connecting to a WiFi network.

2 status codes
200Returns the updated Terminal configuration object, or a deleted configuration object containing its identifier and deleted state.
bbpos_wisepad3objectoptional
bbpos_wisepos_eobjectoptional
cellularobjectoptional
idstringrequired
Unique identifier for the object.
is_account_defaultbooleanoptional
Whether this Configuration is the default for your account
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
namestringoptional
String indicating the name of the Configuration object, set by the user
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:terminal.configuration
offlineobjectoptional
reboot_windowobjectoptional
stripe_s700objectoptional
stripe_s710objectoptional
tippingobjectoptional
verifone_m425objectoptional
verifone_p400objectoptional
verifone_p630objectoptional
verifone_ux700objectoptional
verifone_v660pobjectoptional
wifiobjectoptional
defaultReturns an error object containing an error type and, when available, details such as a message, parameter, code, or documentation URL.
errorobjectrequired

Error handling

configuration must identify the configuration to update and must not exceed 5000 characters. name must not exceed 100 characters, and nested settings such as cellular, offline, and reboot_window must include their defined required values when those objects are supplied.