Update Identity Information
Overview
Identity information can be updated at any time—while submitting a new application, or after an application has been approved via Reevaluate an Application.
This page explains the identity update workflow: how to find, initiate, confirm, or cancel requested identity changes. This workflow is the same regardless of when it's triggered.
After an identity is updated, Highnote re-runs verification against the application:
- If the updated information matches, identity verification is approved.
- If the updated information still results in a mismatch, identity documents may be requested from the account holder.
Workflow
You can update supported fields for both BusinessAccountHolder or PersonAccountHolder. The workflow is as follows:
- Step 1 Subscriber receives notification,
CARD_PRODUCT_APPLICATION_IDENTITY_UPDATE_REQUESTED. - Step 2 Subscriber queries Business or Person updatable fields.
- Step 3 Subscriber initiates Business or Person identity updates.
- Step 4 Subscriber enables customer to
CONFIRMorCANCELinitiated updates.- If customer confirms: Confirm the Initiated Update.
- If customer cancels, does not follow through, or no changes are needed: Cancel the Initiated Update.
- Step 5 Find newly updated fields on the application.
Once confirmed or canceled, additional changes are no longer allowed.
Updatable fields
The following fields can be updated when an identity update is requested.
Person account holder
Applies to PersonAccountHolder.
The following Person Account Holder fields can be updated:
| Field | Triggered On |
|---|---|
name | NAME_MISMATCH |
identificationDocument.socialSecurityNumber | SSN_MISMATCH |
homeAddress | ADDRESS_MISMATCH or ADDRESS_WARNING |
dateOfBirth | DOB_MISMATCH |
Business profile
Applies to BusinessAccountHolder.
The following Business Profile fields can be updated for Business Account Holders only:
| Field | Triggered On |
|---|---|
Name | BUSINESS_NAME_MISMATCH |
identificationDocument.employerIdentificationNumber | FEIN_MISMATCH |
Address | ADDRESS_MISMATCH or ADDRESS_WARNING |
You cannot update a Business Profile if any of the following tags are present on the application: OFAC_MATCH or DENIED_FRAUD.
If either of those tags exist, Highnote performs additional validation and verification to determine the final KYB status of the Business Profile.
Business primary authorized person
Applies to both BusinessAccountHolder and PersonAccountHolder.
The following Primary Authorized Person fields can be updated for both Business Account Holders and Person Account Holders:
| Field | Triggered On |
|---|---|
name | NAME_MISMATCH |
identificationDocument.socialSecurityNumber | SSN_MISMATCH |
homeAddress | ADDRESS_MISMATCH or ADDRESS_WARNING |
dateOfBirth | DOB_MISMATCH |
You cannot update a Primary Authorized Person if any of the following tags are present on the application: HIGH_ABUSE_SCORE, HIGH_THEFT_SCORE, DENIED_FRAUD, or WATCHLIST_HIT.
If any of these tags exist, Highnote performs additional validation and verification to determine the final KYC status of the Primary Authorized Person.
Business ultimate beneficial owner
Applies to both BusinessAccountHolder and PersonAccountHolder.
The following Ultimate Beneficial Owner fields can be updated for both Business Account Holders and Person Account Holders:
| Field | Triggered On |
|---|---|
name | NAME_MISMATCH |
identificationDocument.socialSecurityNumber | SSN_MISMATCH |
homeAddress | ADDRESS_MISMATCH or ADDRESS_WARNING |
dateOfBirth | DOB_MISMATCH |
You cannot update an Ultimate Beneficial Owner (UBO) if any of the following tags are present on the application: HIGH_ABUSE_SCORE, HIGH_THEFT_SCORE, DENIED_FRAUD, or WATCHLIST_HIT.
If any of these tags exist, Highnote performs additional validation and verification to determine the final KYC status of the Ultimate Beneficial Owner.
Step 1: Receive notification of requested updates
The process begins when you receive the NotificationEventName, CARD_PRODUCT_APPLICATION_IDENTITY_UPDATE_REQUESTED from Highnote.
See Application status in the Events Reference.
Step 2: Find requested identity updates
Use the queries below to find requested identity updates on an application, indicated by currentVerification.reason = IDENTITY_UPDATE_REQUESTED.
The changesRequested field within the requestedUpdates array defines which fields can be updated to resolve identity verification.
Find person identity update requests
Use the following query to find requested identity updates for Person Account Holders:
FindPersonRequestedIdentityUpdates
Query
query FindPersonRequestedIdentityUpdates($id: ID!) {
node(id: $id) {
... on AccountHolderCardProductApplication {
id
applicationState {
status
}
cardProduct {
id
}
accountHolderSnapshot {
... on USPersonAccountHolderSnapshot {
accountHolderCurrent {
id
}
name {
givenName
familyName
middleName
}
email
dateOfBirth
currentVerification {
status
reason
results {
code
}
requestedUpdates {
... on RequestedIdentityUpdate {
id
status
referredBy {
__typename
... on AccountHolderCardProductApplication {
id
}
... on AuthorizedUserCardProductApplication {
id
}
}
requestedFor {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
changesRequested
createdAt
updatedAt
appliedUpdates {
... on RequestedIdentityAppliedUpdate {
appliedChanges
requestedChange {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
createdAt
updatedAt
}
}
}
}
}
}
}
updatedAt
createdAt
}
}
}
Variables
{ "id": "APPLICATION_ID" }
⚠️ Please login to execute queries. Visit the dashboard to authenticate.
Result
{
"data": {
"node": {
"id": "ap_YOUR_PERSON_APPLICATION_ID",
"applicationState": {
"status": "PENDING"
},
"cardProduct": {
"id": "pd_YOUR_CARD_PRODUCT_ID"
},
"accountHolderSnapshot": {
"accountHolderCurrent": {
"id": "ps_ah_YOUR_PERSON_ACCOUNT_HOLDER_ID"
},
"name": {
"givenName": "Jane",
"familyName": "Doe",
"middleName": null
},
"email": "jane.doe@example.com",
"dateOfBirth": "1990-01-15",
"currentVerification": {
"status": "PENDING",
"reason": "IDENTITY_UPDATE_REQUESTED",
"results": [],
"requestedUpdates": [
{
"id": "idtus_YOUR_REQUESTED_IDENTITY_UPDATE_ID",
"status": "OPEN",
"referredBy": {
"__typename": "AccountHolderCardProductApplication",
"id": "ap_YOUR_PERSON_APPLICATION_ID"
},
"requestedFor": {
"__typename": "USPersonAccountHolder",
"id": "ps_ah_YOUR_PERSON_ACCOUNT_HOLDER_ID"
},
"changesRequested": [
"FULL_LEGAL_NAME",
"SOCIAL_SECURITY_NUMBER"
],
"createdAt": "2024-07-23T21:18:25.271Z",
"updatedAt": "2024-07-23T21:18:25.271Z",
"appliedUpdates": []
}
]
}
},
"updatedAt": "2024-07-23T21:18:25.271Z",
"createdAt": "2024-07-23T21:18:25.271Z"
}
}
}
Find business identity update requests
Use the following query to find requested identity updates for Business Account Holders:
FindBusinessRequestedIdentityUpdates
Query
query FindAccountHolderCardProductApplicationRequestedUpdates($id: ID!) {
node(id: $id) {
... on AccountHolderCardProductApplication {
id
applicationState {
status
}
cardProduct {
id
}
accountHolderSnapshot {
... on USBusinessAccountHolderSnapshot {
accountHolderCurrent {
id
}
primaryAuthorizedPerson {
currentVerification {
status
reason
results {
code
}
requestedUpdates {
... on RequestedIdentityUpdate {
id
status
referredBy {
__typename
... on AccountHolderCardProductApplication {
id
}
... on AuthorizedUserCardProductApplication {
id
}
}
requestedFor {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
changesRequested
createdAt
updatedAt
appliedUpdates {
... on RequestedIdentityAppliedUpdate {
appliedChanges
requestedChange {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
createdAt
updatedAt
}
}
}
}
}
}
businessProfile {
name {
legalBusinessName
doingBusinessAsName
}
updatedAt
createdAt
currentVerification {
status
reason
results {
code
}
requestedUpdates {
... on RequestedIdentityUpdate {
id
status
referredBy {
__typename
... on AccountHolderCardProductApplication {
id
}
... on AuthorizedUserCardProductApplication {
id
}
}
requestedFor {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
changesRequested
createdAt
appliedUpdates {
... on RequestedIdentityAppliedUpdate {
appliedChanges
requestedChange {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
createdAt
updatedAt
}
}
}
}
}
ultimateBeneficialOwners {
... on USBusinessUltimateBeneficialOwnerSnapshot {
currentVerification {
status
reason
results {
code
}
requestedUpdates {
... on RequestedIdentityUpdate {
id
status
referredBy {
__typename
... on AccountHolderCardProductApplication {
id
}
... on AuthorizedUserCardProductApplication {
id
}
}
requestedFor {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
changesRequested
createdAt
updatedAt
appliedUpdates {
... on RequestedIdentityAppliedUpdate {
appliedChanges
requestedChange {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
createdAt
updatedAt
}
}
}
}
}
}
}
}
}
}
updatedAt
createdAt
}
}
}
Variables
{ "id": "APPLICATION_ID" }
⚠️ Please login to execute queries. Visit the dashboard to authenticate.
Result
{
"data": {
"node": {
"id": "ap_22bcgm006e6dc5fc8c496eb6888382df1e0e23",
"applicationState": {
"status": "PENDING"
},
"cardProduct": {
"id": "pd_4944696551b84454867a5532e940e7bc"
},
"accountHolderSnapshot": {
"accountHolderCurrent": {
"id": "og_ah026c9899a4f0b44ce2be6000d4369e2336"
},
"primaryAuthorizedPerson": {
"currentVerification": {
"status": "PENDING",
"reason": "IDENTITY_UPDATE_REQUESTED",
"results": [],
"requestedUpdates": [
{
"id": "idtus_2211231659d908491aaaef40e80685eab4",
"status": "OPEN",
"referredBy": {
"__typename": "AccountHolderCardProductApplication",
"id": "ap_22bcgm006e6dc5fc8c496eb6888382df1e0e23"
},
"requestedFor": {
"__typename": "USBusinessAuthorizedPerson",
"id": "ps_ap01f8580bce65174bf3bf7ff0532cfb3923"
},
"createdAt": "2024-07-23T21:18:25.271Z",
"updatedAt": "2024-07-23T21:18:25.271Z",
"changesRequested": [
"SOCIAL_SECURITY_NUMBER",
"FULL_LEGAL_NAME"
],
"appliedUpdates": []
}
]
},
"updatedAt": "2024-07-23T21:18:25.271Z",
"createdAt": "2024-07-23T21:18:25.271Z"
},
"businessProfile": {
"name": {
"legalBusinessName": "IN-REVIEW",
"doingBusinessAsName": "ManualReview Inc"
},
"updatedAt": "2024-07-23T21:18:25.271Z",
"createdAt": "2024-07-23T21:18:25.271Z",
"currentVerification": {
"status": "PENDING",
"reason": "IDENTITY_UPDATE_REQUESTED",
"results": [],
"requestedUpdates": [
{
"id": "idtus_2207480659d908491aaaef40e80685e9e3",
"status": "OPEN",
"referredBy": {
"__typename": "AccountHolderCardProductApplication",
"id": "ap_22bcgm006e6dc5fc8c496eb6888382df1e0e23"
},
"requestedFor": {
"__typename": "USBusinessProfile",
"id": "og_ah026c9899a4f0b44ce2be6000d4369e2336"
},
"createdAt": "2024-07-23T21:18:25.271Z",
"changesRequested": [
"EMPLOYER_IDENTIFICATION_NUMBER",
"LEGAL_BUSINESS_NAME"
],
"appliedUpdates": []
}
]
},
"ultimateBeneficialOwners": [
{
"currentVerification": {
"status": "PENDING",
"reason": "IDENTITY_UPDATE_REQUESTED",
"results": [],
"requestedUpdates": [
{
"id": "idtus_22abc231659d908491aaaef40e80685eab4",
"status": "OPEN",
"referredBy": {
"__typename": "AccountHolderCardProductApplication",
"id": "ap_22bcgm006e6dc5fc8c496eb6888382df1e0e23"
},
"requestedFor": {
"__typename": "USBusinessUltimateBeneficialOwner",
"id": "ps_ap01d9580bce65174bf3bf7ff0532cfb3012"
},
"createdAt": "2024-07-23T21:18:25.271Z",
"updatedAt": "2024-07-23T21:18:25.271Z",
"changesRequested": [
"SOCIAL_SECURITY_NUMBER"
],
"appliedUpdates": []
}
]
}
}
]
}
},
"updatedAt": "2024-07-23T21:18:25.271Z",
"createdAt": "2024-07-23T21:18:25.271Z"
}
}
}
Step 3: Initiate identity updates
Use the mutations below to initiate identity updates for US Person and US Business entities.
Initiate person account holder identity update
Use the following mutation to initiate an identity update for a Person Account Holder:
InitiateUSPersonAccountHolderRequestedIdentityUpdate
Query
mutation InitiateUSPersonAccountHolderRequestedIdentityUpdate(
$input: InitiateUSPersonAccountHolderRequestedIdentityUpdateInput!
) {
initiateUSPersonAccountHolderRequestedIdentityUpdate(input: $input) {
... on RequestedIdentityUpdate {
id
status
referredBy {
__typename
... on AccountHolderCardProductApplication {
id
}
... on AuthorizedUserCardProductApplication {
id
}
}
requestedFor {
__typename
... on USPersonAccountHolder {
id
}
}
changesRequested
createdAt
updatedAt
appliedUpdates {
... on RequestedIdentityAppliedUpdate {
appliedChanges
requestedChange {
__typename
... on USPersonAccountHolder {
id
}
}
createdAt
updatedAt
}
}
}
}
}
Variables
{ "input": { "requestedIdentityUpdateId": "REQUESTED_IDENTITY_UPDATE_ID", "personAccountHolder": { "name": { "givenName": "Jane", "familyName": "Doe" }, "identificationDocument": { "socialSecurityNumber": { "number": "123-45-6789", "countryCodeAlpha3": "USA" } } } } }
⚠️ Please login to execute queries. Visit the dashboard to authenticate.
Result
{
"data": {
"initiateUSPersonAccountHolderRequestedIdentityUpdate": {
"id": "idtus_YOUR_REQUESTED_IDENTITY_UPDATE_ID",
"status": "INITIATED",
"referredBy": {
"__typename": "AccountHolderCardProductApplication",
"id": "ap_YOUR_PERSON_APPLICATION_ID"
},
"requestedFor": {
"__typename": "USPersonAccountHolder",
"id": "ps_ah_YOUR_PERSON_ACCOUNT_HOLDER_ID"
},
"createdAt": "2024-07-23T21:18:25.271Z",
"updatedAt": "2024-07-23T23:18:25.271Z",
"changesRequested": [
"FULL_LEGAL_NAME",
"SOCIAL_SECURITY_NUMBER"
],
"appliedUpdates": [
{
"appliedChanges": [],
"requestedChange": {
"__typename": "USPersonAccountHolder",
"id": "ps_ah_YOUR_PERSON_ACCOUNT_HOLDER_ID"
},
"createdAt": "2024-07-23T23:18:25.271Z",
"updatedAt": "2024-07-23T23:18:25.271Z"
}
]
}
}
}
Initiate business profile identity update
Use the following mutation with requestedIdentityUpdateId to initiate an identity update for a Business Account Holder.
InitiateUSBusinessProfileRequestedIdentityUpdate
Query
mutation InitiateUSBusinessProfileRequestedIdentityUpdate(
$input: InitiateUSBusinessProfileRequestedIdentityUpdateInput!
) {
initiateUSBusinessProfileRequestedIdentityUpdate(input: $input) {
... on RequestedIdentityUpdate {
id
status
referredBy {
__typename
... on AccountHolderCardProductApplication {
id
}
... on AuthorizedUserCardProductApplication {
id
}
}
requestedFor {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
changesRequested
createdAt
updatedAt
appliedUpdates {
... on RequestedIdentityAppliedUpdate {
appliedChanges
requestedChange {
__typename
... on USBusinessProfile {
id
identificationDocument {
employerIdentificationNumber {
countryCodeAlpha3
}
}
name {
legalBusinessName
}
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
createdAt
updatedAt
}
}
}
}
}
Variables
{ "input": { "requestedIdentityUpdateId": "REQUESTED_IDENTITY_UPDATE_ID", "businessProfile": { "identificationDocument": { "employerIdentificationNumber": { "number": "34-1213141", "countryCodeAlpha3": "USA" } }, "name": { "legalBusinessName": "My Company" } } } }
⚠️ Please login to execute queries. Visit the dashboard to authenticate.
Result
{
"data": {
"initiateUSBusinessProfileRequestedIdentityUpdate": {
"id": "idtus_2207480659d908491aaaef40e80685e9e3",
"status": "INITIATED",
"referredBy": {
"__typename": "AccountHolderCardProductApplication",
"id": "ap_22bcgm006e6dc5fc8c496eb6888382df1e0e23"
},
"requestedFor": {
"__typename": "USBusinessProfile",
"id": "og_ah026c9899a4f0b44ce2be6000d4369e2336"
},
"createdAt": "2024-07-23T21:18:25.271Z",
"updatedAt": "2024-07-23T21:18:25.271Z",
"changesRequested": [
"EMPLOYER_IDENTIFICATION_NUMBER",
"LEGAL_BUSINESS_NAME"
],
"appliedUpdates": [
{
"appliedChanges": [],
"requestedChange": {
"__typename": "USBusinessProfile",
"id": "og_ah026c9899a4f0b44ce2be6000d4369e2336",
"identificationDocument": {
"employerIdentificationNumber": {
"countryCodeAlpha3": "USA"
}
},
"name": {
"legalBusinessName": "My Company"
}
}
}
]
}
}
}
Initiate business authorized person identity update
Use the following mutation to initiate an identity update for a Business Account Holder Primary Authorized Person:
InitiateUSBusinessAuthorizedPersonRequestedIdentityUpdate
Query
mutation InitiateUSBusinessAuthorizedPersonRequestedIdentityUpdate(
$input: InitiateUSBusinessAuthorizedPersonRequestedIdentityUpdateInput!
) {
initiateUSBusinessAuthorizedPersonRequestedIdentityUpdate(input: $input) {
... on RequestedIdentityUpdate {
id
status
referredBy {
__typename
... on AccountHolderCardProductApplication {
id
}
... on AuthorizedUserCardProductApplication {
id
}
}
requestedFor {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
changesRequested
createdAt
updatedAt
appliedUpdates {
... on RequestedIdentityAppliedUpdate {
appliedChanges
requestedChange {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
createdAt
updatedAt
}
}
}
}
}
Variables
{ "input": { "requestedIdentityUpdateId": "REQUESTED_IDENTITY_UPDATE_ID", "primaryAuthorizedPerson": { "name": { "givenName": "Joe" }, "identificationDocument": { "socialSecurityNumber": { "number": "543-39-8765", "countryCodeAlpha3": "USA" } } } } }
⚠️ Please login to execute queries. Visit the dashboard to authenticate.
Result
{
"data": {
"initiateUSBusinessAuthorizedPersonRequestedIdentityUpdate": {
"id": "idtus_2217580659d908491aaaef40e80686c2a4",
"status": "INITIATED",
"referredBy": {
"__typename": "AccountHolderCardProductApplication",
"id": "ap_22bcgm006e6dc5fc8c496eb6888382df1e0e23"
},
"requestedFor": {
"__typename": "USBusinessAuthorizedPerson",
"id": "ps_ap01f8580bce65174bf3bf7ff0532cfb3923"
},
"createdAt": "2024-07-23T21:18:25.271Z",
"updatedAt": "2024-07-23T23:18:25.271Z",
"changesRequested": [
"GIVEN_NAME",
"SOCIAL_SECURITY_NUMBER"
],
"appliedUpdates": [
{
"appliedChanges": [],
"requestedChange": {
"__typename": "USBusinessAuthorizedPerson",
"id": "ps_ap01f8580bce65174bf3bf7ff0532cfb3923"
}
}
]
}
}
}
Initiate business ultimate beneficial owner identity update
Use the following mutation to initiate an identity update for a Business Account Holder Ultimate Beneficial Owner:
InitiateUSBusinessUltimateBeneficialOwnerRequestedIdentityUpdate
Query
mutation initiateUSBusinessUltimateBeneficialOwnerRequestedIdentityUpdate(
$input: InitiateUSBusinessUltimateBeneficialOwnerRequestedIdentityUpdateInput!
) {
initiateUSBusinessUltimateBeneficialOwnerRequestedIdentityUpdate(
input: $input
) {
... on RequestedIdentityUpdate {
id
status
referredBy {
__typename
... on AccountHolderCardProductApplication {
id
}
... on AuthorizedUserCardProductApplication {
id
}
}
requestedFor {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
changesRequested
createdAt
updatedAt
appliedUpdates {
... on RequestedIdentityAppliedUpdate {
appliedChanges
requestedChange {
__typename
... on USBusinessProfile {
id
identificationDocument {
employerIdentificationNumber {
countryCodeAlpha3
}
}
name {
legalBusinessName
}
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
createdAt
updatedAt
}
}
}
}
}
Variables
{ "input": { "requestedIdentityUpdateId": "REQUESTED_IDENTITY_UPDATE_ID", "ultimateBeneficialOwner": { "name": { "givenName": "John" }, "identificationDocument": { "socialSecurityNumber": { "number": "543-39-8765", "countryCodeAlpha3": "USA" } } } } }
⚠️ Please login to execute queries. Visit the dashboard to authenticate.
Result
{
"data": {
"initiateUSBusinessUltimateBeneficialOwnerRequestedIdentityUpdate": {
"id": "idtus_2217580659d908491aaaef40e80686c2a4",
"status": "INITIATED",
"referredBy": {
"__typename": "AccountHolderCardProductApplication",
"id": "ap_22bcgm006e6dc5fc8c496eb6888382df1e0e23"
},
"requestedFor": {
"__typename": "USBusinessUltimateBeneficialOwner",
"id": "ps_ap01f8580bce65174bf3cf7dd2532cfb3923"
},
"createdAt": "2024-07-23T21:18:25.271Z",
"updatedAt": "2024-07-23T23:18:25.271Z",
"changesRequested": [
"GIVEN_NAME",
"SOCIAL_SECURITY_NUMBER"
],
"appliedUpdates": [
{
"appliedChanges": [],
"requestedChange": {
"__typename": "USBusinessUltimateBeneficialOwner",
"id": "ps_ap01f8580bce65174bf3cf7dd2532cfb3923",
"identificationDocument": {
"employerIdentificationNumber": {
"countryCodeAlpha3": "USA"
}
},
"name": {
"legalBusinessName": null
}
}
}
]
}
}
}
Step 4: Confirm or cancel initiated update
Once confirmed or canceled, additional changes are no longer allowed.
Confirm the initiated update
Use the following mutation with the requestedIdentityUpdateId to confirm and submit the initiated updates.
Once confirmed, KYC and/or KYB automatically re-runs with the updated identity information. If identity verification can still not be resolved with the updated information, documentation may be requested for the identity.
ConfirmRequestedIdentityUpdate
Query
mutation ConfirmRequestedIdentityUpdate(
$input: ConfirmRequestedIdentityUpdateInput!
) {
confirmRequestedIdentityUpdate(input: $input) {
... on RequestedIdentityUpdate {
id
status
referredBy {
__typename
... on AccountHolderCardProductApplication {
id
}
... on AuthorizedUserCardProductApplication {
id
}
}
requestedFor {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
changesRequested
createdAt
updatedAt
appliedUpdates {
... on RequestedIdentityAppliedUpdate {
appliedChanges
requestedChange {
__typename
... on USBusinessProfile {
id
identificationDocument {
employerIdentificationNumber {
countryCodeAlpha3
}
}
name {
legalBusinessName
}
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
createdAt
updatedAt
}
}
}
}
}
Variables
{ "input": { "id": "REQUESTED_IDENTITY_UPDATE_ID", "confirmedAt": "2024-07-23T21:18:25.271Z" } }
⚠️ Please login to execute queries. Visit the dashboard to authenticate.
Result
{
"data": {
"confirmRequestedIdentityUpdate": {
"id": "idtus_2207480659d908491aaaef40e80685e9e3",
"status": "CONFIRMED",
"referredBy": {
"__typename": "AccountHolderCardProductApplication",
"id": "ap_22bcgm006e6dc5fc8c496eb6888382df1e0e23"
},
"requestedFor": {
"__typename": "USBusinessProfile",
"id": "og_ah026c9899a4f0b44ce2be6000d4369e2336"
},
"createdAt": "2024-07-23T21:18:25.271Z",
"updatedAt": "2024-07-24T21:18:25.271Z",
"changesRequested": [
"EMPLOYER_IDENTIFICATION_NUMBER",
"LEGAL_BUSINESS_NAME"
],
"appliedUpdates": [
{
"appliedChanges": [
"EMPLOYER_IDENTIFICATION_NUMBER",
"LEGAL_BUSINESS_NAME"
],
"requestedChange": {
"__typename": "USBusinessProfile",
"id": "og_ah026c9899a4f0b44ce2be6000d4369e2336",
"identificationDocument": {
"employerIdentificationNumber": {
"countryCodeAlpha3": "USA"
}
},
"name": {
"legalBusinessName": "My Company"
}
}
}
]
}
}
}
Cancel the initiated update
cannot cancel after confirm
You cannot cancel an update that has been confirmed.
Use the following mutation to cancel an identity update if the customer cancels, does not follow through, or if no changes are needed. Updates that are cancelled may require further documentation verify the identity.
CancelRequestedIdentityUpdate
Query
mutation CancelRequestedIdentityUpdate(
$input: CancelRequestedIdentityUpdateInput!
) {
cancelRequestedIdentityUpdate(input: $input) {
... on RequestedIdentityUpdate {
id
status
referredBy {
__typename
... on AccountHolderCardProductApplication {
id
}
... on AuthorizedUserCardProductApplication {
id
}
}
requestedFor {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
changesRequested
createdAt
updatedAt
appliedUpdates {
... on RequestedIdentityAppliedUpdate {
appliedChanges
requestedChange {
__typename
... on USBusinessProfile {
id
identificationDocument {
employerIdentificationNumber {
countryCodeAlpha3
}
}
name {
legalBusinessName
}
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
createdAt
updatedAt
}
}
}
}
}
Variables
{ "input": { "id": "REQUESTED_IDENTITY_UPDATE_ID", "confirmedAt": "2024-07-23T21:18:25.271Z" } }
⚠️ Please login to execute queries. Visit the dashboard to authenticate.
Result
{
"data": {
"cancelRequestedIdentityUpdate": {
"id": "idtus_2207480659d908491aaaef40e80685e9e3",
"status": "CANCELLED",
"referredBy": {
"__typename": "AccountHolderCardProductApplication",
"id": "ap_22bcgm006e6dc5fc8c496eb6888382df1e0e23"
},
"requestedFor": {
"__typename": "USBusinessProfile",
"id": "og_ah026c9899a4f0b44ce2be6000d4369e2336"
},
"createdAt": "2024-07-23T21:18:25.271Z",
"updatedAt": "2024-07-24T21:18:25.271Z",
"changesRequested": [
"EMPLOYER_IDENTIFICATION_NUMBER",
"LEGAL_BUSINESS_NAME"
],
"appliedUpdates": []
}
}
}
Step 5: Find updated fields on application
Use the following query to lookup and review the appliedUpdates on the Account Holder's application.
FindApplicationIdentityUpdates
Query
query FindApplicationIdentityUpdates($id: ID!) {
node(id: $id) {
... on AccountHolderCardProductApplication {
id
applicationState {
status
}
cardProduct {
id
}
accountHolderSnapshot {
... on USBusinessAccountHolderSnapshot {
accountHolderCurrent {
id
}
primaryAuthorizedPerson {
currentVerification {
status
reason
results {
code
}
requestedUpdates {
... on RequestedIdentityUpdate {
id
status
referredBy {
__typename
... on AccountHolderCardProductApplication {
id
}
... on AuthorizedUserCardProductApplication {
id
}
}
requestedFor {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
changesRequested
createdAt
updatedAt
appliedUpdates {
... on RequestedIdentityAppliedUpdate {
appliedChanges
requestedChange {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
createdAt
updatedAt
}
}
}
}
}
}
businessProfile {
name {
legalBusinessName
doingBusinessAsName
}
updatedAt
createdAt
currentVerification {
status
reason
results {
code
}
requestedUpdates {
... on RequestedIdentityUpdate {
id
status
referredBy {
__typename
... on AccountHolderCardProductApplication {
id
}
... on AuthorizedUserCardProductApplication {
id
}
}
requestedFor {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
changesRequested
createdAt
appliedUpdates {
... on RequestedIdentityAppliedUpdate {
appliedChanges
requestedChange {
__typename
... on USBusinessProfile {
id
}
... on USBusinessAuthorizedPerson {
id
}
... on USBusinessUltimateBeneficialOwner {
id
}
... on USPersonAccountHolder {
id
}
... on USPersonAuthorizedUser {
id
}
}
createdAt
updatedAt
}
}
}
}
}
}
}
}
updatedAt
createdAt
}
}
}
Variables
{ "id": "APPLICATION_ID" }
⚠️ Please login to execute queries. Visit the dashboard to authenticate.
Result
{
"data": {
"node": {
"id": "ap_22bcgm006e6dc5fc8c496eb6888382df1e0e23",
"applicationState": {
"status": "PENDING"
},
"cardProduct": {
"id": "pd_4944696551b84454867a5532e940e7bc"
},
"accountHolderSnapshot": {
"accountHolderCurrent": {
"id": "og_ah026c9899a4f0b44ce2be6000d4369e2336"
},
"primaryAuthorizedPerson": {
"currentVerification": {
"status": "PENDING",
"reason": "IDENTITY_UPDATE_REQUESTED",
"results": [],
"requestedUpdates": [
{
"id": "idtus_2211231659d908491aaaef40e80685eab4",
"status": "OPEN",
"referredBy": {
"__typename": "AccountHolderCardProductApplication",
"id": "ap_22bcgm006e6dc5fc8c496eb6888382df1e0e23"
},
"requestedFor": {
"__typename": "USBusinessAuthorizedPerson",
"id": "ps_ap01f8580bce65174bf3bf7ff0532cfb3923"
},
"changesRequested": [
"SOCIAL_SECURITY_NUMBER",
"GIVEN_NAME"
],
"createdAt": "2024-07-23T21:18:25.271Z",
"updatedAt": "2024-07-23T21:18:25.271Z",
"appliedUpdates": []
}
],
"updatedAt": "2024-07-23T21:18:25.271Z",
"createdAt": "2024-07-23T21:18:25.271Z"
}
},
"businessProfile": {
"name": {
"legalBusinessName": "My Company",
"doingBusinessAsName": "ManualReview Inc"
},
"updatedAt": "2024-07-23T21:18:25.273Z",
"createdAt": "2024-07-23T21:18:25.271Z",
"currentVerification": {
"status": "PENDING",
"reason": "PENDING",
"results": [],
"requestedUpdates": [
{
"id": "idtus_2207480659d908491aaaef40e80685e9e3",
"status": "CONFIRMED",
"referredBy": {
"__typename": "AccountHolderCardProductApplication",
"id": "ap_22bcgm006e6dc5fc8c496eb6888382df1e0e23"
},
"requestedFor": {
"__typename": "USBusinessProfile",
"id": "og_ah026c9899a4f0b44ce2be6000d4369e2336"
},
"createdAt": "2024-07-23T21:18:25.271Z",
"changesRequested": [
"EMPLOYER_IDENTIFICATION_NUMBER",
"LEGAL_BUSINESS_NAME"
],
"appliedUpdates": [
{
"appliedChanges": [
"EMPLOYER_IDENTIFICATION_NUMBER",
"LEGAL_BUSINESS_NAME"
],
"requestedChange": {
"__typename": "USBusinessProfile",
"id": "og_ah026c9899a4f0b44ce2be6000d4369e2336",
"identificationDocument": {
"employerIdentificationNumber": {
"countryCodeAlpha3": "USA"
}
},
"name": {
"legalBusinessName": "My Company"
}
}
}
]
}
]
}
}
},
"updatedAt": "2024-07-23T21:18:25.273Z",
"createdAt": "2024-07-23T21:18:25.271Z"
}
}
}