#ohdeedeeoh

1 messages · Page 1 of 1 (latest)

sturdy falconBOT
#

Hello! We'll be with you shortly. Below are links to other discussions we've had with you in the past week in case you want to review that information. If your question is related to one of these previous discussions, please provide a comprehensive summary of the current state and what you need help with now. We help many users simultaneously, so a summary allows us to resolve your issue as soon as possible.

silver heath
#

Hi 👋 that's a bit tricky to answer since Balance Transactions represent any change to a Stripe balance, not just from a payment, so they won't always relate to a payment being made.

Our API reference explains that net is equivalent to amount - fee:
https://stripe.com/docs/api/balance_transactions/object#balance_transaction_object-net
Is that not what you're seeing when you look at those objects?

Stripe API reference – The balance transaction object – 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.

shrewd vigil
#

So, I want to use invoice.paid event to do intant transfers to creators after a customer checkout a one time or subscription session.
Is the net from balance transaction from latest_charge from invoice is the amount I want to split between creators and platform?

Could you help me answer with transaction with just payment?
Is net = checkout_total - tax - discount - fee

#

In terms of just payment, tax, discount, stripe fee invovled in a stipe balance
Is net = checkout_total - tax - discount - fee
Or river from stripe says net = (final amount collected after tax and discount) - (stripe fee).
How does those two differ?

silver heath
#

No, net is amount-fee.

shrewd vigil
#

I really want to know which one to use for instant transfers, right now I'm using net, which seems fine with positvie number, so I want to ask here confirm for edge cases, where I'm not aware of now

silver heath
#

I'm not aware of any scenario where the Balance Transaction created from a payment is negative.

shrewd vigil
# silver heath No, `net` is `amount`-`fee`.

a payment is negative.
A refund to customer with reverse flow from creators and platform split

No, net is amount-fee.
I am still not clear why this differs with my

net = checkout_total - tax - discount - fee
silver heath
#

I'm still not clear on what "difference" you're talking about. You keep saying net is equal to some formula that River, myself, and our API reference says is not correct. Do you have a specific example that you're looking at that you can share?

a payment is negative.
A refund to customer with reverse flow from creators and platform split
That isn't a payment. A refund won't generate an invoice.paid Event, so it won't trigger this flow based on the logic you've described so far.

shrewd vigil
#

I'm still not clear on what "difference" you're talking about.
As I said in the beginning
net = checkout_total - tax - discount - fee
And net is amount-fee.
What does those two differ?

silver heath
#

As I said in the beginning
net = checkout_total - tax - discount - fee
Where are you getting this from? It's not right.

shrewd vigil
#

That isn't a payment. A refund won't generate an invoice.paid Event, so it won't trigger this flow based on the logic you've described so far.
I'm just making an example, there're certain scenario can you tell me one of with negative, since the api doc has some negative examples, but doesn't tell me its use case

#

net = checkout_total - tax - discount - fee
Is my understanding from the api doc,
My question is could you list examples to prove my formula is wrong?
Or could you explain why it differs with net is amount-fee. ?
If you are confused, why you are saying no all the time?

silver heath
#

The API reference says that net is equal to amount-fee

Net impact to a Stripe balance (in cents). A positive value represents incrementing a Stripe balance, and a negative value decrementing a Stripe balance. You can calculate the net impact of a transaction on a balance by amount - fee
source: https://stripe.com/docs/api/balance_transactions/object#balance_transaction_object-net
Are you seeing something different there? I'm trying to track down where the misalignment is coming from, so if it came from our docs I can make sure those get updated accordingly.

Lots of Balance Transaction types can create reduce the amount of a Stripe balance, resulting in them having negative amounts. Payouts move funds from a Stripe balance to an external bank account, so those create Balance Transactions with a negative amount. So can Balance Transactions created from Refunds and Transfers.

Stripe API reference – The balance transaction object – 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.

shrewd vigil
#

Are you seeing something different there? I'm trying to track down where the misalignment is coming from, so if it came from our docs I can make sure those get updated accordingly.
So I guess my interpretation is correct, could we add an example to doc?

For example:
When a customer made a checkout session,
net = checkout_total - enforced_tax - applied_invoice_level_discount - stripe_fee

sturdy falconBOT
silver heath
#

No, your understanding is incorrect, and I'm trying to figure out where it came from to ensure our documentation isn't giving you the wrong impression.

The net field on a Balance Transaction is equal to amount - fee.

It's hard to comment on your formula, because it's referencing fields that don't directly correspond with fields on our objects, and I'm not sure what data you're using those abstractions to represent.
For instance, what is checkout_total?
Tax is not deducted from the amounts either. Stripe does not handle collecting and remitting taxes for you, the tax amount is still provided to you so you can remit those tax amounts to the proper taxing jurisidctions.

shrewd vigil
#

For instance, what is checkout_total?
I think I mentioned that, I want to use invoice.paid event to do intant transfers to creators after a customer checkout session with a one time or subscription payment order.
And hence my understanding of net inside balance transaction

net = checkout_total - enforced_tax - applied_invoice_level_discount - stripe_fee
silver heath
shrewd vigil
#

Does amount from amount - fee is total - tax - discount?

silver heath
#

How tax is included in that depends on the tax behavior being used.

#

For Checkout Sessions, amount on the Balance Transaction should align with amount_total on the Checkout Session.