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”
}