#redtopia - Connect Transfers
1 messages · Page 1 of 1 (latest)
Hello! payouts_enabled lets you know if the account's balance can be paid out to an external account (their bank account). capabilities.transfers tells you if the account can accept transfers. These properties are all documented in the API reference here: https://stripe.com/docs/api/accounts/object
yes, I have read the docs
Would there ever be a case when transfers are active and payouts_enabled is false?
I think that can happen, yeah.
Under what circumstances? And would there ever be a case when payouts_enabled is true and transfers are inactive?
I don't know all the circumstances, there are likely too many to list, especially when you take into account operations that may be performed on a given account due to fraud, abuse, risk, etc. I recommend you don't think about specific cases like this and instead assume an account can be in any combination of states.
okay... this is why I'm reach out because the docs don't reference this. Basically, I need to know if I can transfer funds into an account for a future payout. There's no reason why I would ever transfer funds into an account without a future payout. It's not clear to me whether I should be testing to see if the account can accept a transfer, ie capabilities.transfers == "active" or if I should be testing if payouts_enabled == true
If you want to know if you can transfer funds to a connected account you should be looking at capabilities.transfers.
If you want to know if a connected account's balance can be paid out you should look at payouts_enabled.
Those are two separate things that tell you different things.
OK, that makes sense, but I also would need to know the difference so I can report this information back to the vendor on the platform. In other words, if transfers are not "active", then I would want to tell the vendor something different than if payouts_enabled is false... is there a doc that explains these conditions?
Not sure what you mean... we just talked about what those mean. Can you provide more details?
well, you indicated that there are too many edge cases to explain
That was in reference to how an account can get into any particular state.
basically, i need to tell the vendor what's going on... maybe they haven't completed the onboarding process and I need to guide them back to that. Or maybe there's a problem with their external account?
I'm wondering if I test only for the payouts_enabled flag, then all situations will be covered. In other words, assuming this flag is set to true, then transfers will also be set to true.
You can't assume that.
These are two independent properties that are not directly related to each other.
One is for transfers into the account from your platform. The other is for payouts from that account's balance into an external account.
If you want to report this information you need to report both separately and not try to roll them up into a single thing.
I understand. Given this assertion, I will need to be more granular in how I deal with these two conditions. When transfers are inactive, what does that mean? When payouts_enabled is false, what does that mean?
When transfers are inactive it means your platform cannot transfer money to that account.
When payouts are not enabled it means the balance on that account cannot be paid out to an external account.
but why
I realize you told me it's because of a lot of things, but I need to be more specific to my vendors... I don't know why, and neither do you... so what do I tell my vendor? Do I just tell them to go to their stripe account and fix it up?
There are many possible reasons why. You would need to look at the requirements to determine why: https://stripe.com/docs/api/accounts/object#account_object-requirements
ok... I guess I'll just check both properties and if I can't transfer or do a payout, I'll direct the end user to their Stripe Connect account and submit the required information.
thank you for your help
No problem!