Onboarding

Onboarding a user requires several API calls that ultimately results in a user object and account object being created. Before the account can used on the platform, the user and account must undergo a review process. We have tried to automate as much of this process as we can, but manual review is often needed. American Estate and Trust performs several checks to users in order to fully comply with all applicable regulation before allowing them onto the platform.

In order to onboard a user and create their account, use the following API calls:

1. Create a user - NOTE: default account type created is a "trust account" (see below). Specify account_type to create different types of accounts.
2. Upload necessary documents for a customer - see doc_type for more information on what are the acceptable documents for onboarding.
3. Update the user to update the necessary information - NOTE: default payment source is From Account meaning fees will be taken from the cash in the account as opposed to a credit card. Please update payment_source after user creation if needed.
4. Accept terms for a customer - this will accept terms for both the user and account objects.
5. Submit the user for review

User and Account Reviews

In order to get notified about the status of a user or account review, you can subscribe to a webhook that will update you when the status of a review changes.

Alternatively, to see whether the user has been approved, use the get user endpoint and look at the onboarding_status.

See the docs for the available values for onboarding_status. When a user has been approved, the onboarding status changes to Complete.

Onboarding Statuses

• In Process - The user has not been submitted for review.
• Review - The client's registration is being reviewed by our team.
• Complete - The client's registration is complete. No further action is needed at this time.
• Rejected - The client's registration has been rejected. Review the reason for rejection and take the necessary action.

Account Statuses

The account review is the second step of the sign-up process where AET performs the necessary checks including AML/KYC. This review ensures that the client's information is accurate and in compliance with regulations.

Possible Statuses:

• Draft - The client's account is in the draft stage. The review process hasn't started yet.
• In Process - The client's account review is in progress. Our team is currently checking for AML/KYC compliance.
• On Hold For Review - The client's account review is on hold for internal review. Further checks are needed before the review process can be completed.
• On Hold For Correction - The client's account review is on hold due to some corrections needed in the client's information. Please follow up with the client to correct the information or apply corrections yourself if possible.
• Approved - The client's account has been approved. No further action is needed at this time.
• Rejected - The client's account has been rejected due to non-compliance with our policies or regulations. Please review the reasons and take the necessary action.
• Canceled - The client's account review process was canceled. Please contact us for details and next steps.

Account Types

Users can have multiple accounts associated with them. Assets will be segregated by account type for accounting/tax purposes, but other details such as linked bank accounts will be shared across all accounts associated with a user.

• Trust Account
• IRA
• 401(k)
• Roth IRA
• SEP IRA
• Spousal 401(k)