Onboarding Receive-Only Users

Last updated: October 13, 2026

Overview

The following guide outlines steps for onboarding receive-only Personal Users. Personal Users who are designated with a KYC type as receive-only are not required to Authenticate or Authorize with Astra.

Personal vs. Business User

There are two categories of Astra Users: Personal Users and Business Users. A Personal User does not represent a Business, and vice versa.

LLCs, Sole Proprietorships, S-Corps, C-Corps, etc all constitute Businesses.

📘 For compliance reasons, a Business must register with Astra as a Business User. Onboarding a Business User as a Personal User can result in both User suspension and additional consequences for your integration with Astra. In addition, Personal Users will be blocked from connecting Business Debit Cards to their profile.

Step 01: Create a UserIntent

Through Astra’s UserIntent object, your application owns the scope of designing the frontend and user experience for collecting the required information for onboarding Users accordingly. The outcome of creating a UserIntent will be a user_intent_id.

For Clients who are approved for KYC Delegation, and/or are approved to onboard Personal Users with a kyc_type as receive-only or unverified, limited information is required to onboard the User to our platform. Below is an outline of the required information that needs to be collected by way of the UserIntent objects for Users who are KYC Delegated and Receive-Only or Unverified:

📘 For KYC Delegated programs, please specify the kyc_type as verified. For programs approved to onboard Users as unverified or receive-only please specify the kyc_type accordingly.

Required Receive-Only Information

Receive-Only Personal Information (via UserIntent)

  • Email

  • Phone

  • First Name

  • Last Name

  • Physical Address

  • IP Address

Step 02: Obtain a Session Token

Once a UserIntent has been created (and the UserIntent status has transitioned to approved, see the related webhook for status changes), call Astra’s partner/identity/verification endpoint with the following Payload:

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",  
"user_id": "user_123456",  // provide moving forward after successful onboarding
"user_intent_id": "user_intent_123456",  
}

Astra Response  
{  
"token": "token_123456"  
}

📘 Only provide one of user_id or user_intent_id,

📘 Provide a user_intent_id if you are signing up the User for Astra’s services (Authorizing)

📘 Provide a user_id if you are signing them in (Authenticating)

Step 03: Authorize the User

Once you’ve obtained a session_token, call Astra’s partner/identity/token endpoint. This will return the User's tokens (an access_token and refresh_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”  
}