Skip to main content

​
Flow Overview

1

Initial Verification

User submits their information through the standard flow (Personal → Document → Review)
2

Partial Success

If verification is partially successful, show the Partial Result screen
3

Retry Option

User can review and update their information through the Retry flow
4

Additional Information

System may request extra data based on specific failure scenarios

​
Implementation

const retry = oneSdk.component("form", {
 name: "RETRY",
 type: "manual",
});

// Create failure result component with custom messaging
const result_fail = oneSdk.component("form", {
name: "RESULT",
type: "manual",
state: 'FAIL',
title: { label: 'Max attempt reached' },
descriptions: [
{ label: 'You have reached all the attempts. Our officer will review your details and get in touch.' },
{ label: 'Please close the browser' }
],
cta: { label: 'Close' }
});

// Track retry attempts
let count = 0;

// Handle partial form results
review.on("form:result:partial", async () => {
if (count < 2) {
// Allow retry if under max attempts
retry.mount("#form-container");
count += 1;
} else {
// Show final error when max attempts reached
result_fail.mount("#form-container");
}
});

​
Smart Retry Behavior

Triggered when KYC check results in a partial match and the user hasn’t modified their personal details.
Previous address form screenshot
This flow:
  1. Detects partial KYC match
  2. Checks if personal details remained unchanged
  3. Prompts for previous address
  4. Uses additional data to improve verification chances
To customize the text for previous address request, override addresssI.fullAddress field
const retry = oneSdk.component('form', {
  name: 'RETRY',
  type: 'manual',
  personal: {
    countries: {
      default: {
        default: {
          fields: [{
            title: {
              label: 'Prev Address Title',
            },
            name: 'address1.fullAddress',
            label: 'Prev address label',
            dataType: 'previous_addr',
            fieldType: 'address',
            toggleConfig: {
              label:
                'Previous address question?',
              rules: {
                required: {
                  value: true,
                  message:
                    'Previous address required error',
                },
              },
            },
            placeholder: 'Prev address placeholder',
          }],
        },
      },
    },
  },
});
Triggered when KYC passes but ID verification fails, and the user hasn’t modified their ID details.
Additional ID form screenshot
This flow:
  1. Detects successful KYC but failed ID verification
  2. Checks if ID details remained unchanged
  3. Prompts for alternative ID document
  4. Resubmits for verification
To customize the text for additional ID request, use additionInfo property
const retry = oneSdk.component('form', {
  name: 'RETRY',
  type: 'manual',
  additionInfo: {
    label: 'Additional document label',
    descriptions: [{ label: 'Additional document description' }],
  },
});

​
Best Practices

Retry Limits

Implement a maximum retry count to prevent endless attempts:
if (retryCount < 2) {
  partial.mount(appContainer);
} else {
  failed.mount(appContainer);
}

User Experience

  • Clear error messaging
  • Intuitive navigation
  • Progress indication
  • Helpful prompts for additional information
Remember to handle edge cases such as: - Network failures during verification
  • Timeout scenarios - Maximum retry limit reached - Invalid or corrupt document uploads

​
Common Integration Points

review.on("form:review:partial", async () => {
  // Handle partial success scenario
});

​
Adding logo to retry screens

const retry = oneSdk.component('form', {
  name: 'RETRY',
  type: 'manual',
  logo: {
    src: './assets/logo.png'
  },
  style: {
    'ff-logo': {
      'width': '50px'
    }
  }
});