Retry

Flow Overview

Initial Verification

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

Partial Success

If verification is partially successful, show the Partial Result screen

Retry Option

User can review and update their information through the Retry flow

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");
}
});

retry.on("form:retry:loaded", () => {
 // Event triggered when Retry screen loads
 // Add custom business logic for retry handling here
});

Smart Retry Behavior

Previous Address Request

Triggered when KYC check results in a partial match and the user hasn’t modified their personal details.

Previous address form screenshot — Previous Address Form

This flow:

Detects partial KYC match
Checks if personal details remained unchanged
Prompts for previous address
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',
          }],
        },
      },
    },
  },
});

Additional ID Request

Triggered when KYC passes but ID verification fails, and the user hasn’t modified their ID details.

Additional ID form screenshot — Additional ID Form

This flow:

Detects successful KYC but failed ID verification
Checks if ID details remained unchanged
Prompts for alternative ID document
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 Screen
Partial Result
Success Handler

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

partial.on("form:result:partial", async () => {
  // Initiate retry flow
});

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

Adding logo to retry screens

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

OneSDK

Smart UI (for deprecation)

Flow Overview

Implementation

Smart Retry Behavior

Best Practices

Retry Limits

User Experience

Common Integration Points

Adding logo to retry screens

​Flow Overview

​Implementation

​Smart Retry Behavior

​Best Practices

Retry Limits

User Experience

​Common Integration Points

​Adding logo to retry screens

Flow Overview

Implementation

Smart Retry Behavior

Best Practices

Common Integration Points

Adding logo to retry screens