# Astra Documentation

> Documentation for Astra

## Guides: Guides
- [Getting Started](https://docs.astra.finance/docs/getting-started.md): This guide will walk you through the steps to make your first requests to the sandbox API. Calling endpoints in production will follow a similar process but use different URLs.

## Guides: Onboarding
- [Personal Users + Trusted Auth](https://docs.astra.finance/docs/personal-users-trusted-auth.md): For enterprise clients onboarding personal users with the most flexibility.
- [Cross Border Program Details](https://docs.astra.finance/docs/cross-border-program-details.md)

## Guides: Authentication & Authorization
- [Trusted Authentication](https://docs.astra.finance/docs/trusted-authentication.md)
- [API Only Authorization](https://docs.astra.finance/docs/api-only-authorization.md)

## Guides: INTEGRATION MANAGEMENT
- [Guide to Astra's SDK](https://docs.astra.finance/docs/guide-to-astras-sdk.md): A [UserIntent](ref:post_v1-user-intent) manages the lifecycle of the creation of a User, before that User has been fully created. A [User](ref:get_v1-user) is created when an end-user authenticates…
- [Testing in the Sandbox Environment](https://docs.astra.finance/docs/testing-in-the-sandbox-environment.md): This guide demonstrates how to create Accounts and Users / UserIntents with specific states so that you can test a wide range of scenarios that an end-user may encounter.

## Guides: Payment Solutions
- [Card to Account](https://docs.astra.finance/docs/card-to-account.md): Card to Account Transfers
- [Instant Disbursements | Gross Debit Mode](https://docs.astra.finance/docs/instant-disbursements-gross-debit-mode.md): Account-to-Card Payment Solution with built in ACH Debit Origination
- [Instant Disbursements | Net Debit Mode](https://docs.astra.finance/docs/instant-disbursements-net-debit-mode.md): Account-to-Card Payment Solution with built in ACH Debit Origination
- [Real-Time & ACH Same Day Transfers](https://docs.astra.finance/docs/real-time-ach-same-day-transfers.md)
- [Cross Border Payments](https://docs.astra.finance/docs/cross-border-payments.md)

## Guides: User Management
- [Managing the Authorization Lifecycle](https://docs.astra.finance/docs/managing-authorization-lifecycle.md): The following guide presents information on the end-user authorization lifecycle and best practices for how to manage that authorization over time.
- [Onboarding Personal Users](https://docs.astra.finance/docs/onboarding-personal-users.md)
- [Onboarding Business Users](https://docs.astra.finance/docs/onboarding-business-users.md)
- [Onboarding Receive-Only Users](https://docs.astra.finance/docs/guide-to-onboarding-receive-only-users.md)

## API Reference: Astra Developer API
- [Introduction](https://docs.astra.finance/reference/introduction.md)
- [Security](https://docs.astra.finance/reference/security.md)
- [Usage Limits](https://docs.astra.finance/reference/usage-limits.md)
- [Pagination](https://docs.astra.finance/reference/pagination.md)
- [Custom Metadata](https://docs.astra.finance/reference/custom-metadata.md): Custom metadata can be supplied for specific resources for your own use or reference.
- [Authorization](https://docs.astra.finance/reference/authorization.md)
  - [Authorize a User](https://docs.astra.finance/reference/post_v1-oauth-token.md): > 📘 > > You can place your application's `client_id` into the `username` field, and your `client_secret` into the `password` form field of the Authentication section of this documentation 👉.  Use…
  - [OAuth Links and Parameters](https://docs.astra.finance/reference/oauth-links-and-parameters.md)
  - [Astra Web App SDK](https://docs.astra.finance/reference/astra-web-app-sdk.md)
  - [Generate a Partner Identity Verification Token](https://docs.astra.finance/reference/post_v1-partner-identity-verification.md): > 📘 > > You can place your application's `client_id` into the `username` field, and your `client_secret` into the `password` form field of the Authentication section of this documentation 👉.  This…
  - [Authorize a User via API](https://docs.astra.finance/reference/post_v1-partner-identity-token.md): > 📘 > > You can place your application's `client_id` into the `username` field, and your `client_secret` into the `password` form field of the Authentication section of this documentation 👉.  Using…
- [User](https://docs.astra.finance/reference/user.md)
  - [Get a User Profile](https://docs.astra.finance/reference/get_v1-user.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  This endpoint retrieves the profile information for the User whose…
  - [Get a User Intent](https://docs.astra.finance/reference/get_v1-user-intent-id.md): > 📘 > > You can place your application's `client_id` into the `username` field, and your `client_secret` into the `password` form field of the Authentication section of this documentation 👉.  A User…
  - [Create a User Intent](https://docs.astra.finance/reference/post_v1-user-intent.md): > 📘 > > You can place your application's `client_id` into the `username` field, and your `client_secret` into the `password` form field of the Authentication section of this documentation 👉.  A User…
  - [User Statuses](https://docs.astra.finance/reference/user-statuses.md)
  - [Upgrade the kyc_type for a User](https://docs.astra.finance/reference/post_v1-upgrade-kyc-type.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  > ❗️ > > This resource is only available to eligible programs. Please…
  - [Get a Business Profile](https://docs.astra.finance/reference/get_v1-business-profile-business-profile-id.md): > 📘 > > You can place your application's `client_id` into the `username` field, and your `client_secret` into the `password` form field of the Authentication section of this documentation 👉.  This…
  - [Create a Business Profile for a business user](https://docs.astra.finance/reference/post_v1-business-profile.md): > 📘 > > You can place your application's `client_id` into the `username` field, and your `client_secret` into the `password` form field of the Authentication section of this documentation 👉.  This…
  - [List Capabilities for a User](https://docs.astra.finance/reference/get_v1-users-id-capabilities.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  This endpoint returns the current capabilities of a User.
  - [Request User Phone Number Update](https://docs.astra.finance/reference/post_v1-request-user-phone-number-update.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  This endpoint gives Astra's customers the ability to submit a phone…
  - [Get User Phone Number Change Requests](https://docs.astra.finance/reference/get_v1-phone-number-change-requests.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  This endpoint gives Astra's customers the ability to retrieve phone…
  - [Request User Address Change](https://docs.astra.finance/reference/post_v1-request-address-change.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  > 🚧 > > Note: Do not pass empty strings or null values for properties.…
  - [Update User Email](https://docs.astra.finance/reference/patch_v1-users-user-id.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  > 🚧 > > Note that a `user_updated`…
- [Accounts](https://docs.astra.finance/reference/accounts.md)
  - [List Accounts for a User](https://docs.astra.finance/reference/get_v1-accounts.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  Retrieve all Accounts for a User.  > 📘 > > This resource returns…
  - [Get a Specific Account for a User](https://docs.astra.finance/reference/get_v1-accounts-id.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  This endpoint retrieves a specific Account for a User based on the…
  - [Delete a Specific Account for a User](https://docs.astra.finance/reference/delete_v1-accounts-id.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  This endpoint deletes a specific account for a User based on the account…
  - [Create Account by Account and Routing](https://docs.astra.finance/reference/post_v1-accounts-create.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  This endpoint will create an Account for a User based on an account and…
  - [Create Account by Plaid Processor Token](https://docs.astra.finance/reference/post_v1-accounts-processor-token.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  Astra and Plaid have partnered to enable you to use your existing Plaid…
- [Cards](https://docs.astra.finance/reference/cards.md)
  - [Get Card BIN Information](https://docs.astra.finance/reference/get_v1-bins-bin.md): > 📘 > > You can place your application's `client_id` into the `username` field, and your `client_secret` into the `password` form field of the Authentication section of this documentation 👉.  > 🚧 > >…
  - [List Cards for a User](https://docs.astra.finance/reference/get_v1-cards.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  Retrieve all Debit Cards for a user.  > 📘 > > This resource returns…
  - [Create a Card for a User](https://docs.astra.finance/reference/post_v1-cards.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  Cards can be created directly through the API using this PCI-compliant…
  - [Get a Card by an ID](https://docs.astra.finance/reference/get_v1-cards-id.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  This endpoint retrieves a specific Debit Card for a User based on the…
  - [Card Statuses and Review Reasons](https://docs.astra.finance/reference/card-review-statuses.md)
  - [Delete a Card](https://docs.astra.finance/reference/delete_v1-cards-id.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  This endpoint deletes a debit card by way of a card's unique ID. If the…
  - [Get Smart Card Authorization by Card ID](https://docs.astra.finance/reference/get_v1-cards-id-auth-details.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  This endpoint returns card authorization risk assessment and…
  - [Approve a Card by an ID](https://docs.astra.finance/reference/post_v1-cards-id-approve.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  This endpoint gives eligible clients the ability to approve a flagged…
  - [Reject a Card by an ID](https://docs.astra.finance/reference/post_v1-cards-id-reject.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  This endpoint gives eligible clients the ability to reject a flagged Card…
- [Routines](https://docs.astra.finance/reference/routines.md)
  - [Routine Preview](https://docs.astra.finance/reference/post_v1-routines-preview.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  This endpoint returns a fee structure payload as a response, which…
  - [Create an account to card routine](https://docs.astra.finance/reference/post_v1-routines-account-to-card.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  Create an account to card routine (aka `instant disbursement`)  > 🚧 > >…
  - [Create a card to account routine](https://docs.astra.finance/reference/post_v1-routines-card-to-account.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  Create a card to account routine (funding from card)  > 🚧 > > This…
  - [List Routines for a User](https://docs.astra.finance/reference/get_v1-routines.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  Retrieve all Routines for a User.  > 📘 > > This resource returns…
  - [Create a new Routine](https://docs.astra.finance/reference/post_v1-routines.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  > 📘 > > Use this Routine resource to request Card-to-Card and…
  - [Get a Specific Routine for a User](https://docs.astra.finance/reference/get_v1-routines-id.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  This endpoint retrieves a specific Routine for a User based on the…
  - [Routine Statuses](https://docs.astra.finance/reference/routine-statuses.md)
  - [Update an Existing Routine](https://docs.astra.finance/reference/put_v1-routines-id.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  This endpoint updates an existing Routine for a User.  > 🚧 > > Routine…
  - [Delete a Routine for a User](https://docs.astra.finance/reference/delete_v1-routines-id.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  This endpoint removes a specific Routine for a User based on the Routine…
  - [List Transfers for a Routine](https://docs.astra.finance/reference/get_v1-routines-id-transfers.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  Retrieve all Transfers for a Routine.  > 📘 > > This resource returns…
  - [Create a book transfer routine](https://docs.astra.finance/reference/post_v1-routines-book.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  Create a new book transfer routine (a book transfer between two Payment…
- [Transfers](https://docs.astra.finance/reference/transfers.md)
  - [List Transfers for a User](https://docs.astra.finance/reference/get_v1-transfers.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  Retrieve all Transfers for a User.  > 📘 > > This resource returns…
  - [Get a Specific Transfer for a User](https://docs.astra.finance/reference/get_v1-transfers-id.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  This endpoint retrieves a specific Transfer for a User based on the…
  - [Get Details on the Segments of a Transfer](https://docs.astra.finance/reference/get_v1-transfers-id-segments.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  Retrieve Transfer Segment data for a specific Transfer.  Segments reveal…
  - [Get a Specific Batch Transfer](https://docs.astra.finance/reference/get_v1-batch-transfers-id.md): > 📘 > > You can place your application's `client_id` into the `username` field, and your `client_secret` into the `password` form field of the Authentication section of this documentation 👉.…
  - [Cancel Transfer](https://docs.astra.finance/reference/post_v1-transfers-id-cancel.md): > 📘 > > You can place the bearer `access_token` for a specific user into the Authentication section of this documentation 👉.  Cancel a transfer for a user. To cancel a transfer, you must provide the…
- Payment Instruments
  - [List Payment Instruments for a Client](https://docs.astra.finance/reference/get_v1-payment-instruments.md): > 📘 > > You can place your application's `client_id` into the `username` field, and your `client_secret` into the `password` form field of the Authentication section of this documentation 👉.  > 🚧 > >…
  - [Get Payment Instrument by an ID](https://docs.astra.finance/reference/get_v1-payment-instruments-id.md): > 📘 > > You can place your application's `client_id` into the `username` field, and your `client_secret` into the `password` form field of the Authentication section of this documentation 👉.  > 🚧 > >…
- Chargebacks
  - [Get a User's Chargebacks](https://docs.astra.finance/reference/get_v1-chargebacks-user.md): > 📘 > > You can place your application's `client_id` into the `username` field, and your `client_secret` into the `password` form field of the Authentication section of this documentation 👉.…
  - [Get a Specific Chargeback](https://docs.astra.finance/reference/get_v1-chargebacks-chargeback-id.md): > 📘 > > You can place your application's `client_id` into the `username` field, and your `client_secret` into the `password` form field of the Authentication section of this documentation 👉.…
  - [Submit a Chargeback Response](https://docs.astra.finance/reference/post_v1-chargebacks-chargeback-id-submit.md): > 📘 > > You can place your application's `client_id` into the `username` field, and your `client_secret` into the `password` form field of the Authentication section of this documentation 👉.  Submit…
- Instant Payment Eligibility
  - [Get Account Routing Number Instant Payment Eligibility](https://docs.astra.finance/reference/get_v1-instant-payment-eligibility.md): > 📘 > > You can place your application's `client_id` into the `username` field, and your `client_secret` into the `password` form field of the Authentication section of this documentation 👉.  Use…
- [Errors](https://docs.astra.finance/reference/errors.md)
- [Common Errors Responses](https://docs.astra.finance/reference/common-errors-responses.md)
- [Webhooks](https://docs.astra.finance/reference/webhooks.md)
  - [Webhook Verification](https://docs.astra.finance/reference/webhook-verification.md)
  - [User Webhooks](https://docs.astra.finance/reference/user-webhooks.md)
  - [Routine Webhooks](https://docs.astra.finance/reference/routine-webhooks.md)
  - [Transfer Webhooks](https://docs.astra.finance/reference/transfer-webhooks.md)
  - [Batch Transfer Webhooks](https://docs.astra.finance/reference/batch-webhooks.md)
  - [Chargeback Webhooks](https://docs.astra.finance/reference/chargeback-webhooks.md)
  - [Card Webhooks](https://docs.astra.finance/reference/card-webhooks.md)
  - [Payment Instrument Webhooks](https://docs.astra.finance/reference/payment-instrument-webhooks.md)