zishaansunderji-terminal-curl | Stripe Developers | Page 1

meager elk Jan 25, 2022, 10:32 PM

#

Hello 👋

short tartan Jan 25, 2022, 10:32 PM

#

Hi Hanzo!!

#

This is the url i'm referencing: https://stripe.com/docs/terminal/fleet/splash-screen#reader-settings-object

Configure readers with a custom splash screen

Customize the default splash screen for your readers.

#

Sorry this one: https://stripe.com/docs/terminal/features/collecting-tips/on-reader#collecting-tips-on-the-reader

Collect on-reader tips

meager elk Jan 25, 2022, 10:38 PM

#

gotcha
so first you'd need to create Reader Setting object for which you don't need to pass in reader id
You'd pass in the id when you create or update the Configuration Object for the reader

#

https://stripe.com/docs/terminal/fleet/splash-screen#configuration-object

short tartan Jan 25, 2022, 10:39 PM

#

So the reader settings object created is tied to the reader, or the location or our account?

#

Ideally it'd be reader or location - because the tip values do differ by business

meager elk Jan 25, 2022, 10:40 PM

#

So the reader settings object created is tied to the reader, or the location or our account?
It is tied to location and the account

short tartan Jan 25, 2022, 10:40 PM

#

got it!

#

so what happens after this curl request to create a new reader setting - because it doesn't have any information on the location

#

curl https://api.stripe.com/v1/terminal/reader_settings \
  -u sk_test_51JwtroFk5BSitd8bHKcdrngNcP1mdtb1kaOXjcAoNjNrsAuCypVCJlzBk5XQwUM63DnQOuGR0Q5pzegYVVApD77X00L4wLjgki: \
  -H "Stripe-Version: 2020-08-27;terminal_configuration_api_beta=v1" \
  -d "type"="bbpos_wisepos_e" \
  -d "bbpos_wisepos_e[splashscreen]"="file_1HQJBRExnwiLYIChlaTaqZg6"
  # provide the File object you created in step 1

meager elk Jan 25, 2022, 10:44 PM

#

I think I misspoke earlier
The reader settings are tied to a configuration object which can be tied to either a location OR you can set it as default on your account

short tartan Jan 25, 2022, 10:44 PM

#

Oh I see - so the process goes:
a) create a reader setting, and then
b) assign those settings to a reader (via the configuration request)

#

Is that right?

#

but also if an existing reader has some settings previously - those will retain to those readers as long as the configuration object isn't updated for that exact reader

meager elk Jan 25, 2022, 10:48 PM

#

actually there is a step missing;
a) create a reader setting, and then
b) you'd assign it to the configuration object
c) assign the configuration object to a location or your account

https://stripe.com/docs/terminal/fleet/splash-screen#configuration-object

short tartan Jan 25, 2022, 10:50 PM

#

oh got it - so how do we assign the configuration to the location (like programmatic wise)?

#

I only see a link to this: https://stripe.com/docs/api/terminal/locations

Stripe API reference – Locations – curl

Complete reference documentation for the Stripe API. Includes code snippets and examples for our Python, Java, PHP, Node.js, Go, Ruby, and .NET libraries.

#

Oh my bad lol, is this it:

curl https://api.stripe.com/v1/terminal/locations/tml_DPJxAAnxbn3JQz \
  -u sk_test_51JwtroFk5BSitd8bHKcdrngNcP1mdtb1kaOXjcAoNjNrsAuCypVCJlzBk5XQwUM63DnQOuGR0Q5pzegYVVApD77X00L4wLjgki: \
  -H "Stripe-Version: 2020-08-27;terminal_configuration_api_beta=v1" \
  -d "configuration_overrides"="uc_88bb0c8c-fcd3-434a-8ac0-6a642e9dc6ef"
  # provide the Configuration object you created in step 3

#

I didn't scroll lower lol

#

I think it all makes sense - thanks for your help!! 🙂

meager elk Jan 25, 2022, 10:57 PM

#

Great! Glad I could help 🙂

#zishaansunderji-terminal-curl