Ida

[topaz yew]

Hi there!

[vagrant haven]

👋 taking over for my colleague. Let me catch up.

[vagrant haven]

have you tried using https://stripe.com/docs/api/subscriptions/create#create_subscription-on_behalf_of ?

https://support.stripe.com/questions/sending-invoices-on-behalf-of-connected-accounts

The connected account’s information will be used for 'on_behalf_of' invoices created by the platform

[cedar hamlet]

Let me check

We do using the on_behalf_of property. The question is how can we show the connected account tax Id in the Invoice?

[cunning thicket]

as far as I know it should be if you use o_b_o. Do you have an example Invoice in_xxx I can look at where it doesn't do what you expect?

also you can just use https://stripe.com/docs/api/customers/create#create_customer-invoice_settings-custom_fields and set a custom field for the Invoices for a given customer, and put the connected account's tax ID in that too, as a bit of a workaround.

I got an error that the tax Id is not allowed,
please share the exact error message and API request ID req_xxx

[cedar hamlet]

An example:
file:///Users/idasivan/Downloads/Invoice-C08D0382-0011.pdf

in_1NBB4YKUVeVlk6JSdXf89V4s

I tried to get the invoice after the right after subscription is created, and edit its description or footer, and got and error: Finalized invoices can't be updated in this way

[cunning thicket]

yep

that's why you have to use things like the Customer level invoice_settings I mentioned earlier, so that the Invoice that is immediately created+finalized by the subscription creation inherits those values

ok so looking at your example it's on_behalf_of an Express account. Did you set https://stripe.com/docs/api/accounts/create?lang=php#create_account-company-tax_id on that account?

[cedar hamlet]

Let me check

[cunning thicket]

if not, try setting it and generating new invoices

[cedar hamlet]

How can I set the tax Id in the connected account using the stripe platform? I couldn't find it

[cunning thicket]

what do you mean by "using the stripe platform"?

[cedar hamlet]

sorry, dashboard

[cunning thicket]

I should also say upfront that it's quite possible this is just not possible, this part of Stripe is a bit underdeveloped since it is the intersection of Connect and Billing, and on_behalf_of for a long time did not work at all on Subscription until like last year, and then Express also complicates things as you can't view/update certain details of the accounts

[cunning thicket]

don't know, we answer API questions here really

I would say you could call https://stripe.com/docs/api/accounts/update#update_account-company-tax_id but it's marked as "custom-only" in the reference so you might get an error trying to do it for an Express account

it might work if you collect the Tax ID from the user yourself in your own onboarding and then pass it to the Create endpoint instead when creating the account. I don't think the Express account holder has a way to enter this themselves in their Express dashboard or hosted onboarding.

ultimately maybe it's just easier to use the custom fields approach I mentioned earlier, that is worth trying.

[cedar hamlet]

I will check both approaches. Thanks

and set a custom field for the Invoices for a given customer, and put the connected account's tax ID
Can this field can be changed when creating the subscription? We have few customers (end users), that can get a subscription to a few connected accounts, and the customer are not connected to a specific connected account

[cunning thicket]

unfortunately not, it's a customer level parameter

I do feel like setting the tax ID correctly on the Express account would just work and is the 'supported' means to get what you want

etting invoice.setAccountTaxIds with the connected account tax Id. I got an error that the tax Id is not allowed, so I guess this tax Id should be our tax Id and not the connected account tax Id
you never elaborated on this or shared the request ID req_xxx for the error that I asked for, by the way

but yeah the expected idea here is we put the tax ID of the settlement merchant(so the connected account when using on_behalf_of) on the Invoice.
It works well with Direct Charges using Standard accounts(the account owner enters their tax ID in their Stripe dashboard), it's just going to be more messy with Express unfortunately, but it does come down to that https://stripe.com/docs/api/accounts/create#create_account-company-tax_id field I believe.

[cedar hamlet]

My apologies, I missed your request.
I see in our code that we don't set the company-tax-id when we creating an account. I will try this approach, hopefully this solution will work like you suggested

[nimble tiger]

Hi! I'm taking over from my colleague. Please, give me a moment to catch up.

Please, let me know if you have any other questions.

[cedar hamlet]

I'm trying now to set the connected account tax id, and then I will check if it is shown in a subscription invoice. Can you please keep this thread open, so I will ping after doing it? Just in case I will have some questions

[nimble tiger]

I can keep the thread open for some time, but if I'm not there, please write your question with relevant context in the main channel and my colleagues will happily look into it.

[cedar hamlet]

Thanks

When trying to set the tax id for a connected account, I get the following error:
com.stripe.exception.PermissionException: This application does not have the required permissions for the parameter 'company' on account 'acct_1LD2VQQRW7VTYzbQ'.; code: oauth_not_supported; request-id: req_ubLknwvex3uz2A

What am I missing?

in the requestOption is set .setStripeAccount("acct_1LD2VQQRW7VTYzbQ")

[nimble tiger]

How are you connected to the account? With OAuth?

[cedar hamlet]

I'm using our token

I can retrieve the account, but cannot update it

'our token' I meant API key

in the request options

.setApiKey("xxxx")

[south badge]

You can update company tax id of an account only for Custom account. While the connected Account you are trying to update its tax is an Express account:
https://stripe.com/docs/api/accounts/update#update_account-company

[cedar hamlet]

So... back to my original question:
How can we show the connected account tax id in a subscription invoice?

Any field that can be edited while creating the subscription?
I got many suggestion in this thread that are are not applicable to Express connected account

[south badge]

When creating the Express Connected Account try setting the tax id:
https://stripe.com/docs/api/accounts/create?lang=php#create_account-company-tax_id

because once the account is created, you can't update the field later, for Express Accounts

[cedar hamlet]

As I understand it can be set only on creation?
This is not that helpful, as we have thousands of existing connected express account, and we cannot re-create them. We will consider doing it for new connected account.

So there is not solution for showing the connected express account tax id in subscription invoice, for an existing connected express account that don't have the tax id in set?\

Is there any invoice string field/metadata that can be set when creating an subscription and to be shown in its invoice for the connected express account? We could use such field/metadata to store the tax id.

[wicked breach]

Yes there are custom fields you can add to an invoice if needs, but typically this is customer-based:
https://stripe.com/docs/invoicing/customize#custom-fields

After account creation, express accounts can update their profile via the express dashboard