People

Introduction

A “person” represents an real world person associated with a Netspend account,

Person Account Roles

A person can play several account roles:

RoleDescriptionCreation Settings
Primary on an accountHas primary control over the account. Creation of an account itself typically involves and is dependent upon risk assessment of this primary account holder.- identity_context set to an existing account or subaccount
- relationship set to primary
First primary owner on a joint accountSame as above, except the account supports joint owners.- identity_context set to an existing account or subaccount
- relationship set to primary
Non-first primary owner on a joint accountHas essentially the same capabilities as the first owner, but has to go through a separate joint account risk assessment process.- identity_context set to an existing account or subaccount
- relationship set to primary
- primary already exists on account
Secondary on an accountA secondary account owner is similar to primary, but has limited access to the primary owner’s account. Some of the specific differences:

  • Cannot link external bank accounts

  • Only has access to external accounts the primary has given permission for

  • External accounts are shared with primary
- identity_context set to an existing account or subaccount
- relationship set to secondary
- primary already exists on account

Creating and Enabling a Person

The basic information required to create a person is their first name, last name, the account they will belong to, and their desired role in that account.

There are also additional risk analysis related data items that can be collected and used to help determine whether or not to allow a person to successfully become an active accountholder. Some of these risk analysis data items are configurable, the details for which can be worked out in a partner’s business level engagement with Netspend.

Additional data that factors into risk analysis:

  • Street address
  • Postal code
  • Date of birth
  • Government ID number (in the U.S. this is typically a social security number).
  • Information for the expected account usage activity; for example, what deposits are expected in the account per month
  • Acceptance of terms and conditions (see Agreements)
  • Agreement to allow electronic signature (see Agreements)
  • Acceptance of privacy policy agreement (see Agreements)
  • Document uploads (see Document Requests)

Person Status

The status value of the first owner on an account or subaccount is generally set to “active” on creation. This is because typically the creation of an account involves and depends on the initial owner creating the account passing risk assessment as part of the account creation process. As such, passing account risk assessment requirements is treated as one with the person passing risk assessment as well.

In the case of joint accounts, however, after the original person on an account is created, any subsequent joint account owners follow a different “status” path, as illustrated below.

In the subsequent owner scenario, the next person to sign up as an owner initially enters an “applicant” state, which can be detached or re-attached as needed until an applicant graduates to an active state by completing additional steps.

An “active” status, regardless, does not necessarily mean that the person has access to the account yet.

Any other access enablement requirements for an “active” person are communicated by way of “kyc_status” or “ofac_status” and any relevant workflow steps, which may or may not coincide with “kyc_status” or “ofac_status”.

Person Enablement

There are a few fields in the Person object that will help indicate, at least in part, where that person is in terms of being able to access their account.

  • “status”: Whether a person is active or not.
  • “kyc_status”: Whether or not the person is blocked or rejected by Netspend’s KYC (“Know Your Customer”) risk assessment. Here a person can be in a “conditional” status, where some additional workflow steps may move the person into an “approved” status required to put the person into active status.
  • “ofac_status”: Whether or not the person is rejected having been flagged for fraudulent activity by OFAC (“Office of Foreign Assets Control”).
Status TypeValueMeaningMitigation
statusactiveBaseline active state for a person. The other status types may still affect the person’s access to account features.None needed.
applicantOnly for non-first joint account owners, indicates that the person has “applied” to be a joint account owner and needs to pass KYC/OFAC risk assessments before graduating to active joint account owner. Does not have access to account features.Workflow steps returned from a call to GET /person will indicate what steps via the API may be taken to “cure” KYC.
For additional information about KYC curing options, see Agreements and Document Requests
detachedOnly for non-first joint account owners, indicates that the person has “applied” to be a joint account owner, but has been “detached” from eligibility indefinitely.Must be reattached to be eligible for joint account ownership.
kyc_statusuncheckedConfiguration is set to “low hurdle”, meaning that KYC risk checks are not required for the account type.
No blocks at the KYC level.
None needed.
approvedPerson passed KYC risk assessments.
No blocks at the KYC level.
None needed.
conditionalPerson didn’t pass KYC risk assessments, but has the opportunity to via the API, the exact options for are configurable or may be chosen by customer support. For example, the person may have to upload identity documents.Workflow steps returned from a call to GET /person will indicate what steps via the API may be taken to “cure” KYC.
For additional information about KYC curing options, see Agreements and Document Requests
rejectedPerson did not pass KYC risk assessments.Must call customer service to rectify.
ofac_statusuncheckedConfiguration is set to “low hurdle”, meaning that OFAC risk checks are not required for the account type.
No blocks at the OFAC level.
None needed.
approvedPerson passed OFAC risk assessment.
No blocks at the OFAC level.
None needed.
rejectedPerson did not pass OFAC risk assessments.Must call customer service to rectify.

Sample Flows

Onboarding a New Account and Person

The diagram below shows a possible flow onboarding a new account and person for an account type that requires the person to accept some agreements in order to cure and pass KYC.

Curing Steps for KYC Conditional After Answer Timeout

This diagram shows a potential flow where a person in a KYC conditional state fails to answer identifying questions within the default 5 minute timeout. The recourse is to call customer service.

Adding Second Joint Account Owner

The two diagrams below show a potential flow for a scenario in which Bob has created an account and wants Sara to be a joint owner of that account.
The partner application is presumed to allow Bob to identify Sara, by phone number perhaps, as a person to invite, and the partner application takes care of pushing the notification for the invite to Sara’s phone, where she accepts and creates an account.
In the process of creating the account, however, she drops off before completing a step needed to become active and so remains in an “applicant” state for a while.
Bob checks his app days later, which indicates that Sara hasn’t completed sign up yet, offering to cancel the invitation.
Bob opts to cancel, which leads to the partner app putting Sara in a “detached” state.
Bob talks to Sara about it, she apologizes and asks to try again.
Bob agrees and uses the partner app to reinstate Sara.
Sara tries again, completing steps to become active, and finally is able to get access to the account.

Person Webhooks

Payload data type: “person”

WebhookDescription
Person KYC ModifiedA person’s KYC information and status have been modified
Person ModifiedA person’s information has been modified
Person OFAC FailedA person’s OFAC check has failed
Person OFAC ModifiedA person’s OFAC information and status have been modified
Person RemovedA person has been removed from the Netspend system

For more information on webhooks, see Webhook.