---
updatedAt: 2026-01-17T00:58:11.000Z
agentTools:
  projectIndex: https://docs.astra.finance/llms.txt
---

# Trusted Authentication

## Overview

Authentication is the process of verifying the phone number associated with that User profile through an SMS code. This is how Astra Authenticates Users before they Authorize your Client. Any action by the User in Astra’s SDK requires an active, non-expired Authentication.

> 📘 Re-Authentication is required when the User changes their phone number or is using Astra on a new device

Trusted Authentication is a joint solution developed by Astra for trusted Clients that enables access to Astra for all Users who have successfully completed mobile 2FA with a Client, providing a more streamlined onboarding experience. If a User has Authenticated with your Client in the last 30 days, Astra will “trust” this Authentication and allow the User to bypass the Authentication step prior to providing an Authorization for your Client.

<Image align="center" alt="Astra's Authentication Service" border={false} caption="Astra's Authentication Service" src="https://files.readme.io/6788157c4a29778d8e9a6afd12833be8eae89dd240f7207588926d307cdb0cc2-Astra_Authentication.png" />

## Approval

Trusted Authentication requires a level of trust between your company and Astra. In order to ensure a high level of security for all parties, Astra requires all trusted Clients to fill out an Authentication security questionnaire.

1. Do you use phone number / mobile 2FA to authenticate your Users? If not, please share how.
2. What service do you use for mobile 2FA authentication?
3. When do you Authenticate Users? ex: During onboarding? When a phone number changes? When they add or change sensitive information?
4. When do you Re-authenticate Users?
5. How long does an authenticated User's session last? ex: 15 minutes, 24 hours, 1 week, 30 days

<br />

## Trusted Authentication Flow

### Step 1: Generating a Partner Identity Verification Token

The first step in Authenticating a User is generating a short-lived (1 minute), one-time-use Partner Identity Verification Token. In order to generate a token (session token) provide one of the following in the request payload: `user_id`, `user_intent_id`, or `business_profile_id`.  Supply the `user_intent_id` or `business_profile_id` during initial onboarding, and provide the `user_id` for all requests moving forward post-onboarding.

<br />

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

Payload (one of user_id, user_intent_id, or business_profile_id)
{   
  "user_id": "user_123456",  
  "user_intent_id": "user_intent_123456",
  "business_profile_id": "busines_profile_123456"  
}  

Astra Response  
{  
"token": "token_123456"  
}
```

> 📘 Only provide one of `user_id`, `user_intent_id`, or `business_profile_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)

> 📘 Provide a `business_profile_id` if you are signing up a business user (Authorizing)

> 📘 The `token` value can be used in the Astra SDK (both for authorizing or adding a card) to bypass the phone OTP.  See Step 2 below for an example.

### Step 2: Authenticating a User

Once your Client has a Partner Identity Verification Token, the User should be directed to the Astra Web SDK with the following query string parameters.

> 📘 The `token` value from the API response from Step 1 can be used in the Astra SDK (both for authorizing or adding a card) to bypass the phone OTP.

| Parameter             | Required | Description                                                                          |
| :-------------------- | :------- | :----------------------------------------------------------------------------------- |
| session\_token        | required | the Partner Identity Verification Token string (the `token` value from Step 1 above) |
| user\_intent\_id      | required | required when initially onboarding a personal user                                   |
| business\_profile\_id | required | required when initially onboarding a business user.                                  |
| client\_id            | required | your Developer Client ID.                                                            |
| user\_id              | optional | user\_id used in the initial token creation request.                                 |

#### Example with Query Strings

* <https://app.astra.finance/login/oauth/authorize?session_token=token_123456&client_id=client_123456&user_id=user_123456&redirect_uri=https://redirect.com/&response_type=code>
* <https://app.astra.finance/login/oauth/authorize?session_token=token_123456&client_id=client_123456&user_intent_id=user_intent_123456&redirect_uri=https://redirect.com/&response_type=code>
* <https://app.astra.finance/login/oauth/authorize?session_token=token_123456&client_id=client_123456&business_profile_id=business_profile_123456&redirect_uri=https://redirect.com/&response_type=code>
* <https://app.astra.finance/cards/connect?session_token=token_123456&client_id=client_123456&user_id=user_123456&redirect_uri=https://redirect.com/>