Creating a Business User for your Business Entity

Last updated: November 21, 2025

Overview

The following guide outlines steps for creating a Business User for your program, from your Astra Oauth Client.

This guide is not for onboarding end-users who are Businesses / Merchants

This is guide is for creating a Business User for your Business Entity / Organization on our Platform.

This flow requires additional OAuth Client configuration updates by Astra.

Background

In order for Astra to create program-level FBO accounts and payment instruments for a client, the program must create a Business User for their organization. This Business User must be associated with the Business Profile created via the Astra Dashboard and this Business User must be approved.

This guide outlines how to onboard and create a Business User using the Business Profile ID from a client's Astra Dashboard.

Step 01: Create a Business Profile

Navigate to your Sandbox or Production Astra Dashboard accordingly. Navigate to the Settings menu and select Business Profile.

  • Sandbox: Please use fake / dummy data

  • Production: You must use your real business information as Astra uses this to conduct KYB on your Business. If inaccurate or missing data is submitted, Astra will request additional documentation. Until your program has been KYB verified, your Production Astra client will be restricted.

Once created, the Business Profile ID will be available at the top of the User Interface

Astra_BusinessProfileID.png

Step 02: Obtain a Session Token

Using the Business Profile ID from your Astra Dashboard, call Astra’s partner/identity/verification endpoint with the following Payload:

https://docs.astra.finance/reference/post_v1-partner-identity-verification

Client Request  
Endpoint: POST /v1/partner/identity/verification  
Headers: {  
	"Content-Type": "application/json",  
	"Accept": "application/json",  
	"Authorization": "Basic \*\*\*\*",  
}

{  
"provider": "",  
"provider_data": {  
	"customer_id": ""  
},

"client_id": "client_123456",  
"business_profile_id": "busines_profile_123456"  
"user_id": "user_id_123456"
}

Astra Response  
{  
"token": "token_123456"  
}

Only provide one of the following: business_profile_id or user_id 

Step 03: Authorize the User

Once you’ve obtained a session_token, call Astra’s partner/identity/token endpoint. This will return your Business User's tokens (an access_token and refresh_token)

https://docs.astra.finance/reference/post_v1-partner-identity-token

Client Request  

Endpoint: POST /v1/partner/identity/token  
Headers: {  
"Content-Type": "application/x-www-form-urlencoded",  
"Accept": "application/json",  
"Authorization": "Basic \*\*\*\*",  
}

{  
"token": "token_123456",  
"user_consent_captured": true,  
"expires_in": 300  
}

Astra Response  
{  
"access_token": "access_token_abc123",  
"expires_in": 7200  
"refresh_token": "refresh_token_abc123",  
"token_type": “Bearer”  
}