---
title: React.js Integration
description: This section described how to integrate the Natural Person Into a React.js application. Our Natural Person is JavaScript based and therefore the steps to integrate it into a React.js application are a
---

[Skip to content](https://support.icomplyis.com/en/react.js-integration#main-content)

[![iComply Logo Wordmark White](https://support.icomplyis.com/hubfs/liComply%20ogos-smple.svg)](https://www.icomplyis.com/)

- [Home](https://support.icomplyis.com/en/icomply-mission-control)
- Coverage
- Procedures
- Technical
- Legal
- About Us

Open main navigation

Close main navigation

- [Home](https://support.icomplyis.com/en/icomply-mission-control)
- Coverage
- Procedures
- Technical
- Legal
- About Us
- [Contact Sales](https://icomplyis.com/pricing/book-demo/)

[Contact Sales](https://icomplyis.com/pricing/book-demo/)

 Hello. How can we help you?

- There are no suggestions because the search field is empty.

1. [iComply Knowledge Base](https://support.icomplyis.com/en?hsLang=en)
2. [Technical & Developer Documentation](https://support.icomplyis.com/en/technical-developer-documentation?hsLang=en)
3. [Integration](https://support.icomplyis.com/en/technical-developer-documentation?hsLang=en#integration)

October 27, 2026

# React.js Integration

This section describes how to integrate the iComply Natural Person into a React.js application.

The iComply Natural Person widget is JavaScript-based, so the steps to integrate it into a React.js application differ slightly from integrating it into a standard HTML page or dynamic website. Before starting, ensure you have React installed and have imported \`useEffect\` from React in your component.

```
const useScript = url => {    useEffect(() => {      const script = document.createElement('script');      script.src = url;      script.async = true;      script.onload = () => {        window.iComply.init(document.getElementById('iComply'), {          callback(serverResponse) {            fetch('${API}/icomplyListener', {              method: 'POST',              mode: 'cors',              headers: {                'Content-Type': 'application/json',                Accept: 'application/json',                Authorization: 'Bearer ${AT}',              },              body: JSON.stringify(serverResponse),            }).then(res =>              serverResponse.summaryResult == 'PASS'                ? window.confirm('Automated ID Verification successful.') &&                  window.location.replace('${APP_URL}/oauth/auth?response_type=code&scope=signature&client_&redirect_uri=${APP}/signup'),                : window.confirm('Automated ID Verification unsuccessful.'),            );          },          // Optional: fires as soon as a verification session ID is assigned, before the final result
          verificationIdCallback: function (verificationId) {              console.log(verificationId)          }        });      };      document.body.appendChild(script);      return () => {        document.body.removeChild(script);      };    }, [url]);  };  useScript('https://verify.icomplykyc.com/icomply-min.js');

**Placeholder variable reference:**
- `${API}` — The base URL of your backend API server.
- `${AT}` — A valid Bearer access token for authenticating requests to your API.
- `${APP_URL}` — The root URL of your application (e.g., `https://app.example.com`).
- `${APP}` — The redirect base path used after OAuth completion.
- `${APP}/signup` — The post-verification redirect URI registered with your OAuth provider.

> **Note:** Check the [iComply developer portal](https://verify.icomplykyc.com) for the latest version of the `icomply-min.js` script, as the URL above may be updated.
```

 

\*\*Note:\*\* This is a reference example of how to integrate the iComply Natural Person Portal into a React.js application. Your implementation will vary based on your application logic, authentication flow, and onboarding funnel.

- [Welcome](https://support.icomplyis.com/en/welcome?hsLang=en#main-content)

    - [Introduction](https://support.icomplyis.com/en/welcome?hsLang=en#introduction)
- [Platform Guides & Feature Documentation](https://support.icomplyis.com/en/platform-guides-feature-documentation?hsLang=en#main-content)

    - [Home Screen & Navigation](https://support.icomplyis.com/en/platform-guides-feature-documentation?hsLang=en#home-screen-navigation)
    - [Platform Overview](https://support.icomplyis.com/en/platform-guides-feature-documentation?hsLang=en#platform-overview)
    - [KYC Module](https://support.icomplyis.com/en/platform-guides-feature-documentation?hsLang=en#kyc-module)
    - [AML Module](https://support.icomplyis.com/en/platform-guides-feature-documentation?hsLang=en#aml-module)
    - [Administration](https://support.icomplyis.com/en/platform-guides-feature-documentation?hsLang=en#administration)
    - [Portals](https://support.icomplyis.com/en/platform-guides-feature-documentation?hsLang=en#portals)
    - [FAQ](https://support.icomplyis.com/en/platform-guides-feature-documentation?hsLang=en#faq)
- [Compliance & Platform Procedures](https://support.icomplyis.com/en/compliance-platform-procedures?hsLang=en#main-content)

    - [Platform Procedures](https://support.icomplyis.com/en/compliance-platform-procedures?hsLang=en#platform-procedures)
    - [Security & Privacy](https://support.icomplyis.com/en/compliance-platform-procedures?hsLang=en#security-privacy)
- [Technical & Developer Documentation](https://support.icomplyis.com/en/technical-developer-documentation?hsLang=en#main-content)

    - [Introduction](https://support.icomplyis.com/en/technical-developer-documentation?hsLang=en#introduction)
    - [Implementation](https://support.icomplyis.com/en/technical-developer-documentation?hsLang=en#implementation)
    - [Integration](https://support.icomplyis.com/en/technical-developer-documentation?hsLang=en#integration)
- [Training & Learning Resources](https://support.icomplyis.com/en/training-learning-resources?hsLang=en#main-content)

    - [Compliance Education Center](https://support.icomplyis.com/en/training-learning-resources?hsLang=en#compliance-education-center)
- [Regulatory Resources & Industry Guides](https://support.icomplyis.com/en/regulatory-resources-industry-guides?hsLang=en#main-content)

    - [Regulatory Resources](https://support.icomplyis.com/en/regulatory-resources-industry-guides?hsLang=en#regulatory-resources)
- [FAQs](https://support.icomplyis.com/en/faqs?hsLang=en#main-content)

    - [Support](https://support.icomplyis.com/en/faqs?hsLang=en#support)
    - [Product](https://support.icomplyis.com/en/faqs?hsLang=en#product)

[![iComply Logo Wordmark White](https://support.icomplyis.com/hubfs/liComply%20ogos-smple.svg "iComply Logo Wordmark White")](https://www.iComplyis.com/)

Trust In Every Transaction   
www.icomplyis.com

<https://www.linkedin.com/in/matthewbhunger/> <https://www.x.com/icomplyis> <https://www.facebook.com/icomplyis>

Copyright © 2025, All Rights Reserved, iComply Investor Services Inc