Quick Start: Individual Accounts

rocket-launch

Overview

The onboarding flow onto the sFOX platform centers around two concepts: tiers and requirements. Let's define these terms for ease of communication:

  • Tier: the degree to which an account can engage on the sFOX platform as it relates to funding and trading activity. At the moment, sFOX has two tiers: Tier 1 and Tier 2. A Tier 2 account has an elevated level of engagement compared to Tier 1.

  • Requirements: the items that must be satisfied to achieve a tier, classified as either completed, current, or future .

Interacting with Tiers and Requirements

Partners interact with the sFOX platform via REST API and websocket messages to create an account and understand an account's onboarding progress.

At a high level, it is a 3-step process to onboard an individual end user account as defined below:

Step 1: Create the End User Account

Like any financial platform, a new end user will access a partner's website or mobile app and submit personally identifiable information (PII) used for know-your-customer (KYC) purposes.

Once the partner captures PII information from the end user, it should be sent via API to create the accountarrow-up-right in the sFOX platform.

Note, sFOX does have required information needed to create the end user's account which is defined in the hyperlink above.

Step 2: Observe Requirements

Based on the information provided to sFOX upon creating the end user's account, requirements will be evaluated and classified into one of three categories:

  • Current: one or more requirements that must be satisfied to obtain the very next tier. Generally, brand new accounts start at Tier 0 and work towards Tier 1.

  • Completed: one or more requirements that have already been satisfied.

  • Future: one or more requirements that are "next up" after the current requirements have been satisfied in order for the account to obtain the next tier (Tier 2), if so desired.

Requirements Needed for Tier 1 + Tier 2

Below are the requirements that must be satisfied to obtain Tier 1 and subsequently Tier 2.

circle-info

While US and non-US accounts must satisfy the same set of requirements, how each requirement is satisfied is slightly different based on the citizenship of the end user.

Tier 1 Requirements

Requirement
How to Satisfy

Email verification

Phone Number verification

Identity Information

US End User: sFOX will attempt automatic verification; if automation is not successful must provide a document uploadarrow-up-right Non-US End User: must provide a document upload

Proof of address

US End User: sFOX will attempt automatic verification; if automation is not successful must provide a document uploadarrow-up-right Non-US End User: must provide a document upload

Tier 2 Requirements

To obtain Tier 2 for a given account, Tier 1 requirements must be satisfied and the below information must be provided:

Requirement
How to Satisfy

Source of Funds

Either on the POST during initial account creationarrow-up-right or a PATCH to update the accountarrow-up-right after initial account creation

Expected Use

Either on the POST during initial account creationarrow-up-right or a PATCH to update the accountarrow-up-right after initial account creation

What is Source of Funds and Expected Use Information?

  • Source of funds: Primary source for the funds being transferred to the account

  • Employment status: End user’s employment status

  • Occupation: End user’s primary occupation

  • Intermediary Status: Is the end user receiving or sending funds on behalf of someone other than themselves?

Expected Use

  • Expected Transfer Volume: Expected monthly USD notional amount to be transferred (sent / received)

  • Expected Trade Volume: Expected monthly USD notional amount to be traded

circle-info

As a reminder, these attributes can be provided during initial account creationarrow-up-right or subsequently via update end userarrow-up-right

Step 3: Monitor for Updates

It is important that partners subscribe to the onboardingarrow-up-right websocket feed. This ensures asynchronous updates - especially for requirements that are satisfied via document upload - are observed by the partner in a timely fashion.

For context, when a document is uploaded for the purpose of satisfying a requirement, the sFOX team will review the document and either accept it or not.

The act of accepting a document will trigger the sFOX system to update the end user's requirements and emit a websocket message, thereby informing the partner of the update - and in many cases, incrementing the account's tier as well.

Example

Newly Created Account - No Requirements Satisfied

Below is the response from sFOX for a new end user account - the end user's PII could not be verified automatically.

As such, the end user (partner) must upload two documents: one to satisfy the proof_of_address requirement and another for the identity_info requirement.

Note the future requirement for identity_verification. This requirement represents an image of a identity document (passport, etc) compared to the identity_info requirement, which is simply the information contained in many identity-type documents, such as first name, last name, etc.

circle-exclamation

Requirements are Satisfied - Email and Phone Number

As the account's email and phone number are verified via OTP code, the corresponding requirements will become satisfied.

This progression is reflected in the GET End Userarrow-up-right endpoint:

Wrapping Up

This quick start guide is not intended to be fully comprehensive, but rather demonstrate the paradigm of how tiers and requirements are used in-tandem to provide transparency and "next steps" for partners and end users alike.

For further questions, please do not hesitate to contact the sFOX team to get you up and running.

Last updated