#zerozero00_docs
1 messages · Page 1 of 1 (latest)
👋 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/1377399340229988412
📝 Have more to share? Add more details, code, screenshots, videos, etc. below.
Do you an example transaction we can reference?
here is the payout id po_1RBPrmE7STJzWNjKtPt3bqSn
or this is one of transactions in the payout: txn_3R9f5AE7STJzWNjK1oTlXOXH
Hi there - stepping in for my colleague who had to step away
Apologies for the delay
So you're trying to understand the specific fees for tap to pay transactions, is that right?
Assuming yes - we don't know a great deal about fees in general in this channel - there are account-specific considerations depending on your pricing.
In general, if you want to understand fees at a transaction level, you likely want the Balance Activity reports you can find here: https://docs.stripe.com/reports/report-types/balance
yes, i actually understand there is specific fee. but i didnt see the event for this fee. I need to handle the fee in our system.
e.g. for refund, there is event type like "charge.refunded", and I wonder what the type is for such fee, so that I can add it to the webhook, and get notification when the fee is charged
I'm not certain that fees are exposed in a webhook event. The events for the transaction you supplied are out of retention at this point. Let me find a more recent example
for example, when I made a payment, there will be an event give the details about the payment, e.g. net amount, fee, and total amount and also many details. for mobile tap payment, there will be additional fee charge for auth service, do you mean there is no event for this fee, right?
the reason I am asking is, when we handle a payment, once the payment is made, there will be an event received, we will create a transaction record in our system. and when there is a payout, we will get balance history associated with this payout, then we will see which payment has been settled. for such fee, I dont get any event right now, but I can see the transaction from balance history. it will be better that i can receive the event that i can record the fee before the payout.
Hi hi! I’m going to be taking over for my colleague here. There most likely isn't an event specific to this; you'll likely need to pull that data either in a report or via Sigma, but let me dig a little more.
for sure. I can provide more details. e.g. here is an example of the fee with type "stripe_fee", and the object from balance hisotry is:
{
"id": "txn_1R5CO2E7STJzWNjKw8tTlH8G",
"object": "balance_transaction",
"amount": -10,
"available_on": 1742589710,
"created": 1742589710,
"currency": "gbp",
"description": "Terminal (2025-03-20): Tap on Mobile- Per Auth Fee",
"exchange_rate": null,
"fee": 0,
"fee_details": [],
"net": -10,
"reporting_category": "fee",
"source": null,
"status": "available",
"type": "stripe_fee"
}
it is okay that there is no such event, as i didnt find any document either on Stripe's API website. i will work on another approach to resolve my current issue if thats the case. just wanna get confirmed in case I missed the information.
There is no event specific to those, but that doesn't mean you can't get this information when receiving a different event, like the one for the payment itself, by retrieving it at that time. Does that make sense?
could you give an example? also, is it possible to know the relation between the stripe fee and payment?
What events are you currently listening for?
is it possible to know the relation between the stripe fee and payment
You want to be able to link the fee with the associated payment, ya?
I can see the Stripe fee, however in event, I didnt see anything about the fee.
Can you share the ID of that Event with me please?
there are a lot of events, I think the stripe fee is related to terminal.reader.action_succeeded
What events are you already listening for?
charge.refund.updated
charge.refunded
charge.dispute.created
charge.dispute.updated
charge.succeeded
payment_intent.payment_failed
terminal.reader.action_failed
terminal.reader.action_succeeded
checkout.session.async_payment_failed
checkout.session.async_payment_succeeded
checkout.session.completed
checkout.session.expired
account.application.deauthorized
payout.canceled
payout.created
payout.failed
payout.paid
payout.updated
yes, It would be better to link the fee with associated payment. otherwise it wont be accurate to display the details in our system
Which event are you looking at to specifically mean "this transaction is complete and we can fulfil the 'order'"?
There are a number of ways you can do what you're trying to do, and I believe they're covered there.
umm, but i didnt see anything about stripe fee.
also, my collegues made some tests, the fees only occurs in live environment. when she did in test environment, there is no stripe fee. thats why we didnt know we need to handle such fees
looks like the 0.1 is charged per auth fee. so i think i probably would not need any event, but create a record of 0.1 fee after the tap to pay is successful.
I'm trying to find the documentation I found previously that explains how to make the link you need.
If you listen to the terminal.reader.action_succeeded event, it will contain the most recent action of the reader, which will include the Payment Intent: https://docs.stripe.com/api/terminal/readers/object#terminal_reader_object-action-process_payment_intent-payment_intent
I will double check the terminal.reader.action_succeeded event. and see what is included in PI.
last question, does this tap to pay auth fee only collected in Live environment?
It's just the Payment Intent ID unless you request that it be expanded but that is the ID of the payment, so that should give you the link you need.
I would presume it only collects them in the live environment, since no actual money movement happens in test mode.