bassem-planity_terminal-tipping-config | Stripe Developers | Page 1

dapper sandBOT Mar 27, 2025, 1:57 PM

#

👋 Welcome to your new thread!

⏲️ We'll be here soon! Typically we respond in a few minutes, but sometimes we might take a bit longer if the server is busy or if you have a particularly tricky question.

⏱️ We close idle threads, which makes them read-only. Once a thread is closed it won't be reopened, but you can always start a new thread if you have another question.

🔗 This thread will always be available, even after it's closed. You can find it again using Discord's search, or you can save this link: https://discord.com/channels/841573134531821608/1354816718458982622

📝 Have more to share? Add more details, code, screenshots, videos, etc. below.

#

astral bridge Mar 27, 2025, 2:02 PM

#

Can you explain a bit more about what you're trying to do? What are you expecting to happen and what are you observing actually happening instead?

crimson solar Mar 27, 2025, 2:04 PM

#

When sending a payment request to the stripe terminal, we expect the terminal to NOT suggest tips, instead it's suggesting tips.
It was ok a month ago or so. Since then, it is suggesting tips only on our German businesses. We don't have an issue on our French businesses.

#

Is it the default behavior ? Did you update anything on that matter ? We haven't found any changes in our code for it to change this behavior.

astral bridge Mar 27, 2025, 2:07 PM

#

Are you using server driven requests or local reader control via SDK?

crimson solar Mar 27, 2025, 2:11 PM

#

We call an aws lambda to init our stripe terminal, create payment intent, etc....
we are using this library: "stripe": "^10.0.0"

#

in the front end we use '@stripe/terminal-js'; to collectPaymentMethod for example

#

using the client_secret and paymentIntentId we got from the back end

#

this is our Front end:
const { id: paymentIntentId, client_secret } = yield call(
invokeLambda,
'stripeTpe',
{
token,
businessId,
// needed for stripe customer creation (if no account yet)
countryCode,
type: 'stripeTpe.createPaymentIntent',
amount,
customer: customer && customer.toJS(),
tpeType
}
);
// collect payment method for the connected reader to wait for a card
const { paymentIntent: collectedPaymentIntent, error: errorCollect } =
yield terminal.collectPaymentMethod(client_secret, {
config_override: {
skip_tipping: skipTips
}
});

dapper sandBOT Mar 27, 2025, 2:16 PM

#

crimson solar Mar 27, 2025, 2:20 PM

#

So, any idea ?

quartz pivot Mar 27, 2025, 2:25 PM

#

👋 stepping in as synthrider had to step away

#

Catching up

#

Can you provide a PaymentIntent ID where you see tipping taking place?

crimson solar Mar 27, 2025, 2:29 PM

#

Why would you need that ?
Im not doing any payment. The terminal is suggesting tips when it should not. It used to work well until a month or so.

#

this part here is my concern:
https://docs.stripe.com/terminal/features/collecting-tips/on-reader#skip-tipping

Collect on-reader tips

#

but here is one i just did:
pi_3R7HVOE7ePEuIRmR0pITztWK

quartz pivot Mar 27, 2025, 2:34 PM

#

Can you reproduce this in test mode?

#

And can you complete a test payment where it shows tipping and provide that PaymentIntent ID?

#

I need to see where/why it might be getting set.

#

So that's why I need the object

crimson solar Mar 27, 2025, 2:39 PM

#

ok ill try that one moment

quartz pivot Mar 27, 2025, 2:40 PM

#

Thanks

crimson solar Mar 27, 2025, 2:41 PM

#

this is a test one, but i dont have the issue in test mode 😦
pi_3R7HbGE7ePEuIRmR1qDiqyOg

quartz pivot Mar 27, 2025, 2:41 PM

#

Hmm that's strange.

crimson solar Mar 27, 2025, 2:41 PM

#

on this one tho, i do have an issue, this is not a test mode, production
https://dashboard.stripe.com/events/evt_3R7HVOE7ePEuIRmR0Fv4lDKc

Stripe Login | Sign in to the Stripe Dashboard

Sign in to the Stripe Dashboard to manage business payments and operations in your account. Manage payments and refunds, respond to disputes and more.

quartz pivot Mar 27, 2025, 2:41 PM

#

Are you positive you are using the same code as prod?

crimson solar Mar 27, 2025, 2:42 PM

#

yes

quartz pivot Mar 27, 2025, 2:42 PM

#

That one you just shared from prod wasn't completed though

#

So I can't see anything about the client

crimson solar Mar 27, 2025, 2:42 PM

#

ok ill complete it then wait

#

pi_3R7HfkE7ePEuIRmR1H6lkG55

#

there this is a real payment

quartz pivot Mar 27, 2025, 2:45 PM

#

Thanks, looking.

#

While I'm looking, what version of the Terminal JS SDK are you using?

crimson solar Mar 27, 2025, 2:53 PM

#

"@stripe/react-stripe-js": "^2.8.0",
"@stripe/stripe-js": "^4.3.0",
"@stripe/terminal-js": "^0.10.1"

quartz pivot Mar 27, 2025, 2:53 PM

#

Thanks

#

Still looking for our relevant logs here and the server is busy so helping other folks as well. In the meantime, have you hardcoded your skipTips variable in your prod code and set it to true. Or have you added a log immediately before collectPaymentMethod to log that variable?

crimson solar Mar 27, 2025, 3:03 PM

#

Yeah i did both, didn't work, that why i contacted you

quartz pivot Mar 27, 2025, 3:03 PM

#

Gotcha thanks.

#

Alrighty well I know you stated that you checked this but our logs do show that you passed skipTipping: false for that example PaymentIntent.

#

So next step is going to be to do some more debugging on your side, especially since you can't reproduce this in test mode.

crimson solar Mar 27, 2025, 3:21 PM

#

ok let me see what i can do

#

German Business: { paymentIntentId: "pi_3R7II2E7ePEuIRmR1OG9vxvK", skipTips: false } => suggesting tips
French Business: { paymentIntentId: "pi_3R7IKdA69XfgDO9E1VbrCNIQ", skipTips: false }=> NOT suggesting tips

#

I didnt finish the payment, i have two readers next to each other, one is suggesting, the other is not

#

both have skipTips as false

#

this is production of course

#

and this is the code just in case:
console.log({ paymentIntentId, skipTips }); // collect payment method for the connected reader to wait for a card const { paymentIntent: collectedPaymentIntent, error: errorCollect } = yield terminal.collectPaymentMethod(client_secret, { config_override: { skip_tipping: skipTips } });

quartz pivot Mar 27, 2025, 3:32 PM

#

Just for 100% certainty can you log the client_secret instead of the PaymentIntent ID?

crimson solar Mar 27, 2025, 3:32 PM

#

yes

#

DE: { paymentIntentId: "pi_3R7IR9E7ePEuIRmR01zXUpFH", skipTips: false, client_secret: "pi_3R7IR9E7ePEuIRmR01zXUpFH_secret_JmyajbkdZR1LoXEsWyhqGq2mD", countryCode: "DE" }
FR: { paymentIntentId: "pi_3R7IRkA69XfgDO9E1lqcCyIt", skipTips: false, client_secret: "pi_3R7IRkA69XfgDO9E1lqcCyIt_secret_Z3C6qGQ1cbfHB5a4OqVv8b2ih", countryCode: "FR" }

quartz pivot Mar 27, 2025, 3:45 PM

#

Alright I'm asking a colleague if they have any further ideas here. I'm stumped...

crimson solar Mar 27, 2025, 3:45 PM

#

Thanks !

dapper sandBOT Mar 27, 2025, 3:46 PM

#

crimson solar Mar 27, 2025, 3:47 PM

#

We were stumped too here at planity 😂

brittle scroll Mar 27, 2025, 3:50 PM

#

Hello 👋
Jumping in to help out here

Are the readers registered to different location?
Can you share the location IDs? tml_xxx

crimson solar Mar 27, 2025, 3:51 PM

#

the readers ? like the terminal ?

brittle scroll Mar 27, 2025, 3:51 PM

#

Yes

crimson solar Mar 27, 2025, 3:51 PM

#

well i can interchange them, still have the issue

brittle scroll Mar 27, 2025, 3:52 PM

#

Right but can you share the location IDs? Just want to check if the configuration is overriding the parameters you're passing in or not

crimson solar Mar 27, 2025, 3:52 PM

#

the business i'm using now is my test business in production. WE are in france. The issue is from a business in Germany

#

ok hold on

#

locationId: "tml_FD6PwE0BJ1IGyw", countryCode: "DE"
locationId: "tml_FVvzAn1DGusYlF", countryCode: "FR"

#

there

#

country code is the business country code 💪

brittle scroll Mar 27, 2025, 3:56 PM

#

And it works fine in FR meaning the issue is with tml_FD6PwE0BJ1IGyw

#

?

#

Any reader registered to tml_FD6PwE0BJ1IGyw shows tipping screen even when you pass skipTipping ?

crimson solar Mar 27, 2025, 3:58 PM

#

Sorry i may have confused your colleague earlier on that point, if i pass skipTipping to true, it doesnt suggest tips anymore to any reader

#

but, as you can see earlier, i have both skipTipping to false, one is suggesting (DE) and the other is not (FR)

#

and yes it works fine in FR

brittle scroll Mar 27, 2025, 4:02 PM

#

And to be clear, you're saying "one is suggesting" - you mean DE reader shows tipping automatically and FR does not (which is expected given your terminal configuration doesn't have any tipping specific config)

crimson solar Mar 27, 2025, 4:03 PM

#

YES

#

My colleague suggested i send you this too:

async function main() {
const configuration = await stripe.terminal.configurations.retrieve(
'tmc_61SGLXq0BYdjGLSG041E7ePEuIRmR8Ce'
);
console.log(configuration);
const location = await stripe.terminal.locations.retrieve(
'tml_FD6PwE0BJ1IGyw'
)
console.log(location);
}

{
id: 'tmc_61SGLXq0BYdjGLSG041E7ePEuIRmR8Ce',
object: 'terminal.configuration',
bbpos_wisepos_e: { splashscreen: 'file_1R6xaSE7ePEuIRmRIie53EZO' },
is_account_default: false,
livemode: true,
name: ''
}
{
id: 'tml_FD6PwE0BJ1IGyw',
object: 'terminal.location',
address: {
city: 'Berlin',
country: 'DE',
line1: 'Hauptstraße 1',
line2: '',
postal_code: '10827',
state: ''
},
configuration_overrides: 'tmc_61SGLXq0BYdjGLSG041E7ePEuIRmR8Ce',
display_name: 'Planity Berlin',
livemode: true,
metadata: { businessId: '-MxiDG_b7xEivhzHVwhO' }
}

brittle scroll Mar 27, 2025, 4:05 PM

#

Can you try listing your account's default configuration? https://docs.stripe.com/api/terminal/configuration/list#list_configuration-is_account_default

Does that have tipping options defined? and if so, does that match what you're seeing on the reader?

crimson solar Mar 27, 2025, 4:11 PM

#

CONFIG FOR DE STRIPE
{
"object": "list",
"data": [
{
"id": "tmc_61SGbepmqHKfKwdKf41E7ePEuIRmRMu0",
"object": "terminal.configuration",
"bbpos_wisepos_e": {
"splashscreen": "file_1R7DhQE7ePEuIRmRp0suKGSo"
},
"is_account_default": false,
"livemode": true,
"name": "",
"tipping": {
"eur": {
"fixed_amounts": [
100,
200,
500
]
}
}
},
{
"id": "tmc_61SGbVy7nStyCzigZ41E7ePEuIRmRDiC",
"object": "terminal.configuration",
"bbpos_wisepos_e": {
"splashscreen": "file_1R7DYaE7ePEuIRmRzQBZCX2u"
},
"is_account_default": false,
"livemode": true,
"name": "",
"tipping": {
"eur": {
"fixed_amounts": [
100,
200,
500
]
}
}
},
{
"id": "tmc_61SGMvkNys3EuY7pX41E7ePEuIRmRUdU",
"object": "terminal.configuration",
"bbpos_wisepos_e": {
"splashscreen": "file_1R6yyME7ePEuIRmR0Acw8emm"
},
"is_account_default": false,
"livemode": true,
"name": ""
}
],
"has_more": true,
"url": "/v1/terminal/configurations"
}

brittle scroll Mar 27, 2025, 4:11 PM

#

can you set is_account_default to true ?

#

when you make the API request

crimson solar Mar 27, 2025, 4:12 PM

#

ok

#

{
"object": "list",
"data": [
{
"id": "tmc_E3RgngJt1eJ8fJ",
"object": "terminal.configuration",
"is_account_default": true,
"livemode": true,
"name": "DEFAULT",
"tipping": {
"eur": {
"percentages": [
10,
12,
15
]
}
}
}
],
"has_more": false,
"url": "/v1/terminal/configurations"
}

brittle scroll Mar 27, 2025, 4:15 PM

#

does that match the tipping screen you're seeing on the reader?

crimson solar Mar 27, 2025, 4:17 PM

#

yes

#

the config default for FR is different :
CONFIG FOR FR STRIPE
{
"object": "list",
"data": [
{
"id": "uc_cb7c5501-0680-4c42-b9d9-e55bd17f69fb",
"object": "terminal.configuration",
"is_account_default": true,
"livemode": true,
"name": "DEFAULT"
}
],
"has_more": false,
"url": "/v1/terminal/configurations"
}

#

this is the reason ?

brittle scroll Mar 27, 2025, 4:18 PM

#

I see. Looks like for some reason your DE location's configuration is getting overridden by your account's default config.

crimson solar Mar 27, 2025, 4:18 PM

#

some reason

#

ok

#

so how can i fix this ?

brittle scroll Mar 27, 2025, 4:20 PM

#

Try this -

1/ Create a new configuration without tipping stuff
https://docs.stripe.com/api/terminal/configuration/create

2/ Update the DE location's configuration_overrides with the newly created configuration
https://docs.stripe.com/api/terminal/locations/update

3/ Delete & Re-register the reader to DE location
(you can do that via the dashboard)

In the meantime, I'll try to dig into what's going on with configurations here

crimson solar Mar 27, 2025, 4:20 PM

#

Thank you so much, i'll try that

#

Do you have info on when was the default configuration changed, updated, created, recreated or something like that : tmc_E3RgngJt1eJ8fJ
We are confused about this. 🤯

brittle scroll Mar 27, 2025, 4:33 PM

#

Based on our internal logs - it was created on 2022-11-18 14:56:34 UTC and was recently updated 2025-03-18 11:25:51 UTC

We likely don't keep any other logs so can't share more

crimson solar Mar 27, 2025, 4:34 PM

#

Thats already a lot of help !

#

Thank you

brittle scroll Mar 27, 2025, 4:37 PM

#

NP! are you seeing tipping screen with a new configuration?

crimson solar Mar 27, 2025, 4:37 PM

#

We didn't do the steps above yet, we will do them soon or tomorrow

#

or you did something from your side ?

#

and also, is there an interface on stripe to change the default configuration ?

brittle scroll Mar 27, 2025, 4:39 PM

#

I've flagged it internally to our Terminal team just to make sure nothing is broken..

and also, is there an interface on stripe to change the default configuration ?
Hmm I don't believe you can change this via the API but let me see if there's anything on the dashboard

crimson solar Mar 27, 2025, 4:40 PM

#

no i mean via the dashboard

#

ok i found it

brittle scroll Mar 27, 2025, 4:41 PM

#

https://dashboard.stripe.com/test/terminal/locations

#

yup

crimson solar Mar 27, 2025, 4:41 PM

#

Thank you 🙏

brittle scroll Mar 27, 2025, 4:41 PM

#

NP! Happy to help.. Sorry for the trouble.

crimson solar Mar 27, 2025, 4:45 PM

#

Not sure the trouble came from your side, we can't seem to know as you said earlier who touched this on 2025-03-18 11:25:51 UTC

#

But yes thank you so much

#bassem-planity_terminal-tipping-config