Sample - Stripe API
POST/v1/terminal/configurations

Create a Configuration

Creates a new Configuration object.

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

16 body fields
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
200Successful response.
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
defaultError response.
errorobjectrequired

Error handling

Any other status is an error: Error response.