Stripe Connect API - How Do I Retrieve A Connected Account's Status?

Viewed 861

I am using Stripe Connect as a platform. On the Connected accounts page on the Stripe dashboard, there is a STATUS column.

enter image description here

How do I retrieve this information via the Connect API?

I am looking at the standard GET / retrieve endpoint for Connect accounts at https://stripe.com/docs/api/accounts/retrieve, but the response does not include an account status data point.

2 Answers

There's no status field on the account object. Those statuses are likely inferred by looking at whether an account has charges and payouts enabled.

I too faced this problem. I came to understand that we have to check it manually from our side. You can check the status by using below conditions:

Account account = Account.retrieve("ACC_ID");
if(account.getRequirements().getPastDue() != null || account.getRequirements().getCurrentlyDue() != null){
//RESTRICTED
}
else if(!account.getPayoutsEnabled() ){
//PENDING
}
else
//COMPLETED

You can also check whether transfer and card payment are active or not from Capabilities object.

Related